Convert curl & Postman to OpenAPI 3.2

import { curlToOpenApi } from "@powerduck/x-to-openapi";

// Full ConvertOptions — all fields shown
const result = await curlToOpenApi(`curl -X POST https://api.example.com/v1/users \
  -H "Content-Type: application/json" \
  -d '{"name": "John", "email": "john@example.com"}'`, {
  openapiVersion: "3.2.0",              // Output OpenAPI version
  title: "User API",                   // Document title
  version: "1.0.0",                    // Document version
  description: "User management API",    // Document description
  inferPathParameters: true,              // Detect /users/123 → /users/{userId}
  pathParameterMinSamples: 2,               // Min samples before inferring params
  inferSecurity: true,                    // Infer auth from headers/cookies
  includeCommonHeaders: false,             // Include User-Agent, Accept, etc.
  includeCookies: false,                   // Include cookies (default: false, live session risk)
  includeExamples: true,                   // Include request/response examples
  useServerBasePath: true,                // Collapse common origin into servers[0]
  validate: true,                         // Validate output against OpenAPI 3.2
  strict: false,                         // Strict mode: fail on warnings
});

// ConvertResult: { document, requests, diagnostics, ok, documentValid }
console.log(`OK: ${result.ok}, Valid: ${result.documentValid}, Requests: ${result.requests.length}`);
console.log(JSON.stringify(result.document, null, 2));

import { postmanToOpenApi } from "@powerduck/x-to-openapi";
import fs from "node:fs";

const collection = JSON.parse(fs.readFileSync("./postman_collection.json", "utf8"));
const result = await postmanToOpenApi(collection, {
  title: "My API", version: "2.0.0",
});
fs.writeFileSync("openapi.json", JSON.stringify(result.document, null, 2));

import { XToOpenApi, CurlAdapter, splitCurlCommands } from "@powerduck/x-to-openapi";
import fs from "node:fs";

const converter = new XToOpenApi();
converter.register(new CurlAdapter());

const script = fs.readFileSync("./curls.sh", "utf8");
const commands = splitCurlCommands(script);
const result = await converter.convert("curl", commands);
console.log(`Converted ${result.requests.length} requests`);

import { XToOpenApi } from "@powerduck/x-to-openapi";

// Custom adapter must implement: id, canHandle?, parse()
const myAdapter = {
  id: "my-format",
  canHandle(input) { return typeof input === "string" && input.startsWith("myapi:"); },
  async parse(input, context) {
    const [method, path] = input.replace("myapi:", "").split(" ");
    return [{
      source: "my-format", sourceIndex: 0,
      method: method.toLowerCase(),
      url: new URL(`https://api.example.com${path}`),
      urlString: `https://api.example.com${path}`,
      headers: [], query: [], cookies: [],
    }];
  },
};

const converter = new XToOpenApi();
converter.register(myAdapter);
const result = await converter.convert("my-format", "myapi:GET /users");