Generate HTTP client code from any OpenAPI doc.

import { generate } from "@powerduck/openapi-codegen";

const document = {
  openapi: "3.1.0",
  info: { title: "Demo API", version: "1.0.0" },
  servers: [{ url: "https://api.example.com/v1" }],
  paths: {
    "/users/{id}": {
      get: {
        operationId: "getUser",
        parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
        responses: { "200": { description: "OK" } },
      },
    },
  },
};

// Full GenerateOptions — all fields shown
const code = generate({
  document,                          // OpenAPI document (required if no request)
  path: "/users/{id}",             // Operation path
  method: "get",                  // HTTP method
  language: "python",              // Target language (required)
  client: "requests",              // HTTP client (required)
  serverUrl: "https://api.example.com/v1", // Override servers[0].url
  securityValues: { bearerAuth: "my-token" }, // Auth values
  softRefMode: false,              // Soft $ref resolution
});

console.log(code);

import { register, generate } from "@powerduck/openapi-codegen";

// Register a custom generator — full RequestIR API shown
register({
  language: "mylang",
  client: "myclient",
  generate(request) {
    // RequestIR fields:
    const { method, baseUrl, path, parameters, headers, body, security } = request;
    // parameters: Parameter[] — { name, in: "path"|"query"|"header"|"cookie", value, style?, explode?, allowReserved? }
    // headers: Parameter[] — same shape as parameters
    // body?: Body — { mediaType, value, encoding? }
    // security: Security[] — { name, type, scheme?, in?, paramName?, value }
    return `// ${method.toUpperCase()} ${baseUrl}${path}`;
  },
});

// Or pass a pre-built RequestIR directly (no document needed)
const code = generate({
  language: "mylang",
  client: "myclient",
  request: {
    method: "post",
    baseUrl: "https://api.example.com",
    path: "/users",
    parameters: [{ name: "verbose", in: "query", value: true }],
    headers: [{ name: "X-Request-Id", in: "header", value: "abc-123" }],
    body: { mediaType: "application/json", value: { name: "John" } },
    security: [{ name: "bearerAuth", type: "http", scheme: "bearer", value: "token" }],
  },
});

import { use } from "@powerduck/openapi-codegen";

const myPlugin = {
  name: "my-custom-plugin",
  register({ register }) {
    register({
      language: "pluginlang",
      client: "pluginclient",
      generate(req) { return `// ${req.method}`; },
    });
  },
};

use(myPlugin);

import { list, get } from "@powerduck/openapi-codegen";

const all = list();
console.log(`Available: ${all.length} generators`);
all.forEach(({ language, client }) => console.log(`${language}/${client}`));

const gen = get("javascript", "fetch");