@counterfact/openapi

Load, bundle, dereference, and apply ordered OpenAPI overlays without starting the Counterfact server, generator, or REPL.

import {
  applyOverlays,
  bundleOpenApiDocument,
  loadOpenApiDocument,
} from "@counterfact/openapi";

const dereferenced = await loadOpenApiDocument("./openapi.yaml", [
  "./development.overlay.yaml",
]);
const bundled = await bundleOpenApiDocument("./openapi.yaml");

await applyOverlays(dereferenced, ["./local.overlay.yaml"]);
void bundled;

loadOpenApiDocument resolves references completely. Use bundleOpenApiDocument when a consumer needs external references folded into one document while retaining internal references. Overlay paths are applied in the order provided.

See examples/load-local-spec.mjs for a complete public-import example.