refactor: data validation using schema

lib/data/monorepo.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "../../tools/schemas/monorepo-schema.json",
   "repoGroups": {
     "accounts": "https://github.com/accounts-js/accounts",
     "acot": "https://github.com/acot-a11y/acot",

test/validate-schemas.spec.ts

@@ -0,0 +1,51 @@
+import fs from 'fs-extra';
+import upath from 'upath';
+import { Json } from '../lib/util/schema-utils';
+import { capitalize } from '../tools/docs/utils';
+import * as Schemas from '../tools/schemas/schema';
+
+const dataFileDir = 'lib/data';
+const schemaDir = 'tools/schemas';
+const schemasAndJsonFiles: {
+  schemaName: keyof typeof Schemas;
+  dataFileName: string;
+}[] = [];
+
+describe('validate-schemas', () => {
+  it('validate json files in lib/data against their schemas', async () => {
+    const schemaFiles = (await fs.readdir(schemaDir)).filter(
+      (file) => upath.extname(file) === '.json',
+    );
+
+    for (const schemaFile of schemaFiles) {
+      const correspondingDatFileName = schemaFile.replace('-schema', '');
+      const schemaName = `${schemaFile
+        .replace('.json', '')
+        .split('-')
+        .map(capitalize)
+        .join('')}` as keyof typeof Schemas;
+      schemasAndJsonFiles.push({
+        schemaName,
+        dataFileName: correspondingDatFileName,
+      });
+    }
+
+    await Promise.all(
+      schemasAndJsonFiles.map(async ({ schemaName, dataFileName }) => {
+        const data = Json.parse(
+          await fs.readFile(upath.join(dataFileDir, dataFileName), 'utf8'),
+        );
+
+        let result: Record<string, unknown> =
+          // eslint-disable-next-line import/namespace
+          Schemas[schemaName].safeParse(data);
+        result = { ...result, dataFileName, schemaName };
+        expect(result).toMatchObject({
+          dataFileName,
+          schemaName,
+          success: true,
+        });
+      }),
+    );
+  });
+});

tools/schemas/monorepo-schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "type": "object",
+  "properties": {
+    "repoGroups": {
+      "type": "object",
+      "patternProperties": {
+        "^[a-zA-Z0-9. -]+$": {
+          "oneOf": [
+            { "type": "string", "format": "uri" },
+            {
+              "type": "array",
+              "items": { "type": "string", "format": "uri" }
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "orgGroups": {
+      "type": "object",
+      "patternProperties": {
+        "^[a-zA-Z0-9. -]+$": {
+          "oneOf": [
+            { "type": "string", "format": "uri" },
+            {
+              "type": "array",
+              "items": { "type": "string", "format": "uri" }
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "patternGroups": {
+      "type": "object",
+      "patternProperties": {
+        "^[a-zA-Z0-9. -]+$": {
+          "oneOf": [
+            { "type": "string", "pattern": "^/.+/$" },
+            {
+              "type": "array",
+              "items": { "type": "string", "pattern": "^/.+/$" }
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": ["repoGroups", "orgGroups", "patternGroups"],
+  "additionalProperties": false
+}

tools/schemas/schema.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+const UrlSchema = z.record(
+  z.string(),
+  z.union([z.string(), z.array(z.string())]),
+);
+
+const MonorepoSchema = z.object({
+  repoGroups: UrlSchema,
+  orgGroups: UrlSchema,
+  patternGroups: UrlSchema,
+});
+
+export { MonorepoSchema };