swagger-typescript-api 13.9.3 → 13.11.0

package/dist/{src-D2qG03ZJ.mjs → src-CxQXlsuV.mjs}

@@ -169,7 +169,7 @@ var ComponentTypeNameResolver = class extends NameResolver {
 //#endregion
 //#region package.json
 var name = "swagger-typescript-api";
-var version = "13.9.3";
+var version = "13.11.0";
 var description = "Generate the API client for Fetch or Axios from an OpenAPI Specification";
 //#endregion
 //#region src/constants.ts
@@ -263,6 +263,7 @@ const TsKeyword = {
 	Date: "Date",
 	Type: "type",
 	Enum: "enum",
+	Const: "const",
 	Interface: "interface",
 	Array: "Array",
 	Record: "Record",
@@ -282,7 +283,9 @@ var CodeGenConfig = class {
 	generateRouteTypes = false;
 	/** CLI flag */
 	generateClient = true;
-	/** CLI flag */
+	/** CLI flag. Controls enum output format: "enum" (default), "union" (T1 | T2 | TN), or "const" (as const object + type alias). */
+	enumStyle = "enum";
+	/** @deprecated Use enumStyle: "union" instead */
 	generateUnionEnums = false;
 	/** CLI flag */
 	addReadonly = false;
@@ -372,6 +375,7 @@ var CodeGenConfig = class {
 	enumKeyPrefix = "";
 	enumKeySuffix = "";
 	patch = false;
+	preferExistingSchemaNamesForExternalRefs = false;
 	componentTypeNameResolver;
 	/** name of the main exported class */
 	apiClassName = "Api";
@@ -653,6 +657,10 @@ var CodeGenConfig = class {
 	update = (update) => {
 		objectAssign(this, update);
 		if (this.enumNamesAsValues) this.extractEnums = true;
+		if (this.generateUnionEnums) {
+			consola$1.warn("`generateUnionEnums` is deprecated. Use `enumStyle: \"union\"` instead.");
+			if (this.enumStyle === "enum") this.enumStyle = "union";
+		}
 	};
 };
 //#endregion
@@ -662,6 +670,18 @@ function pascalCase(value) {
 }
 //#endregion
 //#region src/schema-components-map.ts
+const OPENAPI_COMPONENT_NAMES = new Set([
+	"schemas",
+	"responses",
+	"requestBodies",
+	"parameters",
+	"headers",
+	"securitySchemes",
+	"links",
+	"callbacks",
+	"examples",
+	"pathItems"
+]);
 var SchemaComponentsMap = class {
 	_data = [];
 	constructor(config) {
@@ -693,18 +713,49 @@ var SchemaComponentsMap = class {
 		});
 		return matchingComponents.length === 1 ? matchingComponents[0] : null;
 	}
+	normalizeTypeNameFromFile(typeName) {
+		return typeName.replace(/\.(yaml|yml|json)$/i, "");
+	}
+	resolveComponentName(rawComponentName) {
+		const normalizedComponentName = rawComponentName === "definitions" ? "schemas" : rawComponentName;
+		return OPENAPI_COMPONENT_NAMES.has(normalizedComponentName) ? normalizedComponentName : "schemas";
+	}
+	isFileOnlyRef(ref) {
+		const [, rawPointer = ""] = ref.split("#");
+		return !rawPointer.replace(/^\/+/, "");
+	}
+	unwrapExternalComponentsDocument(ref, resolved) {
+		if (!this.isFileOnlyRef(ref)) return null;
+		const schemas = resolved.components?.schemas;
+		if (!schemas || typeof schemas !== "object") return null;
+		const schemaEntries = Object.entries(schemas).filter(([, schemaData]) => schemaData != null && typeof schemaData === "object");
+		if (schemaEntries.length !== 1) return null;
+		const [schemaName, schemaData] = schemaEntries[0];
+		return {
+			ref: `${ref}#/components/schemas/${schemaName}`,
+			resolved: schemaData
+		};
+	}
+	isRefOnlyRawTypeData(rawTypeData) {
+		if (!rawTypeData || typeof rawTypeData !== "object") return false;
+		return Object.keys(rawTypeData).length === 1 && typeof rawTypeData.$ref === "string";
+	}
+	preferExistingSchemaNameForExternalRef(typeName, refDetails) {
+		if (!this.config.preferExistingSchemaNamesForExternalRefs) return false;
+		return pascalCase(refDetails.externalOpenapiFileName || "External") === typeName;
+	}
 	createComponentDraft($ref, rawTypeData) {
 		if (typeGuard.isObject(rawTypeData) && rawTypeData.typeName && rawTypeData.rawTypeData && rawTypeData.$ref) return rawTypeData;
 		const parsed = this.parseRef($ref);
 		const [, rawPointer = ""] = $ref.split("#");
 		const pointerParts = (rawPointer.startsWith("/") ? rawPointer : `/${rawPointer}`).split("/").filter(Boolean);
-		const typeName = pointerParts.at(-1) || parsed.at(-1) || "Unknown";
+		const typeName = this.normalizeTypeNameFromFile(pointerParts.at(-1) || parsed.at(-1) || "Unknown");
 		const rawComponentName = pointerParts.at(-2) || parsed[parsed.length - 2] || "schemas";
 		return {
 			$ref,
 			typeName,
 			rawTypeData,
-			componentName: rawComponentName === "definitions" ? "schemas" : rawComponentName,
+			componentName: this.resolveComponentName(rawComponentName),
 			/** result from schema parser */
 			typeData: null
 		};
@@ -724,6 +775,20 @@ var SchemaComponentsMap = class {
 	filter(...componentNames) {
 		return this._data.filter((it) => componentNames.some((componentName) => it.$ref.startsWith(`#/components/${componentName}`)));
 	}
+	resolveRefOnlyComponents() {
+		if (!this.config.preferExistingSchemaNamesForExternalRefs) return;
+		const { resolvedSwaggerSchema } = this.config;
+		for (const component of this._data) {
+			if (!this.isRefOnlyRawTypeData(component.rawTypeData)) continue;
+			const ref = component.rawTypeData?.$ref;
+			if (typeof ref !== "string") continue;
+			const resolved = resolvedSwaggerSchema.getRef(ref);
+			if (resolved == null || typeof resolved !== "object") continue;
+			component.rawTypeData = resolved;
+			component.typeData = null;
+			delete component.$prepared;
+		}
+	}
 	get = ($ref) => {
 		const localFound = this._data.find((c) => c.$ref === $ref) || this.getByLocalFragmentRef($ref) || null;
 		if (localFound != null) return localFound;
@@ -732,9 +797,24 @@ var SchemaComponentsMap = class {
 		const foundByRef = resolvedSwaggerSchema.getRef($ref);
 		const refDetails = resolvedSwaggerSchema.getRefDetails($ref);
 		if (foundByRef != null) {
-			const componentDraft = this.createComponentDraft($ref, foundByRef);
+			let resolvedRef = $ref;
+			let resolvedTypeData = foundByRef;
+			const unwrappedComponentsDocument = this.unwrapExternalComponentsDocument($ref, resolvedTypeData);
+			if (unwrappedComponentsDocument) {
+				resolvedRef = unwrappedComponentsDocument.ref;
+				resolvedTypeData = unwrappedComponentsDocument.resolved;
+			}
+			const componentDraft = this.createComponentDraft(resolvedRef, resolvedTypeData);
 			componentDraft.typeName = this.config.hooks.onFormatExternalTypeName?.(componentDraft.typeName, refDetails) || componentDraft.typeName;
-			if (this._data.some((component) => component.typeName === componentDraft.typeName)) componentDraft.typeName = this.config.hooks.onFixDuplicateExternalTypeName?.(componentDraft.typeName, refDetails, this._data.map((it) => it.typeName)) ?? `${pascalCase(refDetails.externalOpenapiFileName || "External")}${componentDraft.typeName}`;
+			if (this._data.some((component) => component.typeName === componentDraft.typeName)) {
+				if (this.preferExistingSchemaNameForExternalRef(componentDraft.typeName, refDetails)) {
+					const existingComponent = this._data.find((component) => component.typeName === componentDraft.typeName);
+					if (existingComponent) return existingComponent;
+				}
+				componentDraft.typeName = this.config.hooks.onFixDuplicateExternalTypeName?.(componentDraft.typeName, refDetails, this._data.map((it) => it.typeName)) ?? `${pascalCase(refDetails.externalOpenapiFileName || "External")}${componentDraft.typeName}`;
+			}
+			const existingComponent = this._data.find((component) => component.componentName === componentDraft.componentName && component.typeName === componentDraft.typeName);
+			if (existingComponent) return existingComponent;
 			return this.createComponent($ref, componentDraft);
 		}
 		return null;
@@ -767,7 +847,12 @@ var SchemaFormatters = class {
 	}
 	base = {
 		[SCHEMA_TYPES$1.ENUM]: (parsedSchema) => {
-			if (this.config.generateUnionEnums) return {
+			if (this.config.enumStyle === "const") return {
+				...parsedSchema,
+				$content: parsedSchema.content,
+				content: parsedSchema.content.map(({ key, value }) => `  ${key}: ${value}`).join(",\n")
+			};
+			if (this.config.enumStyle === "union") return {
 				...parsedSchema,
 				$content: parsedSchema.content,
 				content: this.config.Ts.UnionType(parsedSchema.content.map(({ value }) => value))
@@ -1045,7 +1130,7 @@ var DiscriminatorSchemaParser = class extends MonoSchemaParser {
 			const enumEntries = (parsedEnum.enum || []).map((key, index) => [key, index]);
 			for (const [key, index] of enumEntries) {
 				const enumContent = parsedEnum.content?.[index];
-				if (this.config.generateUnionEnums) {
+				if (this.config.enumStyle === "union" || this.config.enumStyle === "const") {
 					const literalValue = enumContent?.value ?? (key !== void 0 ? ts.StringValue(key) : void 0);
 					if (literalValue !== void 0) mappingPropertySchemaEnumKeysMap[key] = literalValue;
 				} else if (parsedEnum.typeName && enumContent?.key) mappingPropertySchemaEnumKeysMap[key] = ts.EnumUsageKey(parsedEnum.typeName, enumContent.key);
@@ -1206,7 +1291,7 @@ var EnumSchemaParser = class extends MonoSchemaParser {
 			schemaType: SCHEMA_TYPES$1.ENUM,
 			type: SCHEMA_TYPES$1.ENUM,
 			keyType,
-			typeIdentifier: this.config.generateUnionEnums ? this.config.Ts.Keyword.Type : this.config.Ts.Keyword.Enum,
+			typeIdentifier: this.config.enumStyle === "const" ? this.config.Ts.Keyword.Const : this.config.enumStyle === "union" ? this.config.Ts.Keyword.Type : this.config.Ts.Keyword.Enum,
 			name: this.typeName,
 			description: this.schemaFormatters.formatDescription(this.schema.description),
 			content
@@ -2378,6 +2463,7 @@ var SchemaRoutes = class {
 				security: hasSecurity,
 				method,
 				requestParams: requestParamsSchema,
+				requestParamsOptional: requestParamsSchema?.typeData?.allFieldsAreOptional ?? false,
 				payload: specificArgs.body,
 				query: specificArgs.query,
 				pathParams: specificArgs.pathParams,
@@ -3536,6 +3622,7 @@ var CodeGenProcess = class {
 		]), rawTypeData);
 		this.schemaComponentsMap.discriminatorsFirst();
 		this.schemaComponentsMap.enumsFirst();
+		this.schemaComponentsMap.resolveRefOnlyComponents();
 		const componentsToParse = this.schemaComponentsMap.filter(compact(["schemas", this.config.extractResponses && "responses"]));
 		this.typeNameFormatter.precommit(componentsToParse.map((c) => c.typeName));
 		const parsedSchemas = componentsToParse.map((schemaComponent) => {
@@ -3627,9 +3714,17 @@ var CodeGenProcess = class {
 		while (processedCount < schemaComponentsCount) {
 			modelTypes = [];
 			processedCount = 0;
+			const seenExportNames = /* @__PURE__ */ new Set();
 			for (const component of components) if (modelTypeComponents.includes(component.componentName)) {
 				const modelType = this.prepareModelType(component);
-				if (modelType) modelTypes.push(modelType);
+				if (modelType) {
+					if (seenExportNames.has(modelType.name)) {
+						processedCount++;
+						continue;
+					}
+					seenExportNames.add(modelType.name);
+					modelTypes.push(modelType);
+				}
 				processedCount++;
 			}
 			schemaComponentsCount = getSchemaComponentsCount();
@@ -3930,4 +4025,4 @@ async function generateApi(config) {
 //#endregion
 export { SCHEMA_TYPES as a, constants_exports as c, version as d, RequestContentKind as i, description as l, generateTemplates as n, CodeGenConfig as o, TemplatesGenConfig as r, HTTP_CLIENT as s, generateApi as t, name as u };
 
-//# sourceMappingURL=src-D2qG03ZJ.mjs.map
+//# sourceMappingURL=src-CxQXlsuV.mjs.map