Rework cta validations

Author: nirinchev

config/build.conf.js

@@ -75,6 +75,10 @@ const MANPAGE_NAME = 'mongosh.1.gz'
  */
 const PACKAGE_VARIANT = process.env.PACKAGE_VARIANT;
 
+const CTA_CONFIG = require(path.join(ROOT, 'config', 'cta-config.json'));
+
+const CTA_CONFIG_SCHEMA = require(path.join(ROOT, 'config', 'cta-config.schema.json'));
+
 /**
  * Export the configuration for the build.
  */
@@ -194,4 +198,6 @@ module.exports = {
     downloadPath: path.resolve(TMP_DIR, 'manpage'),
     fileName: MANPAGE_NAME,
   },
+  ctaConfig: CTA_CONFIG,
+  ctaConfigSchema: CTA_CONFIG_SCHEMA,
 };

config/cta-config.json

@@ -0,0 +1,3 @@
+{
+    "$schema": "./cta-config.schema.json"
+}

config/cta-config.schema.json

@@ -0,0 +1,94 @@
+{
+    "$id": "https://mongodb.com/schemas/mongosh/cta-config",
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "CTAConfig",
+    "type": "object",
+    "properties": {
+        "*": {
+            "$ref": "#/definitions/GreetingCTADetails",
+            "description": "The default CTA for all versions that don't have an explicit one defined."
+        },
+        "$schema": {
+            "type": "string"
+        }
+    },
+    "patternProperties": {
+        "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$": {
+            "$ref": "#/definitions/GreetingCTADetails",
+            "description": "The CTA for a specific version.",
+            "$comment": "The property name must be a valid semver string."
+        }
+    },
+    "additionalProperties": false,
+    "definitions": {
+        "GreetingCTADetails": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "chunks": {
+                    "description": "The chunks that make up the CTA. They will be combined sequentially with no additional spacing added.",
+                    "items": {
+                        "properties": {
+                            "style": {
+                                "description": "The style to apply to the text. It must match the values from clr.ts/StyleDefinition.",
+                                "enum": [
+                                    "reset",
+                                    "bold",
+                                    "italic",
+                                    "underline",
+                                    "fontDefault",
+                                    "font2",
+                                    "font3",
+                                    "font4",
+                                    "font5",
+                                    "font6",
+                                    "imageNegative",
+                                    "imagePositive",
+                                    "black",
+                                    "red",
+                                    "green",
+                                    "yellow",
+                                    "blue",
+                                    "magenta",
+                                    "cyan",
+                                    "white",
+                                    "grey",
+                                    "gray",
+                                    "bg-black",
+                                    "bg-red",
+                                    "bg-green",
+                                    "bg-yellow",
+                                    "bg-blue",
+                                    "bg-magenta",
+                                    "bg-cyan",
+                                    "bg-white",
+                                    "bg-grey",
+                                    "bg-gray",
+                                    "mongosh:warning",
+                                    "mongosh:error",
+                                    "mongosh:section-header",
+                                    "mongosh:uri",
+                                    "mongosh:filename",
+                                    "mongosh:additional-error-info"
+                                ],
+                                "type": "string"
+                            },
+                            "text": {
+                                "type": "string",
+                                "description": "The text in the chunk."
+                            }
+                        },
+                        "type": "object",
+                        "required": [
+                            "text"
+                        ]
+                    },
+                    "type": "array"
+                }
+            },
+            "required": [
+                "chunks"
+            ]
+        }
+    }
+}

config/cta.conf.js

@@ -70,6 +70,7 @@
     "@mongodb-js/monorepo-tools": "^1.1.16",
     "@mongodb-js/signing-utils": "^0.3.7",
     "@octokit/rest": "^17.9.0",
+    "ajv": "^8.17.1",
     "aws-sdk": "^2.674.0",
     "boxednode": "^2.4.3",
     "command-exists": "^1.2.9",

package-lock.json

@@ -1,3 +1,4 @@
+import { Schema } from 'ajv';
 import type { PackageInformationProvider } from '../packaging/package';
 import type { PackageVariant } from './build-variant';
 
@@ -7,6 +8,18 @@ interface ManPageConfig {
   fileName: string;
 }
 
+// TODO: this is duplicated in update-notification-manager.ts
+export interface GreetingCTADetails {
+  chunks: {
+    text: string;
+    style?: string; // TODO: this is actually clr.ts/StyleDefinition
+  }[];
+}
+
+export type CTAConfig = {
+  [version: string | '*']: GreetingCTADetails;
+};
+
 /**
  * Defines the configuration interface for the build system.
  */
@@ -47,4 +60,6 @@ export interface Config {
   manpage?: ManPageConfig;
   isDryRun?: boolean;
   useAuxiliaryPackagesOnly?: boolean;
+  ctaConfig: CTAConfig;
+  ctaConfigSchema: Schema;
 }