add docker compose schema

generator/compose.mjs

@@ -0,0 +1,20 @@
+import { writeFile } from "node:fs/promises";
+
+import { compile } from "json-schema-to-typescript";
+import { generate } from "ts-to-zod";
+import { fetch } from "undici";
+
+// TODO: see if they finally added versioning: https://github.com/compose-spec/compose-spec/issues/104
+const SCHEMA_URL = "https://raw.githubusercontent.com/compose-spec/compose-spec/refs/heads/main/schema/compose-spec.json";
+
+// json-schema -> typescript -> zod
+// done this way because going to zod directly produces an extremely complex schema
+// mostly due to patternProperties abuse
+async function main() {
+  const schema = await (await fetch(SCHEMA_URL)).json();
+  const ts = await compile(schema, "docker-compose");
+  const out = generate({ sourceText: ts, getSchemaName: (id) => id[0].toUpperCase() + id.slice(1) + "Schema" });
+  await writeFile("./src/compose.ts", out.getZodSchemasFile(""));
+}
+
+(async () => await main())();

generator/generator.mjs

@@ -8,11 +8,11 @@ import { fetch } from "undici";
 
 import { applyFixes } from "./fixes.mjs";
 
+const SCHEMA_URL = "https://docs.docker.com/reference/api/engine/version/v1.47.yaml"
+
 async function main() {
 
-  const schema = YAML.parse(
-    await (await fetch("https://docs.docker.com/reference/api/engine/version/v1.47.yaml")).text(),
-  );
+  const schema = YAML.parse(await (await fetch(SCHEMA_URL)).text());
 
   applyFixes(schema);
   await dereference(schema);

package.json

@@ -29,7 +29,7 @@
     "postbuild": "tsc-alias --project tsconfig-build.json",
     "format": "biome check --verbose --write --unsafe",
     "pregenerate": "rm -rf ./dist ./src",
-    "generate": "node ./generator/generator.mjs",
+    "generate": "node ./generator/generator.mjs && node ./generator/compose.mjs",
     "postgenerate": "pnpm run format",
     "test": "jest",
     "prepare": "husky"
@@ -50,10 +50,12 @@
     "@types/ssh2": "^1.15.1",
     "husky": "^9.1.6",
     "jest": "^29.7.0",
+    "json-schema-to-typescript": "^15.0.2",
     "json-schema-to-zod": "^2.4.1",
     "nunjucks": "^3.2.4",
     "semver": "^7.6.3",
     "ts-jest": "^29.2.5",
+    "ts-to-zod": "^3.13.0",
     "tsc-alias": "^1.8.10",
     "typescript": "^5.6.3",
     "yaml": "^2.6.0"