refactor: improve structure validation with zod (#10103)

Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>

packages/create-discord-bot/template/JavaScript/package.json

@@ -19,6 +19,7 @@
 		"eslint": "^8.53.0",
 		"eslint-config-neon": "^0.1.57",
 		"eslint-formatter-pretty": "^5.0.0",
-		"prettier": "^3.1.0"
+		"prettier": "^3.1.0",
+		"zod": "^3.22.4"
 	}
 }

packages/create-discord-bot/template/JavaScript/src/commands/index.js

@@ -1,3 +1,5 @@
+import { z } from 'zod';
+
 /**
  * Defines the structure of a command.
  *
@@ -6,16 +8,18 @@
  * @property {(interaction: import('discord.js').CommandInteraction) => Promise<void> | void} execute The function to execute when the command is called
  */
 
+/**
+ * Defines the schema for a command
+ */
+export const schema = z.object({
+	data: z.record(z.any()),
+	execute: z.function(),
+});
+
 /**
  * Defines the predicate to check if an object is a valid Command type.
  *
  * @type {import('../util/loaders.js').StructurePredicate<Command>}
  * @returns {structure is Command}
  */
-export const predicate = (structure) =>
-	Boolean(structure) &&
-	typeof structure === 'object' &&
-	'data' in structure &&
-	'execute' in structure &&
-	typeof structure.data === 'object' &&
-	typeof structure.execute === 'function';
+export const predicate = (structure) => schema.safeParse(structure).success;

packages/create-discord-bot/template/JavaScript/src/events/index.js

@@ -1,3 +1,5 @@
+import { z } from 'zod';
+
 /**
  * Defines the structure of an event.
  *
@@ -8,16 +10,20 @@
  * @property {boolean} [once] Whether or not the event should only be listened to once
  */
 
+/**
+ * Defines the schema for an event.
+ *
+ */
+export const schema = z.object({
+	name: z.string(),
+	once: z.boolean().optional().default(false),
+	execute: z.function(),
+});
+
 /**
  * Defines the predicate to check if an object is a valid Event type.
  *
  * @type {import('../util/loaders').StructurePredicate<Event>}
  * @returns {structure is Event}
  */
-export const predicate = (structure) =>
-	Boolean(structure) &&
-	typeof structure === 'object' &&
-	'name' in structure &&
-	'execute' in structure &&
-	typeof structure.name === 'string' &&
-	typeof structure.execute === 'function';
+export const predicate = (structure) => schema.safeParse(structure).success;

packages/create-discord-bot/template/JavaScript/src/util/loaders.js

@@ -55,7 +55,9 @@ export async function loadStructures(dir, predicate, recursive = true) {
 		const structure = (await import(`${dir}/${file}`)).default;
 
 		// If the structure is a valid structure, add it
-		if (predicate(structure)) structures.push(structure);
+		if (predicate(structure)) {
+			structures.push(structure);
+		}
 	}
 
 	return structures;