refactor(schema): simplify validation and OpenAPI generation (#2709)

packages/schema/src/SchemaMetadata.ts

@@ -0,0 +1,29 @@
+import {z} from 'zod';
+
+export interface EnumEntry {
+	name: string;
+	value: string | number;
+	description?: string;
+}
+
+export interface BitflagEntry {
+	name: string;
+	value: string;
+	description?: string;
+}
+
+interface SchemaMetadata {
+	name?: string;
+	enumEntries?: Array<EnumEntry>;
+	openEnum?: boolean;
+	bitflagValues?: Array<BitflagEntry>;
+	format?: string;
+}
+
+export const schemaMetadata = z.registry<SchemaMetadata>();
+
+export function withSchemaMetadata<T extends z.ZodType>(schema: T, metadata: SchemaMetadata): T {
+	const registeredSchema: z.ZodType = schema;
+	schemaMetadata.add(registeredSchema, metadata);
+	return schema;
+}