From 34086f3014f827066d5a305913282d1187e9b57c Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Thu, 2 Oct 2025 12:24:16 -0400 Subject: [PATCH 1/2] document resolve-aliases --- fern/snippets/openapi-specs.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/fern/snippets/openapi-specs.mdx b/fern/snippets/openapi-specs.mdx index 7c364addb..a499101cb 100644 --- a/fern/snippets/openapi-specs.mdx +++ b/fern/snippets/openapi-specs.mdx @@ -117,3 +117,18 @@ api: Disabled by default to maintain backwards compatibility. + + + Inlines type aliases to simplify your generated SDK. When enabled, reduces unnecessary type definitions by replacing simple aliases with their underlying types directly. Useful for OpenAPI specs with many primitive or simple type aliases. + + You can preserve specific aliases by adding an `except` array listing the type names to keep as separate types. For example: + + ```yaml + settings: + resolve-aliases: + except: + - UserId + - OrganizationId + ``` + + From 04807cd686deb7bb41d8a44543507b2123fe1465 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Thu, 2 Oct 2025 12:33:58 -0400 Subject: [PATCH 2/2] clarify wording --- fern/snippets/openapi-specs.mdx | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/fern/snippets/openapi-specs.mdx b/fern/snippets/openapi-specs.mdx index a499101cb..cf0c84310 100644 --- a/fern/snippets/openapi-specs.mdx +++ b/fern/snippets/openapi-specs.mdx @@ -119,16 +119,23 @@ api: - Inlines type aliases to simplify your generated SDK. When enabled, reduces unnecessary type definitions by replacing simple aliases with their underlying types directly. Useful for OpenAPI specs with many primitive or simple type aliases. + Inlines type aliases to simplify your generated SDK. When enabled, reduces + unnecessary type definitions by replacing simple aliases with their underlying + types directly. Useful for OpenAPI specs with many primitive or simple type + aliases. - You can preserve specific aliases by adding an `except` array listing the type names to keep as separate types. For example: + Set to `true` to inline all aliases, or use an object with an `except` array + to preserve specific type aliases: ```yaml settings: + # Inline all aliases + resolve-aliases: true + + # Or preserve specific aliases resolve-aliases: except: - UserId - OrganizationId ``` -