@kubb/adapter-oas 5.0.0-beta.58 → 5.0.0-beta.59

package/dist/index.cjs

@@ -114,7 +114,7 @@ const structuralKeys = new Set([
 *
 * Only formats whose AST type differs from the OAS `type` field appear here.
 * Formats that depend on runtime options (`int64`, `date-time`, `date`, `time`) are handled separately
-* in the parser. `ipv4` and `ipv6` map to their own dedicated schema types; `hostname` and
+* in the parser. `ipv4` and `ipv6` map to their own dedicated schema types. `hostname` and
 * `idn-hostname` map to `'url'` as the closest generic string-format type.
 *
 * @example
@@ -167,8 +167,8 @@ const formatMap = {
 */
 const enumExtensionKeys = ["x-enumNames", "x-enum-varnames"];
 /**
-* Maps `'any' | 'unknown' | 'void'` option strings to their `ScalarSchemaType` constant.
-* Replaces a plain object lookup with a `Map` for explicit key membership testing via `.has()`.
+* Maps the `unknownType`/`emptySchemaType` option string to its `ScalarSchemaType` constant.
+* A `Map` (over a plain object) lets callers test key membership with `.has()`.
 */
 const typeOptionMap = new Map([
 	["any", _kubb_core.ast.schemaTypes.any],
@@ -863,6 +863,120 @@ const oasDialect = _kubb_core.ast.defineSchemaDialect({
 	resolveRef
 });
 //#endregion
+//#region src/discriminator.ts
+/**
+* Builds a map of child schema names → discriminator patch data by scanning the given
+* top-level AST schema nodes for union schemas that carry a `discriminatorPropertyName`.
+*
+* The streaming path calls this on a small pre-parsed subset of schemas (only the
+* discriminator parents) rather than on all schemas at once.
+*/
+function buildDiscriminatorChildMap(schemas) {
+	const childMap = /* @__PURE__ */ new Map();
+	for (const schema of schemas) {
+		let unionNode = _kubb_core.ast.narrowSchema(schema, "union");
+		if (!unionNode) {
+			const intersectionMembers = _kubb_core.ast.narrowSchema(schema, "intersection")?.members;
+			if (intersectionMembers) for (const m of intersectionMembers) {
+				const u = _kubb_core.ast.narrowSchema(m, "union");
+				if (u) {
+					unionNode = u;
+					break;
+				}
+			}
+		}
+		if (!unionNode?.discriminatorPropertyName || !unionNode.members) continue;
+		const { discriminatorPropertyName, members } = unionNode;
+		for (const member of members) {
+			const intersectionNode = _kubb_core.ast.narrowSchema(member, "intersection");
+			if (!intersectionNode?.members) continue;
+			let refNode = null;
+			let objNode = null;
+			for (const m of intersectionNode.members) {
+				refNode ??= _kubb_core.ast.narrowSchema(m, "ref");
+				objNode ??= _kubb_core.ast.narrowSchema(m, "object");
+			}
+			if (!refNode?.name || !objNode) continue;
+			const prop = objNode.properties.find((p) => p.name === discriminatorPropertyName);
+			const enumNode = prop ? _kubb_core.ast.narrowSchema(prop.schema, "enum") : null;
+			if (!enumNode?.enumValues?.length) continue;
+			const enumValues = enumNode.enumValues.filter((v) => v !== null);
+			if (!enumValues.length) continue;
+			const existing = childMap.get(refNode.name);
+			if (!existing) {
+				childMap.set(refNode.name, {
+					propertyName: discriminatorPropertyName,
+					enumValues: [...enumValues]
+				});
+				continue;
+			}
+			existing.enumValues.push(...enumValues);
+		}
+	}
+	return childMap;
+}
+/**
+* Patches a single top-level `SchemaNode` with its discriminator entry (adds or replaces
+* the discriminant property). Used by the streaming path to apply patches inline per yield
+* without buffering all schemas.
+*/
+function patchDiscriminatorNode(node, entry) {
+	const objectNode = _kubb_core.ast.narrowSchema(node, "object");
+	if (!objectNode) return node;
+	const { propertyName, enumValues } = entry;
+	const enumSchema = _kubb_core.ast.factory.createSchema({
+		type: "enum",
+		enumValues
+	});
+	const newProp = _kubb_core.ast.factory.createProperty({
+		name: propertyName,
+		required: true,
+		schema: enumSchema
+	});
+	const existingIdx = objectNode.properties.findIndex((p) => p.name === propertyName);
+	const newProperties = existingIdx >= 0 ? objectNode.properties.map((p, i) => i === existingIdx ? newProp : p) : [...objectNode.properties, newProp];
+	return {
+		...objectNode,
+		properties: newProperties
+	};
+}
+/**
+* Creates a single-property object schema used as a discriminator literal.
+*
+* @example
+* ```ts
+* createDiscriminantNode({ propertyName: 'type', value: 'dog' })
+* // -> { type: 'object', properties: [{ name: 'type', required: true, schema: enum('dog') }] }
+* ```
+*/
+function createDiscriminantNode({ propertyName, value }) {
+	return _kubb_core.ast.factory.createSchema({
+		type: "object",
+		primitive: "object",
+		properties: [_kubb_core.ast.factory.createProperty({
+			name: propertyName,
+			schema: _kubb_core.ast.factory.createSchema({
+				type: "enum",
+				primitive: "string",
+				enumValues: [value]
+			}),
+			required: true
+		})]
+	});
+}
+/**
+* Returns the discriminator key whose mapping value matches `ref`, or `null` when there is no match.
+*
+* @example
+* ```ts
+* findDiscriminator({ dog: '#/components/schemas/Dog' }, '#/components/schemas/Dog') // 'dog'
+* ```
+*/
+function findDiscriminator(mapping, ref) {
+	if (!mapping || !ref) return null;
+	return Object.entries(mapping).find(([, value]) => value === ref)?.[0] ?? null;
+}
+//#endregion
 //#region src/mime.ts
 /**
 * MIME type fragments that mark a media type as JSON-like.
@@ -1351,7 +1465,7 @@ function getSchemas(document, { contentType }) {
 }
 /**
 * Resolves the AST type descriptor for a date/time format, honoring the `dateType` option.
-* Returns `null` when `dateType: false`, signalling the format should fall through to `string`.
+* Returns `null` when `dateType: false`, so the format falls through to `string`.
 */
 function getDateType(options, format) {
 	if (!options.dateType) return null;
@@ -1453,9 +1567,9 @@ function getResponseBodyContentTypes(document, operation, statusCode) {
 * Normalizes malformed `{ type: 'array', enum: [...] }` schemas by moving enum values into items.
 *
 * This pattern violates the OpenAPI spec but appears in real specs. The fix moves enum values
-* from the array to its items sub-schema, making them valid for downstream processing.
+* from the array to its items sub-schema, so they are valid for downstream processing.
 *
-* @note This is a defensive measure for robustness with non-compliant specs.
+* @note A defensive measure for non-compliant specs.
 */
 function normalizeArrayEnum(schema) {
 	const normalizedItems = {
@@ -1473,7 +1587,7 @@ function normalizeArrayEnum(schema) {
 *
 * Returns closures that share mutable state (`resolvingRefs` set for cycle detection).
 * Each converter branch (`convertRef`, `convertAllOf`, etc.) mutually recursively calls `parseSchema`,
-* made possible by hoisting of function declarations.
+* which works because function declarations hoist.
 *
 * @internal
 */
@@ -1565,7 +1679,7 @@ function createSchemaParser(ctx, dialect = oasDialect) {
 			const inOneOf = parentUnion.some((oneOfItem) => dialect.isReference(oneOfItem) && oneOfItem.$ref === childRef);
 			const inMapping = Object.values(deref.discriminator.mapping ?? {}).some((v) => v === childRef);
 			if (inOneOf || inMapping) {
-				const discriminatorValue = (0, _kubb_ast_utils.findDiscriminator)(deref.discriminator.mapping, childRef);
+				const discriminatorValue = findDiscriminator(deref.discriminator.mapping, childRef);
 				if (discriminatorValue) filteredDiscriminantValues.push({
 					propertyName: deref.discriminator.propertyName,
 					value: discriminatorValue
@@ -1603,7 +1717,7 @@ function createSchemaParser(ctx, dialect = oasDialect) {
 			const { allOf: _allOf, ...schemaWithoutAllOf } = schema;
 			allOfMembers.push(parseSchema({ schema: schemaWithoutAllOf }, rawOptions));
 		}
-		for (const { propertyName, value } of filteredDiscriminantValues) allOfMembers.push(_kubb_core.ast.factory.createDiscriminantNode({
+		for (const { propertyName, value } of filteredDiscriminantValues) allOfMembers.push(createDiscriminantNode({
 			propertyName,
 			value
 		}));
@@ -1644,7 +1758,7 @@ function createSchemaParser(ctx, dialect = oasDialect) {
 		if (sharedPropertiesNode || discriminator?.mapping) {
 			const members = unionMembers.map((s) => {
 				const ref = dialect.isReference(s) ? s.$ref : void 0;
-				const discriminatorValue = (0, _kubb_ast_utils.findDiscriminator)(discriminator?.mapping, ref);
+				const discriminatorValue = findDiscriminator(discriminator?.mapping, ref);
 				const memberNode = parseSchema({
 					schema: s,
 					name
@@ -1657,7 +1771,7 @@ function createSchemaParser(ctx, dialect = oasDialect) {
 				}), discriminator.propertyName) : void 0;
 				return _kubb_core.ast.factory.createSchema({
 					type: "intersection",
-					members: [memberNode, narrowedDiscriminatorNode ?? _kubb_core.ast.factory.createDiscriminantNode({
+					members: [memberNode, narrowedDiscriminatorNode ?? createDiscriminantNode({
 						propertyName: discriminator.propertyName,
 						value: discriminatorValue
 					})]
@@ -2312,84 +2426,6 @@ function createSchemaParser(ctx, dialect = oasDialect) {
 	};
 }
 //#endregion
-//#region src/discriminator.ts
-/**
-* Builds a map of child schema names → discriminator patch data by scanning the given
-* top-level AST schema nodes for union schemas that carry a `discriminatorPropertyName`.
-*
-* The streaming path calls this on a small pre-parsed subset of schemas (only the
-* discriminator parents) rather than on all schemas at once.
-*/
-function buildDiscriminatorChildMap(schemas) {
-	const childMap = /* @__PURE__ */ new Map();
-	for (const schema of schemas) {
-		let unionNode = _kubb_core.ast.narrowSchema(schema, "union");
-		if (!unionNode) {
-			const intersectionMembers = _kubb_core.ast.narrowSchema(schema, "intersection")?.members;
-			if (intersectionMembers) for (const m of intersectionMembers) {
-				const u = _kubb_core.ast.narrowSchema(m, "union");
-				if (u) {
-					unionNode = u;
-					break;
-				}
-			}
-		}
-		if (!unionNode?.discriminatorPropertyName || !unionNode.members) continue;
-		const { discriminatorPropertyName, members } = unionNode;
-		for (const member of members) {
-			const intersectionNode = _kubb_core.ast.narrowSchema(member, "intersection");
-			if (!intersectionNode?.members) continue;
-			let refNode = null;
-			let objNode = null;
-			for (const m of intersectionNode.members) {
-				refNode ??= _kubb_core.ast.narrowSchema(m, "ref");
-				objNode ??= _kubb_core.ast.narrowSchema(m, "object");
-			}
-			if (!refNode?.name || !objNode) continue;
-			const prop = objNode.properties.find((p) => p.name === discriminatorPropertyName);
-			const enumNode = prop ? _kubb_core.ast.narrowSchema(prop.schema, "enum") : null;
-			if (!enumNode?.enumValues?.length) continue;
-			const enumValues = enumNode.enumValues.filter((v) => v !== null);
-			if (!enumValues.length) continue;
-			const existing = childMap.get(refNode.name);
-			if (!existing) {
-				childMap.set(refNode.name, {
-					propertyName: discriminatorPropertyName,
-					enumValues: [...enumValues]
-				});
-				continue;
-			}
-			existing.enumValues.push(...enumValues);
-		}
-	}
-	return childMap;
-}
-/**
-* Patches a single top-level `SchemaNode` with its discriminator entry (adds or replaces
-* the discriminant property). Used by the streaming path to apply patches inline per yield
-* without buffering all schemas.
-*/
-function patchDiscriminatorNode(node, entry) {
-	const objectNode = _kubb_core.ast.narrowSchema(node, "object");
-	if (!objectNode) return node;
-	const { propertyName, enumValues } = entry;
-	const enumSchema = _kubb_core.ast.factory.createSchema({
-		type: "enum",
-		enumValues
-	});
-	const newProp = _kubb_core.ast.factory.createProperty({
-		name: propertyName,
-		required: true,
-		schema: enumSchema
-	});
-	const existingIdx = objectNode.properties.findIndex((p) => p.name === propertyName);
-	const newProperties = existingIdx >= 0 ? objectNode.properties.map((p, i) => i === existingIdx ? newProp : p) : [...objectNode.properties, newProp];
-	return {
-		...objectNode,
-		properties: newProperties
-	};
-}
-//#endregion
 //#region src/schemaDiagnostics.ts
 /**
 * Reports the advisory diagnostics (`KUBB_UNSUPPORTED_FORMAT`, `KUBB_DEPRECATED`) for one
@@ -2452,7 +2488,7 @@ function visit(node, pointer) {
 *
 * Only enums and objects are candidates, and object shapes that reference a circular schema are
 * rejected to avoid hoisting recursive structures. Inline shapes reuse their context-derived
-* name (collision-resolved against existing component names); shapes without a name stay inline.
+* name (collision-resolved against existing component names). Shapes without a name stay inline.
 */
 function createDedupePlan({ schemaNodes, operationNodes, schemaNames, circularNames }) {
 	const circularSchemas = new Set(circularNames);