feat: split commands into lean + validated files for tree-shaking

Generates two parallel command files: a lean commands.ts with zero schema
imports (just HTTP plumbing + types), and commands-validated.ts whose
subclasses attach static responseSchema. Consumers swap the import path (or
use a bundler alias dev → validated) to opt into runtime response validation
without paying for it in prod. valibot lazy-loads in rest-client, so prod
imports that skip the validated file never pull valibot at all.

Also fixes a longstanding bug: inline 2xx response bodies with nested \$refs
(e.g. \`{ user: { \$ref: "..." } }\`) now correctly generate a per-command
response schema. Previously the codegen silently fell through, producing
commands with no static responseSchema and a silent validation gap.

Dead-weight removal: static bodySchema, paramsSchema, querySchema are no
longer emitted on Command classes. They were never consumed by rest-client,
and server middleware imports schemas directly from valibot.ts.

Uses namespace imports (\`import * as commands\` / \`import * as schemas\`) in
the validated file to keep generated output compact and stable across
regenerations — adding/removing a single command no longer churns the import
list.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: maxholman

__tests__/__snapshots__/nullables.test.ts.snap

@@ -39,7 +39,6 @@ export type UploadDataCommandInput = UploadDataCommandParams;
 exports[`header parameters 2`] = `
 "import { Command } from "@block65/rest-client";
 import type { UploadDataCommandHeader, UploadDataCommandInput, UploadStatus } from "./types.js";
-import { uploadDataCommandParamsSchema, uploadStatusSchema } from "./valibot.js";
 
 /**
  * Tagged template literal that applies encodeURIComponent to all interpolated 
@@ -56,8 +55,6 @@ function encodePath(strings: TemplateStringsArray, ...values: string[]): string
  */
 export class UploadDataCommand extends Command<UploadDataCommandInput, UploadStatus, never, UploadDataCommandHeader> {
     public override method = "post" as const;
-    static paramsSchema = uploadDataCommandParamsSchema;
-    static responseSchema = uploadStatusSchema;
 
     constructor(input: UploadDataCommandInput, headers: UploadDataCommandHeader) {
         const {uploadId } = input;
@@ -68,10 +65,22 @@ export class UploadDataCommand extends Command<UploadDataCommandInput, UploadSta
 `;
 
 exports[`header parameters 3`] = `
+"import * as commands from "./commands.js";
+import * as schemas from "./valibot.js";
+
+export class UploadDataCommand extends commands.UploadDataCommand {
+    static responseSchema = schemas.uploadDataCommandResponseSchema;
+}
+"
+`;
+
+exports[`header parameters 4`] = `
 "import * as v from "valibot";
 
 export const exactUploadStatusSchema = v.picklist(["pending", "complete"]);
 export const uploadStatusSchema = exactUploadStatusSchema;
+export const exactUploadDataCommandResponseSchema = exactUploadStatusSchema;
+export const uploadDataCommandResponseSchema = uploadStatusSchema;
 export const exactUploadDataCommandParamsSchema = v.strictObject({
         "uploadId": v.string()
     });
@@ -91,7 +100,7 @@ export const uploadDataCommandHeaderSchema = v.object({
 "
 `;
 
-exports[`header parameters 4`] = `
+exports[`header parameters 5`] = `
 "import { validator } from "hono/validator";
 import * as v from "valibot";
 import { PublicValibotHonoError } from "@block65/rest-client";
@@ -148,6 +157,8 @@ export const exactDummySchema = v.string();
 export const dummySchema = v.pipe(v.string(), v.trim());
 export const exactExpireTimeSchema = v.pipe(v.bigint(), v.minValue(BigInt(0)));
 export const expireTimeSchema = v.union([v.pipe(v.string(), v.decimal(), v.toBigint(), v.pipe(v.bigint(), v.minValue(BigInt(0)))), v.pipe(v.number(), v.integer(), v.toBigint(), v.pipe(v.bigint(), v.minValue(BigInt(0)))), v.pipe(v.bigint(), v.minValue(BigInt(0)))]);
+export const exactListFilesCommandResponseSchema = exactDummySchema;
+export const listFilesCommandResponseSchema = dummySchema;
 export const exactListFilesCommandQuerySchema = v.strictObject({
         "exp": v.pipe(v.bigint(), v.minValue(BigInt(0))),
         "limit": v.exactOptional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100)))

__tests__/fixtures/petstore.json

@@ -184,6 +184,52 @@
 					}
 				}
 			}
+		},
+		"/pets/{id}/wrapped": {
+			"get": {
+				"description": "Returns a pet inside an envelope — exercises inline 2xx response shape with nested $ref",
+				"operationId": "findPetWrapped",
+				"parameters": [
+					{
+						"name": "id",
+						"in": "path",
+						"description": "ID of pet to fetch",
+						"required": true,
+						"schema": {
+							"type": "integer",
+							"format": "int64"
+						}
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "wrapped pet response",
+						"content": {
+							"application/json": {
+								"schema": {
+									"type": "object",
+									"required": ["pet"],
+									"properties": {
+										"pet": {
+											"$ref": "#/components/schemas/Pet"
+										}
+									}
+								}
+							}
+						}
+					},
+					"default": {
+						"description": "unexpected error",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								}
+							}
+						}
+					}
+				}
+			}
 		}
 	},
 	"components": {

__tests__/nullables.test.ts

@@ -274,6 +274,7 @@ test("header parameters", async () => {
 
 	expect(result.typesFile.getText()).toMatchSnapshot();
 	expect(result.commandsFile.getText()).toMatchSnapshot();
+	expect(result.commandsValidatedFile.getText()).toMatchSnapshot();
 	expect(result.valibotFile.getText()).toMatchSnapshot();
 	expect(result.honoValibotFile.getText()).toMatchSnapshot();
 });

lib/build.ts

@@ -27,6 +27,7 @@ export async function build(
 
 	const {
 		commandsFile,
+		commandsValidatedFile,
 		typesFile,
 		mainFile,
 		valibotFile,
@@ -40,10 +41,14 @@ export async function build(
 		mainFile,
 		valibotFile,
 		honoValibotFile,
+		...(commandsValidatedFile.getStatements().length > 0
+			? [commandsValidatedFile]
+			: []),
 		...(enumsFile.getStatements().length > 0 ? [enumsFile] : []),
 	];
 
 	commandsFile.insertStatements(0, "/** eslint-disable max-classes */");
+	commandsValidatedFile.insertStatements(0, "/** eslint-disable max-classes */");
 
 	// eslint-disable-next-line no-restricted-syntax
 	for await (const file of files) {

lib/hono-valibot.ts

@@ -46,7 +46,13 @@ export function createHonoValibotFile(
 export function createHonoValibotMiddleware(
 	honoValibotFile: SourceFile,
 	exportName: string,
-	schemas: { json?: string; param?: string; query?: string; header?: string },
+	schemas: {
+		json?: string;
+		response?: string;
+		param?: string;
+		query?: string;
+		header?: string;
+	},
 ): void {
 	honoValibotFile.addVariableStatement({
 		isExported: true,
@@ -57,8 +63,11 @@ export function createHonoValibotMiddleware(
 				initializer: (writer) => {
 					writer.write("[");
 					writer.indent(() => {
+						// Hono validators only run on inbound request data; response
+						// schemas are emitted for client-side consumption only, and
+						// `header` is intentionally skipped (extra HTTP headers ok).
 						for (const [target, schemaName] of Object.entries(schemas).filter(
-							([t]) => t !== "header",
+							([t]) => t !== "header" && t !== "response",
 						)) {
 							writer.writeLine(
 								`validator(${JSON.stringify(target)}, (value) => {`,