@kubb/adapter-oas 5.0.0-beta.75 → 5.0.0-beta.9

package/README.md

@@ -0,0 +1,98 @@
+<div align="center">
+  <h1>@kubb/adapter-oas</h1>
+  <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
+    <img width="180" src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo">
+  </a>
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Coverage][coverage-src]][coverage-href]
+[![License][license-src]][license-href]
+[![Sponsors][sponsors-src]][sponsors-href]
+
+<h4>
+<a href="https://kubb.dev/" target="_blank">Documentation</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Request Feature</a>
+</h4>
+</div>
+
+OpenAPI and Swagger adapter for Kubb. Parses and validates Swagger 2.0, OpenAPI 3.0, and OpenAPI 3.1 specifications and transforms them into a `@kubb/ast` `RootNode` for downstream code generation plugins.
+
+## Installation
+
+```bash
+bun add @kubb/adapter-oas
+# or
+pnpm add @kubb/adapter-oas
+# or
+npm install @kubb/adapter-oas
+```
+
+## Usage
+
+Use `adapterOas` inside your `kubb.config.ts`:
+
+```typescript
+import { defineConfig } from 'kubb'
+import { adapterOas } from '@kubb/adapter-oas'
+
+export default defineConfig({
+  input: {
+    path: './openapi.yaml',
+  },
+  output: {
+    path: './src/gen',
+  },
+  adapters: [adapterOas()],
+})
+```
+
+## Features
+
+- Supports Swagger 2.0, OpenAPI 3.0, and OpenAPI 3.1
+- Validates and dereferences `$ref` pointers
+- Merges multi-document specs
+- Outputs a `@kubb/ast` `RootNode` that every Kubb plugin reads from
+- Re-exports typed helpers for operations, schemas, parameters, and responses
+
+## API
+
+### `adapterOas(options?)`
+
+Creates the OAS adapter instance. Pass it in the `adapters` array of `defineConfig`.
+
+### `mergeDocuments(documents)`
+
+Merges multiple OpenAPI documents into a single document before parsing.
+
+### Types
+
+All OpenAPI types (`Document`, `Operation`, `SchemaObject`, `HttpMethod`, etc.) are re-exported from this package.
+
+## Supporting Kubb
+
+Kubb is an open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
+
+- [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
+
+<p align="center">
+  <a href="https://github.com/sponsors/stijnvanhulle">
+    <img src="https://raw.githubusercontent.com/stijnvanhulle/sponsors/main/sponsors.svg" alt="My sponsors" />
+  </a>
+</p>
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/@kubb/adapter-oas?flat&colorA=18181B&colorB=f58517
+[npm-version-href]: https://npmjs.com/package/@kubb/adapter-oas
+[npm-downloads-src]: https://img.shields.io/npm/dm/@kubb/adapter-oas?flat&colorA=18181B&colorB=f58517
+[npm-downloads-href]: https://npmjs.com/package/@kubb/adapter-oas
+[license-src]: https://img.shields.io/github/license/kubb-labs/kubb.svg?flat&colorA=18181B&colorB=f58517
+[license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
+[coverage-src]: https://img.shields.io/codecov/c/github/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517
+[coverage-href]: https://www.npmjs.com/package/@kubb/adapter-oas
+[sponsors-src]: https://img.shields.io/github/sponsors/stijnvanhulle?style=flat&colorA=18181B&colorB=f58517
+[sponsors-href]: https://github.com/sponsors/stijnvanhulle/

package/dist/index.cjs

@@ -47,7 +47,7 @@ let oas_utils = require("oas/utils");
 */
 const DEFAULT_PARSER_OPTIONS = {
 	dateType: "string",
-	integerType: "number",
+	integerType: "bigint",
 	unknownType: "any",
 	emptySchemaType: "any",
 	enumSuffix: "enum"
@@ -686,11 +686,10 @@ async function parseDocument(pathOrApi, { canBundle = true, enablePaths = true }
 * ```
 */
 async function mergeDocuments(pathOrApi) {
-	const documents = [];
-	for (const p of pathOrApi) documents.push(await parseDocument(p, {
+	const documents = await Promise.all(pathOrApi.map((p) => parseDocument(p, {
 		enablePaths: false,
 		canBundle: false
-	}));
+	})));
 	if (documents.length === 0) throw new Error("No OAS documents provided for merging.");
 	const seed = {
 		openapi: MERGE_OPENAPI_VERSION,
@@ -746,6 +745,7 @@ async function validateDocument(document, { throwOnError = false } = {}) {
 }
 //#endregion
 //#region src/refs.ts
+const _refCache = /* @__PURE__ */ new WeakMap();
 /**
 * Resolves a local JSON pointer reference from a document.
 *
@@ -763,8 +763,15 @@ function resolveRef(document, $ref) {
 	if ($ref === "") return null;
 	if ($ref.startsWith("#")) $ref = globalThis.decodeURIComponent($ref.substring(1));
 	else return null;
+	let docCache = _refCache.get(document);
+	if (!docCache) {
+		docCache = /* @__PURE__ */ new Map();
+		_refCache.set(document, docCache);
+	}
+	if (docCache.has($ref)) return docCache.get($ref);
 	const current = $ref.split("/").filter(Boolean).reduce((obj, key) => obj?.[key], document);
 	if (!current) throw new Error(`Could not find a definition for ${origRef}.`);
+	docCache.set($ref, current);
 	return current;
 }
 /**
@@ -1946,6 +1953,9 @@ const adapterOas = (0, _kubb_core.createAdapter)((options) => {
 		get inputNode() {
 			return inputNode;
 		},
+		async validate(input, options) {
+			await validateDocument(await parseDocument(input), options);
+		},
 		getImports(node, resolve) {
 			return _kubb_core.ast.collectImports({
 				node,
@@ -2006,8 +2016,5 @@ exports.HttpMethods = HttpMethods;
 exports.adapterOas = adapterOas;
 exports.adapterOasName = adapterOasName;
 exports.mergeDocuments = mergeDocuments;
-exports.parseDocument = parseDocument;
-exports.parseFromConfig = parseFromConfig;
-exports.validateDocument = validateDocument;
 
 //# sourceMappingURL=index.cjs.map