@kubb/adapter-oas 5.0.0-alpha.8 → 5.0.0-alpha.9

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
 import * as _kubb_core0 from "@kubb/core";
 import { AdapterFactoryOptions } from "@kubb/core";
-import { DiscriminatorObject, OASDocument, SchemaObject } from "oas/types";
+import { DiscriminatorObject, OASDocument, ParameterObject, SchemaObject } from "oas/types";
 import BaseOas from "oas";
 import * as oas_normalize_lib_types0 from "oas-normalize/lib/types";
 import { Operation } from "oas/operation";
@@ -73,6 +73,15 @@ declare class Oas extends BaseOas {
   dereferenceWithRef<T = unknown>(schema?: T): T;
   getResponseSchema(operation: Operation$1, statusCode: string | number): SchemaObject$1;
   getRequestSchema(operation: Operation$1): SchemaObject$1 | undefined;
+  /**
+   * Returns all resolved parameters for an operation, merging path-level and operation-level
+   * parameters and deduplicating by `in:name` (operation-level takes precedence).
+   *
+   * oas v31+ filters out `$ref` parameters in `getParameters()`, so this method accesses the
+   * raw `operation.schema.parameters` and path-item parameters directly and resolves `$ref`
+   * pointers via `dereferenceWithRef` to preserve backward compatibility.
+   */
+  getParameters(operation: Operation$1): Array<ParameterObject>;
   getParametersSchema(operation: Operation$1, inKey: 'path' | 'query' | 'header'): SchemaObject$1 | null;
   validate(): Promise<oas_normalize_lib_types0.ValidationResult>;
   flattenSchema(schema: SchemaObject$1 | null): SchemaObject$1 | null;

package/dist/index.js

@@ -261,9 +261,8 @@ const formatMap = {
 };
 /**
 * Exhaustive list of media types that Kubb recognizes.
-* Kept as a module-level constant to avoid re-allocating the array on every call.
 */
-const knownMediaTypes = [
+const knownMediaTypes = new Set([
 	"application/json",
 	"application/xml",
 	"application/x-www-form-urlencoded",
@@ -283,12 +282,22 @@ const knownMediaTypes = [
 	"image/svg+xml",
 	"audio/mpeg",
 	"video/mp4"
-];
+]);
 /**
 * Vendor extension keys used to attach human-readable labels to enum values.
 * Checked in priority order: the first key found wins.
 */
 const enumExtensionKeys = ["x-enumNames", "x-enum-varnames"];
+/**
+* Scalar primitive schema types used for union member simplification.
+*/
+const SCALAR_PRIMITIVE_TYPES = new Set([
+	"string",
+	"number",
+	"integer",
+	"bigint",
+	"boolean"
+]);
 //#endregion
 //#region src/oas/Oas.ts
 /**
@@ -501,8 +510,15 @@ var Oas = class extends BaseOas {
 		if (!schema) return;
 		return this.dereferenceWithRef(schema);
 	}
-	getParametersSchema(operation, inKey) {
-		const { contentType = operation.getContentType() } = this.#options;
+	/**
+	* Returns all resolved parameters for an operation, merging path-level and operation-level
+	* parameters and deduplicating by `in:name` (operation-level takes precedence).
+	*
+	* oas v31+ filters out `$ref` parameters in `getParameters()`, so this method accesses the
+	* raw `operation.schema.parameters` and path-item parameters directly and resolves `$ref`
+	* pointers via `dereferenceWithRef` to preserve backward compatibility.
+	*/
+	getParameters(operation) {
 		const resolveParams = (params) => params.map((p) => this.dereferenceWithRef(p)).filter((p) => !!p && typeof p === "object" && "in" in p && "name" in p);
 		const operationParams = resolveParams(operation.schema?.parameters || []);
 		const pathItem = this.api?.paths?.[operation.path];
@@ -510,7 +526,11 @@ var Oas = class extends BaseOas {
 		const paramMap = /* @__PURE__ */ new Map();
 		for (const p of pathLevelParams) if (p.name && p.in) paramMap.set(`${p.in}:${p.name}`, p);
 		for (const p of operationParams) if (p.name && p.in) paramMap.set(`${p.in}:${p.name}`, p);
-		const params = Array.from(paramMap.values()).filter((v) => v.in === inKey);
+		return Array.from(paramMap.values());
+	}
+	getParametersSchema(operation, inKey) {
+		const { contentType = operation.getContentType() } = this.#options;
+		const params = this.getParameters(operation).filter((v) => v.in === inKey);
 		if (!params.length) return null;
 		return params.reduce((schema, pathParameters) => {
 			const property = pathParameters.content?.[contentType]?.schema ?? pathParameters.schema;
@@ -977,20 +997,19 @@ function mergeAdjacentAnonymousObjects(members) {
 *
 * Only scalar primitives (`string`, `number`, `integer`, `bigint`, `boolean`) are
 * considered — object, array, and ref members are left untouched.
+*
+* Const-derived enums (those without an `enumType`, produced from an OpenAPI `const`
+* keyword) are **never** removed — `'accepted' | string` must stay as-is because the
+* literal is intentional.
 */
 function simplifyUnionMembers(members) {
-	const scalarPrimitives = new Set(members.filter((m) => [
-		"string",
-		"number",
-		"integer",
-		"bigint",
-		"boolean"
-	].includes(m.type)).map((m) => m.type));
+	const scalarPrimitives = new Set(members.filter((m) => SCALAR_PRIMITIVE_TYPES.has(m.type)).map((m) => m.type));
 	if (!scalarPrimitives.size) return members;
 	return members.filter((m) => {
 		if (m.type !== "enum") return true;
 		const prim = m.primitive;
 		if (!prim) return true;
+		if (!m.enumType) return true;
 		if (scalarPrimitives.has(prim)) return false;
 		if ((prim === "integer" || prim === "number") && (scalarPrimitives.has("integer") || scalarPrimitives.has("number"))) return false;
 		return true;
@@ -1065,7 +1084,7 @@ function getPrimitiveType(type) {
 * Returns `undefined` for content types not present in `KNOWN_MEDIA_TYPES`.
 */
 function toMediaType(contentType) {
-	return knownMediaTypes.includes(contentType) ? contentType : void 0;
+	return knownMediaTypes.has(contentType) ? contentType : void 0;
 }
 /**
 * Creates an OAS parser that converts an OpenAPI/Swagger spec into
@@ -1710,6 +1729,7 @@ function createOasParser(oas, { contentType, collisionDetection } = {}) {
 			in: param["in"],
 			schema: {
 				...schema,
+				description: param["description"] ?? schema.description,
 				optional: !required || !!schema.optional ? true : void 0
 			},
 			required
@@ -1720,15 +1740,13 @@ function createOasParser(oas, { contentType, collisionDetection } = {}) {
 	* request body, and all response codes into their AST node equivalents.
 	*/
 	function parseOperation(options, oas, operation) {
-		const parameters = operation.getParameters().map((param) => {
-			return parseParameter(options, oas.dereferenceWithRef(param));
-		});
+		const parameters = oas.getParameters(operation).map((param) => parseParameter(options, param));
 		const requestBodySchema = oas.getRequestSchema(operation);
 		const requestBody = requestBodySchema ? convertSchema({ schema: requestBodySchema }, options) : void 0;
 		const responses = operation.getResponseStatusCodes().map((statusCode) => {
 			const responseObj = operation.getResponseByStatusCode(statusCode);
 			const responseSchema = oas.getResponseSchema(operation, statusCode);
-			const schema = responseSchema && Object.keys(responseSchema).length > 0 ? convertSchema({ schema: responseSchema }, options) : void 0;
+			const schema = responseSchema && Object.keys(responseSchema).length > 0 ? convertSchema({ schema: responseSchema }, options) : createSchema({ type: resolveTypeOption(options.emptySchemaType) });
 			const description = typeof responseObj === "object" && responseObj !== null && !Array.isArray(responseObj) ? responseObj.description : void 0;
 			const rawContent = typeof responseObj === "object" && responseObj !== null && !Array.isArray(responseObj) ? responseObj.content : void 0;
 			return createResponse({