feat(cli): Add OpenAPI tree-shaking setting

fern/apis/generators-yml/definition/generators.yml

@@ -135,6 +135,9 @@ types:
       message-naming:
         type: optional<MessageNamingSettingsSchema>
         docs: What version of message naming to use for AsyncAPI messages, this will grow over time. Defaults to v1.
+      only-include-referenced-schemas:
+        type: optional<boolean>
+        docs: Whether to only include schemas referenced by endpoints in the generated SDK (i.e. a form of tree-shaking). Defaults to false.
 
   UnionSettingsSchema:
     enum: 
@@ -222,6 +225,9 @@ types:
       respect-readonly-schemas:
         type: optional<boolean>
         docs: Enables exploring readonly schemas in OpenAPI specifications
+      only-include-referenced-schemas:
+        type: optional<boolean>
+        docs: Whether to only include schemas referenced by endpoints in the generated SDK (i.e. a form of tree-shaking). Defaults to false.
 
   OpenAPISpecSchema:
     properties:

generators-yml.schema.json

@@ -633,6 +633,16 @@
               "type": "null"
             }
           ]
+        },
+        "only-include-referenced-schemas": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "additionalProperties": false
@@ -1294,6 +1304,16 @@
               "type": "null"
             }
           ]
+        },
+        "only-include-referenced-schemas": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "additionalProperties": false

packages/cli/api-importers/openapi/openapi-ir-parser/src/options.ts

@@ -15,6 +15,8 @@ export interface ParseOpenAPIOptions {
     cooerceEnumsToLiterals: boolean;
     /* Whether or not to respect readonly properties in schemas */
     respectReadonlySchemas: boolean;
+    /* Whether or not to only include endpoint referenced schemas */
+    onlyIncludeReferencedSchemas: boolean;
 }
 
 export const DEFAULT_PARSE_OPENAPI_SETTINGS: ParseOpenAPIOptions = {
@@ -24,5 +26,6 @@ export const DEFAULT_PARSE_OPENAPI_SETTINGS: ParseOpenAPIOptions = {
     audiences: undefined,
     optionalAdditionalProperties: true,
     cooerceEnumsToLiterals: true,
-    respectReadonlySchemas: false
+    respectReadonlySchemas: false,
+    onlyIncludeReferencedSchemas: false
 };

packages/cli/api-importers/openapi/openapi-ir-parser/src/parse.ts

@@ -30,6 +30,7 @@ export interface SpecImportSettings {
     cooerceEnumsToLiterals: boolean;
     objectQueryParameters: boolean;
     respectReadonlySchemas: boolean;
+    onlyIncludeReferencedSchemas: boolean;
 }
 
 export type Source = AsyncAPISource | OpenAPISource | ProtobufSource;
@@ -196,7 +197,11 @@ function getParseOptions({
         respectReadonlySchemas:
             overrides?.respectReadonlySchemas ??
             specSettings?.respectReadonlySchemas ??
-            DEFAULT_PARSE_OPENAPI_SETTINGS.respectReadonlySchemas
+            DEFAULT_PARSE_OPENAPI_SETTINGS.respectReadonlySchemas,
+        onlyIncludeReferencedSchemas:
+            overrides?.onlyIncludeReferencedSchemas ??
+            specSettings?.onlyIncludeReferencedSchemas ??
+            DEFAULT_PARSE_OPENAPI_SETTINGS.onlyIncludeReferencedSchemas
     };
 }