(docs) add zod to typecheck joke API

docs/package.json

@@ -32,7 +32,8 @@
     "path-browserify": "^1.0.1",
     "prism-react-renderer": "^2.3.0",
     "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react-dom": "^18.0.0",
+    "zod": "^3.23.8"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.5.2",

docs/src/components/Terminal/joke.ts

@@ -1,25 +1,44 @@
 import type { JQueryTerminal } from 'jquery.terminal';
 
+import { z } from 'zod';
+
+const singleJokeSchema = z.object({
+  type: z.literal('single'),
+  joke: z.string()
+});
+
+const twoPartJokeSchema = z.object({
+  type: z.literal('twopart'),
+  setup: z.string(),
+  delivery: z.string()
+});
+
+const jokeSchema = z.union([singleJokeSchema, twoPartJokeSchema]);
+
 export default async function joke(this: JQueryTerminal) {
   const res = await fetch('https://v2.jokeapi.dev/joke/Programming');
-  const data = await res.json();
+  const json = await res.json();
+
+  const { data, success } = jokeSchema.safeParse(json);
+
+  if (!success) {
+    return this.error("Error: Invalid joke data format");
+  }
+
+  const options = {
+    delay: 50,
+    typing: true,
+    keepWords: true
+  };
+
   (async () => {
     if (data.type == 'twopart') {
       this.animation(async () => {
-        await this.echo(`Q: ${data.setup}`, {
-          delay: 50,
-          typing: true
-        });
-        await this.echo(`A: ${data.delivery}`, {
-          delay: 50,
-          typing: true
-        });
+        await this.echo(`Q: ${data.setup}`, options);
+        await this.echo(`A: ${data.delivery}`, options);
       });
     } else if (data.type === 'single') {
-      await this.echo(data.joke, {
-        delay: 50,
-        typing: true
-      });
+      await this.echo(data.joke, options);
     }
   })();
 }