doc: use Zod to validate the parsed files

Author: DenisGorbachev

README.ts

@@ -1,37 +1,41 @@
 #!/usr/bin/env -S deno run --allow-read --allow-run=bash,git,cargo --allow-env --allow-sys
 
 import * as zx from 'npm:zx'
+import { z, ZodSchema } from "https://deno.land/x/[email protected]/mod.ts";
+
+const CargoToml = z.object({
+  package: z.object({
+    name: z.string(),
+    description: z.string(),
+    metadata: z.object({
+      details: z.object({
+        title: z.string(),
+        tagline: z.string(),
+        summary: z.string(),
+      })
+    })
+  })
+})
+
+type CargoToml = z.infer<typeof CargoToml>;
 
-interface CargoToml {
-  package: {
-    name: string,
-    description: string,
-    metadata: {
-      details: {
-        title: string,
-        tagline: string,
-        summary: string
-      }
-    }
-  }
-}
-
-interface Repo {
-  url: string
-}
+const Repo = z.object({
+  url: z.string().url(),
+})
+
+type Repo = z.infer<typeof Repo>;
 
 const $ = zx.$({
   cwd: import.meta.dirname
 })
-
-const parse = (input: { toString: () => string }) => JSON.parse(input.toString())
+const parse = <T>(schema: ZodSchema<T>, input: { toString: () => string }) => schema.parse(JSON.parse(input.toString()))
 const renderMarkdownList = (items: string[]) => items.map(bin => `* ${bin}`).join('\n')
 
-const theCargoToml: CargoToml = parse(await $`yj -t < Cargo.toml`)
+const theCargoToml: CargoToml = parse(CargoToml, await $`yj -t < Cargo.toml`)
 const { package: {name, description, metadata: {details: {title}}} } = theCargoToml
 const bin = name
 const help = await $`cargo run --quiet --bin ${bin} -- --help`
-const repo: Repo = parse(await $`gh repo view --json url`)
+const repo: Repo = parse(Repo, await $`gh repo view --json url`)
 const extraBins = (await $`find src/bin/*.rs -type f -exec basename {} .rs \\;`).valueOf().split("\n")
 
 const autogenerated = `