@sdk-it/cli v0.21.0

@sdk-it/cli

Installation

# Install globally
npm install -g sdk-it

# Or use with npx without installing
npx sdk-it

Usage

The CLI provides a simple way to generate SDKs from OpenAPI specifications

Basic Command Structure

npx sdk-it --spec <path-to-spec> --output <output-directory> [options]

Options

Mode Options

• minimal: Generates only the client SDK files (default)
• full: Generates a complete project including package.json and tsconfig.json (useful for monorepo/workspaces)

Formatter

You can specify a command to format the generated code. The special variable $SDK_IT_OUTPUT will be replaced with the output directory path.

Examples:

• --formatter "prettier $SDK_IT_OUTPUT --write"
• --formatter "biome check $SDK_IT_OUTPUT --write"

Supported Specification Formats

• JSON (.json)
• YAML (.yaml, .yml)

Examples

Generate SDK from a Remote OpenAPI Specification

npx sdk-it -s https://petstore.swagger.io/v2/swagger.json -o ./client

Generate SDK with Custom Client Name

npx sdk-it -s ./openapi.json -o ./client -n PetStore

Generate Full Project with Formatting

npx sdk-it -s ./openapi.yaml -o ./client -m full --formatter "prettier $SDK_IT_OUTPUT --write"

Complete Example

Let's generate a client SDK for the Hetzner Cloud API with automatic formatting:

# Generate SDK from Hetzner Cloud API spec with Prettier formatting
npx sdk-it -s https://docs.hetzner.cloud/spec.json -o ./client --formatter "prettier $SDK_IT_OUTPUT --write"

After running this command:

1. The OpenAPI specification is downloaded from the Hetzner Cloud documentation
2. A type-safe TypeScript SDK is generated in the ./client directory
3. Prettier is run on the generated code to ensure consistent formatting

You can then use the generated SDK in your application:

import { Client } from './client';

// Create a client instance with your API token
const client = new Client({
  baseUrl: 'https://api.hetzner.cloud/v1',
  headers: {
    Authorization: 'Bearer your_api_token',
  },
});

// Call API methods with type safety
const [servers, error] = await client.request('GET /servers', {});

if (error) {
  console.error('Error fetching servers:', error);
} else {
  console.log('Servers:', servers);
}