chg: cli for validation and schema

Author: nicokant

.github/workflows/build-cli.yml

@@ -14,7 +14,7 @@ jobs:
       matrix:
         include:
           - target: x86_64-unknown-linux-gnu
-            output: nina-map-validate-linux-x86_64
+            output: nina-map-cli-linux-x86_64
 
     steps:
       - uses: actions/checkout@v4
@@ -24,7 +24,7 @@ jobs:
           deno-version: v2.x
 
       - name: Compile
-        run: deno compile --sloppy-imports --target ${{ matrix.target }} --output dist/${{ matrix.output }} src/validate.ts
+        run: deno compile --sloppy-imports --target ${{ matrix.target }} --output dist/${{ matrix.output }} src/cli.ts
 
       - uses: actions/upload-artifact@v4
         with:

.husky/pre-commit

@@ -1,3 +1 @@
 pnpm lint-staged
-pnpm generate-schema
-git add schemas/map-config.schema.json

deno.lock

@@ -10,9 +10,9 @@
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
     "preview": "vite preview",
-    "generate-schema": "pnpx vite-node scripts/generate-schema.ts",
-    "validate": "deno run src/validate.ts",
-    "validate:build": "deno compile --sloppy-imports --output dist/nina-map-validate src/validate.ts",
+    "generate-schema": "deno run --sloppy-imports src/cli.ts schema > schemas/map-config.schema.json",
+    "cli": "deno run --sloppy-imports src/cli.ts",
+    "cli:build": "deno compile --sloppy-imports --output dist/nina-map-cli src/cli.ts",
     "prepare": "husky"
   },
   "dependencies": {

package.json

@@ -1,7 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "Map Configuration Schema",
-  "description": "Schema for nina-maps map configuration",
+  "title": "Nina Maps Configuration",
+  "description": "Configuration schema for a nina-maps map.",
+  "version": "0.1.3",
   "type": "object",
   "properties": {
     "title": {
@@ -1222,4 +1223,4 @@
     "config"
   ],
   "additionalProperties": false
-}
+}

schemas/map-config.schema.json

@@ -0,0 +1,59 @@
+#!/usr/bin/env -S deno run
+/// <reference lib="deno.ns" />
+import { Command } from 'jsr:@cliffy/command@^1';
+import * as z from 'zod';
+import pkg from '../package.json' with { type: 'json' };
+import { MapConfigSchema } from './schemas';
+
+await new Command()
+  .name('nina-maps')
+  .version(pkg.version)
+  .description('CLI tools for nina-maps.')
+  .command(
+    'validate',
+    new Command()
+      .description('Validate a nina-maps JSON configuration read from stdin.')
+      .option('--raw', 'Output the raw zod error tree as JSON instead of prettified text.')
+      .action(async ({ raw }) => {
+        let input: string;
+        try {
+          input = await new Response(Deno.stdin.readable).text();
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          console.error(`Error reading input: ${message}`);
+          Deno.exit(1);
+        }
+
+        let data: unknown;
+        try {
+          data = JSON.parse(input);
+        } catch {
+          console.error('Error: input is not valid JSON');
+          Deno.exit(1);
+        }
+
+        const result = MapConfigSchema.safeParse(data);
+
+        if (result.success) {
+          console.log('Valid map configuration.');
+        } else {
+          const message = raw ? JSON.stringify(z.treeifyError(result.error), null, 2) : z.prettifyError(result.error);
+          console.error(message);
+          Deno.exit(1);
+        }
+      }),
+  )
+  .command(
+    'schema',
+    new Command().description('Print the JSON Schema for a nina-maps configuration.').action(() => {
+      const schema = {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        title: 'Nina Maps Configuration',
+        description: 'Configuration schema for a nina-maps map.',
+        version: pkg.version,
+        ...z.toJSONSchema(MapConfigSchema),
+      };
+      console.log(JSON.stringify(schema, null, 2));
+    }),
+  )
+  .parse(Deno.args);

scripts/generate-schema.ts

@@ -26,5 +26,5 @@
     "noUncheckedSideEffectImports": true
   },
   "include": ["src"],
-  "exclude": ["src/validate.ts"]
+  "exclude": ["src/cli.ts"]
 }