@skmtc/core

v0.0.984

Published

18 days ago

Skmtc is a declarative code generation framework

0High
0Medium
0Low

openapi swagger typescript codegen code generator

Skmtc is a declarative code generation framework. It lets you generate TypeScript code from OpenAPI schemas without complex ASTs.

✨ Features

🏎️ Fast - Generates 550k+ tokens per second
🧵 Easy to edit code generators - Outputs specified using string templates, not ASTs
🥞 Stackable generators - Compose complex functionality by combining generators
🗄️ Use your own code conventions - Full control over naming and file structure

🚀 Quick Start

# Run directly with npx
npx skmtc

Running code generators

npx skmtc generate @skmtc/supabase-backend https://petstore3.swagger.io/api/v3/openapi.json
# Generated 9 files (507 lines, 3,383 tokens) in 9ms

npx skmtc generate @skmtc/supabase-react-client https://raw.githubusercontent.com/cloudflare/api-schemas/refs/heads/main/openapi.json
# Generated 6,797 files (104,752 lines, 1,635,227 tokens) in 2,969ms

Example generator code

import { ZodInsertable } from '@skmtc/gen-zod'

class ZodFetch extends BaseTransformer {
  zodName: string;

  constructor({context, operation, settings}){
    super({context, operation, settings})

    // Generate Zod schema for API response and insert it into current file
    const response = operation.toSuccessResponse()?.resolve().toSchema()
    const zodResponse = this.insert(ZodInsertable, response)

    // Grab Zod schema name to use in output code
    this.zodName = zodResponse.identifier.name
  }

  // Define code output
  toString(){
    return `() => {
      const res = await fetch('${this.operation.path}')
      const data = await res.json()

      return ${zodName}.parse(data)
    }`
  }
}

📦 Available Generators

Choose from our growing collection of generators, combone them or create your own:

Tanstack Query - React Query hooks with Zod validation
MSW - Mock Service Worker handlers from OpenAPI examples
Zod Schemas - Runtime validation schemas
TypeScript Types - Pure type definitions
Supabase/Hono Functions - Edge function handlers
See full list at https://github.com/skmtc/skmtc-generators

❓ FAQ

What OpenAPI versions are supported?

Skmtc supports OpenAPI v3.0. Swagger 2.0 and OpenAPI v3.1 are automatically converted to OpenAPI v3.0.

Can I customize the generated code?

Yes! Each Transformer specifies its output using plain string templates, which means you can edit them as would you edit any other code.

Can I use this with my existing React app?

Yes! Skmtc generates standalone code that integrates with any React application. The generated components work with your existing setup.

How does this compare to OpenAPI Generator?

Skmtc is the only code generation framework that provides full control over the generated code. You are not limited by library-specific settings and you do not need to write complex AST code.

Does it work with Next.js/Remix/Vite?

Yes! The generated code is framework-agnostic TypeScript that works with any build tool or library.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme