hey-api-builders/src/plugin/handler.ts

A custom plugin for @hey-api/openapi-ts that generates mock data builders with a lightweight custom runtime, Zod integration, or static mock generation.

import type { IR } from '@hey-api/openapi-ts';
import type { BuildersHandler, MockStrategy } from '../types';
import { collectSchemas } from '../core/schema-transformer';
import { generateZodSchema } from '../generators/zod-schema-generator';
import { generateEnumBuilder, generateObjectBuilder } from '../generators/builder-generator';
import {
  generateImports,
  generateBuilderOptionsType,
  generateSchemaConstants,
} from '../core/code-generator';

/**
 * Resolves the mock strategy from config, handling backward compatibility
 */
function resolveMockStrategy(config: {
  mockStrategy?: MockStrategy;
  useZodForMocks?: boolean;
  useStaticMocks?: boolean;
}): MockStrategy {
  // New config takes precedence
  if (config.mockStrategy) {
    return config.mockStrategy;
  }

  // Backward compatibility with old boolean flags
  if (config.useStaticMocks) {
    return 'static';
  }
  if (config.useZodForMocks) {
    return 'zod';
  }

  // Default strategy
  return 'runtime';
}

/**
 * Main plugin handler for generating builder classes
 */
export const handler: BuildersHandler = ({ plugin, context }) => {
  const rawSchemas: Record<string, IR.SchemaObject> = {};
  plugin.forEach('schema', (event) => {
    rawSchemas[event.name] = event.schema;
  });

  const modelNameProvider = context?.casing?.modelName;
  const normalize = modelNameProvider ? (name: string) => modelNameProvider(name) : undefined;

  const metas = collectSchemas(rawSchemas, normalize);

  const file = plugin.createFile({ id: plugin.name, path: plugin.output });

  const config = plugin.config;
  const generateZod = config.generateZod || false;
  const mockStrategy = resolveMockStrategy(config);

  let out = '';

  out += generateImports({ mockStrategy, generateZod });

  out += generateBuilderOptionsType();

  if (mockStrategy === 'runtime') {
    out += generateSchemaConstants(metas);
  }

  if (generateZod || mockStrategy === 'zod') {
    const zodSchemaEntries: string[] = [];
    for (const m of metas) {
      const zodSchemaString = generateZodSchema(m.schema);
      zodSchemaEntries.push(`  ${m.constName}Zod: ${zodSchemaString}`);
    }
    out += 'export const zodSchemas = {\n' + zodSchemaEntries.join(',\n') + '\n}\n\n';
  }

  for (const m of metas) {
    if (m.isEnum) {
      out += generateEnumBuilder(m, { mockStrategy });
    } else {
      out += generateObjectBuilder(m, { mockStrategy });
    }
  }

  file.add(out);
};