OpenAPI Document Resolution Engine

import { loadOasDocument } from "@powerduck/oas-document";

// Load from YAML/JSON string or URL
const result = await loadOasDocument(yamlString, {
  autoUpgrade: true,  // auto-upgrade to 3.2 if needed
});

if (result.ok) {
  const doc = result.document;  // OpenApiDocument
  console.log(doc.title, doc.version);
} else {
  console.error(result.error);
}

import { parseOperations, flattenOperations } from "@powerduck/oas-document";

// Parse all operations from paths object
const parsed = parseOperations(doc);

// Flatten into display-ready operations with resolved refs
const ops = flattenOperations(parsed, doc);
// Each op has: method, path, summary, parameters, requestBody, responses

import { generateRequestExamples, buildCurlExample, buildJavaScriptExample } from "@powerduck/oas-document";

// Generate example request bodies from schema
const examples = generateRequestExamples(operation, doc);

// Build runnable code snippets
const curl = buildCurlExample(operation, doc, {
  serverUrl: "https://api.example.com",
});
const js = buildJavaScriptExample(operation, doc);

import { buildNavigationGroups } from "@powerduck/oas-document";

// Build tag-based navigation groups for sidebar UI
const groups = buildNavigationGroups(operations, doc);
// [{ tag: "Users", operations: [...] }, { tag: "Pets", ... }]