@kubb/adapter-oas 5.4.3 → 5.5.0

package/dist/index.cjs

@@ -1274,6 +1274,73 @@ function extractDiscriminatedAllOfMembers({ allOfMembers, name, refs }) {
 	};
 }
 //#endregion
+//#region src/emit/converters/annotatedEnum.ts
+const ANNOTATIONS = /* @__PURE__ */ new Set([
+	"title",
+	"description",
+	"default",
+	"deprecated",
+	"readOnly",
+	"writeOnly",
+	"example",
+	"examples",
+	"xml",
+	"externalDocs"
+]);
+const UNION_KEYS = /* @__PURE__ */ new Set([
+	...ANNOTATIONS,
+	"type",
+	"nullable",
+	"oneOf",
+	"anyOf"
+]);
+const MEMBER_KEYS = /* @__PURE__ */ new Set([
+	...ANNOTATIONS,
+	"type",
+	"const"
+]);
+function hasOnlyKeys(schema, keys) {
+	return typeof schema === "object" && schema !== null && !Array.isArray(schema) && Object.keys(schema).every((key) => keys.has(key) || key.startsWith("x-"));
+}
+function matchesType(type, value) {
+	return type === void 0 || type === typeof value || type === "integer" && typeof value === "number" && Number.isInteger(value);
+}
+/** Recognizes annotated const unions only when replacing them cannot discard validation constraints. */
+function convertAnnotatedEnum(context) {
+	const { schema, document } = context;
+	if (!document.openapi?.startsWith("3.1.")) return void 0;
+	if (!hasOnlyKeys(schema, UNION_KEYS) || schema.oneOf !== void 0 && schema.anyOf !== void 0) return void 0;
+	const members = schema.oneOf ?? schema.anyOf;
+	if (!members?.length) return void 0;
+	const names = /* @__PURE__ */ new Set();
+	const values = /* @__PURE__ */ new Set();
+	const namedEnumValues = [];
+	let primitive;
+	for (const member of members) {
+		if (!hasOnlyKeys(member, MEMBER_KEYS)) return void 0;
+		const value = member.const;
+		if (typeof value !== "string" && (typeof value !== "number" || !Number.isFinite(value))) return void 0;
+		if (typeof member.title !== "string" || !member.title.trim() || names.has(member.title) || values.has(value)) return void 0;
+		if (!matchesType(schema.type, value) || !matchesType(member.type, value)) return void 0;
+		const valueType = typeof value === "number" ? "number" : "string";
+		if (primitive !== void 0 && primitive !== valueType) return void 0;
+		primitive = valueType;
+		names.add(member.title);
+		values.add(value);
+		namedEnumValues.push({
+			name: member.title,
+			value,
+			primitive: valueType,
+			description: member.description
+		});
+	}
+	return createNode(context, {
+		type: "enum",
+		primitive,
+		namedEnumValues
+	});
+}
+//#endregion
 //#region src/emit/converters/composition.ts
 /**
 * Converts a `$ref` schema into a `RefSchemaNode`.
@@ -1386,7 +1453,10 @@ function convertAllOf({ schema, name, nullable, defaultValue, rawOptions, parse,
 /**
 * Converts a `oneOf` / `anyOf` schema into a `UnionSchemaNode`.
 */
-function convertUnion({ schema, name, nullable, defaultValue, rawOptions, parse, refs }) {
+function convertUnion(context) {
+	const annotatedEnum = convertAnnotatedEnum(context);
+	if (annotatedEnum) return annotatedEnum;
+	const { schema, name, nullable, defaultValue, rawOptions, parse, refs } = context;
 	const ctx = {
 		schema,
 		name,
@@ -1539,9 +1609,7 @@ function convertFormat(context) {
 	if (schema.format === "int64" || schema.format === "uint64") return createNode(ctx, {
 		type: options.integerType === "bigint" ? "bigint" : "integer",
 		primitive: "integer",
-		min: schema.minimum,
-		max: schema.maximum,
-		...getExclusiveBounds(schema)
+		...getNumericConstraints(schema)
 	});
 	if (schema.format === "date-time" || schema.format === "date" || schema.format === "time") {
 		const dateType = getDateType(options, schema.format);
@@ -1558,13 +1626,15 @@ function convertFormat(context) {
 		});
 	}
 	const specialType = getSchemaType(schema.format);
+	const isNumeric = specialType === "number" || specialType === "integer" || specialType === "bigint";
 	return createNode(ctx, {
-		primitive: specialType === "number" || specialType === "integer" || specialType === "bigint" ? specialType : "string",
+		primitive: isNumeric ? specialType : "string",
 		type: specialType,
 		...specialType === "url" || specialType === "uuid" || specialType === "email" ? {
 			min: schema.minLength,
 			max: schema.maxLength
-		} : {}
+		} : {},
+		...isNumeric ? getNumericConstraints(schema) : {}
 	});
 }
 /**
@@ -1641,6 +1711,18 @@ function convertString({ schema, name, nullable, defaultValue }) {
 	});
 }
 /**
+* Reads the numeric constraints shared by every `number`, `integer` and `bigint` node. A `format`
+* such as `double` or `int32` only narrows the type, so formatted numbers keep these too.
+*/
+function getNumericConstraints(schema) {
+	return {
+		min: schema.minimum,
+		max: schema.maximum,
+		...getExclusiveBounds(schema),
+		multipleOf: schema.multipleOf
+	};
+}
+/**
 * Converts a `type: 'number'` or `type: 'integer'` schema.
 */
 function convertNumeric({ schema, name, nullable, defaultValue }, type) {
@@ -1652,10 +1734,7 @@ function convertNumeric({ schema, name, nullable, defaultValue }, type) {
 	}, {
 		type,
 		primitive: type,
-		min: schema.minimum,
-		max: schema.maximum,
-		...getExclusiveBounds(schema),
-		multipleOf: schema.multipleOf
+		...getNumericConstraints(schema)
 	});
 }
 /**