From 206d1571ace96af501dc40e706a5b780dcfb1c7e Mon Sep 17 00:00:00 2001
From: FoxxMD <FoxxMD@users.noreply.github.com>
Date: Mon, 27 Jul 2026 20:56:14 +0000
Subject: [PATCH] feat(docs): Use zod for all doc schemas and simplify
 generation/usage

---
 .../src/components/GenericConfiguration.mdx   |  4 +-
 src/backend/utils/SchemaDocsStaticUtils.ts    | 52 +++++--------------
 2 files changed, 16 insertions(+), 40 deletions(-)

diff --git a/docsite/src/components/GenericConfiguration.mdx b/docsite/src/components/GenericConfiguration.mdx
index 07862d38..15342f80 100644
--- a/docsite/src/components/GenericConfiguration.mdx
+++ b/docsite/src/components/GenericConfiguration.mdx
@@ -25,7 +25,7 @@ import {useWindowSize} from '@docusaurus/theme-common';
             <DetailsAdmo type="note" summary="Config Structure">
                 This displays the **structure** of the [File Configuration](/configuration?configType=aio#configuration-types) for a <strong children={props.name}/> type <strong children={props.client ? 'Client' : 'Source'}/> with all possible properties, their shape, and descriptions/types. Use this to understand how to write a valid config.
             </DetailsAdmo>
-                <ExplorerFetch name={`schemas/${props.config}`} />
+                <ExplorerFetch name={`schemas/${props.name}-${props.client ? 'client' : 'source'}`} />
             </div>
             <div style={{ flexBasis: 'auto', flexGrow: 3 }}>
             <div className="fileEditor">
@@ -51,7 +51,7 @@ import {useWindowSize} from '@docusaurus/theme-common';
                 filePathName={`CONFIG/${props.name}.json`}
                 configureAs={props.client ? 'client' : 'source'} 
                 data={props.fileContent}
-                schemaName={props.config}
+                schemaName={`${props.name}-${props.client ? 'client' : 'source'}`}
                 readOnlyAtWidth={500}
              />
             </div>
diff --git a/src/backend/utils/SchemaDocsStaticUtils.ts b/src/backend/utils/SchemaDocsStaticUtils.ts
index d2a81731..ba479c74 100644
--- a/src/backend/utils/SchemaDocsStaticUtils.ts
+++ b/src/backend/utils/SchemaDocsStaticUtils.ts
@@ -1,20 +1,18 @@
 import { writeFileSync, mkdirSync } from "node:fs";
 import { resolve } from "path";
 import * as z from 'zod';
-import {getTypeSchemaFromConfigGenerator} from "./SchemaUtils.ts";
-import { atomicClientInterfaces } from '../common/infrastructure/config/client/clients.ts';
-import { atomicSourceInterfaces } from '../common/infrastructure/config/source/sources.ts';
+import { clientConfigSchemaMap } from '../common/infrastructure/config/client/clients.ts';
+import { sourceConfigSchemaMap } from '../common/infrastructure/config/source/sources.ts';
 import { projectRootDir } from "../common/infrastructure/Atomic.ts";
-import { koitoClientConfigSchema } from "../common/infrastructure/config/client/koito.ts";
 
 mkdirSync(resolve(projectRootDir, 'docsite/static/schemas'), {recursive: true});
 
-const jsonSchema = z.toJSONSchema(koitoClientConfigSchema, { 
-    io: "output",
+const generateSchema = (schema: z.ZodType) => z.toJSONSchema(z.array(schema), { 
+    io: "input",
     reused: "inline",
+    target: "draft-07",
     unrepresentable: "any",
     override: (ctx) => {
-        //const def = ctx.zodSchema._zod.def;
         if(ctx.jsonSchema.anyOf !== undefined && Array.isArray(ctx.jsonSchema.anyOf)) {
             for(const a of ctx.jsonSchema.anyOf) {
                 if(a.const !== undefined) {
@@ -38,37 +36,15 @@ const jsonSchema = z.toJSONSchema(koitoClientConfigSchema, {
             delete ctx.jsonSchema.const;
             return
         }
-        // if(ctx.zodSchema.type === 'object') {
-        //     const ks = Object.keys(ctx.jsonSchema.properties);
-        //     for(const k of ks) {
-        //         if(ctx.jsonSchema.properties[k]?.description !== undefined) {
-        //             let isUnion = ctx.zodSchema.shape[k].type === 'union';
-        //             if(!isUnion && ctx.zodSchema.shape[k].type === 'optional' && ctx.zodSchema.shape[k].unwrap().type === 'union') {
-        //                 isUnion = true;
-        //             }
-        //             if(ctx.zodSchema.shape[k].type === 'union')
-        //             // ctx.zodSchema.shape[k].
-        //         }
-        //     }
-        // }
-
-        // if (ctx.jsonSchema.anyOf) {
-        //     ctx.jsonSchema.oneOf = ctx.jsonSchema.anyOf;
-        //     delete ctx.jsonSchema.anyOf;
-        // }
     }
- });
-writeFileSync(resolve(projectRootDir, `docsite/static/schemas/KoitoClientConfig.json`), JSON.stringify(jsonSchema));
-
-// const aio = getTypeSchemaFromConfigGenerator('AIOConfig');
-// writeFileSync(resolve(projectRootDir, 'docsite/static/schemas/aio.json'), JSON.stringify(aio));
+ })
 
-// for(const inter of atomicSourceInterfaces) {
-//     const schema = getTypeSchemaFromConfigGenerator(`${inter}s`);
-//     writeFileSync(resolve(projectRootDir, `docsite/static/schemas/${inter}.json`), JSON.stringify(schema));
-// }
+const clientEntries = Object.entries(clientConfigSchemaMap);
+for(const [k,v] of clientEntries) {
+    writeFileSync(resolve(projectRootDir, `docsite/static/schemas/${k}-client.json`), JSON.stringify(generateSchema(v)));
+}
 
-// for(const inter of atomicClientInterfaces) {
-//     const schema = getTypeSchemaFromConfigGenerator(`${inter}s`);
-//     writeFileSync(resolve(projectRootDir, `docsite/static/schemas/${inter}.json`), JSON.stringify(schema));
-// }
\ No newline at end of file
+const sourcesEntries = Object.entries(sourceConfigSchemaMap);
+for(const [k,v] of sourcesEntries) {
+    writeFileSync(resolve(projectRootDir, `docsite/static/schemas/${k}-source.json`), JSON.stringify(generateSchema(v[0])));
+}
\ No newline at end of file
-- 
2.51.2