@fern-api/fern-api-dev 5.118.0 → 5.119.1

package/cli.cjs

@@ -118484,6 +118484,7 @@ var init_DocsYmlSchemas = __esm({
       "mobile-toc": external_exports.boolean().optional(),
       "changelog-layout": ChangelogLayout.optional(),
       "api-reference-layout": ApiReferenceLayout.optional(),
+      "api-reference-expand-properties": external_exports.boolean().optional(),
       "show-nav-availability-badges": external_exports.boolean().optional()
     });
     SearchSettingsConfig = external_exports.object({
@@ -124182,6 +124183,7 @@ var init_LayoutConfig2 = __esm({
       mobileToc: schemas_exports6.property("mobile-toc", schemas_exports6.boolean().optional()),
       changelogLayout: schemas_exports6.property("changelog-layout", ChangelogLayout3.optional()),
       apiReferenceLayout: schemas_exports6.property("api-reference-layout", ApiReferenceLayout3.optional()),
+      apiReferenceExpandProperties: schemas_exports6.property("api-reference-expand-properties", schemas_exports6.boolean().optional()),
       showNavAvailabilityBadges: schemas_exports6.property("show-nav-availability-badges", schemas_exports6.boolean().optional())
     });
   }
@@ -238684,6 +238686,10 @@ function convertLayoutConfig(layout, themeTabsAlignment, themeTabsPlacement) {
     // by the fern-platform companion PR. Part of the `as unknown as` cast
     // below until the published FDR SDK adds `apiReferenceLayout`.
     apiReferenceLayout: layout.apiReferenceLayout,
+    // Opt-in (default off, resolved by the fern-platform companion PR): when
+    // true the first level of nested API reference fields renders expanded.
+    // Part of the `as unknown as` cast below until the published FDR SDK adds the field.
+    apiReferenceExpandProperties: layout.apiReferenceExpandProperties,
     // Opt-in (default off, resolved by the fern-platform companion PR):
     // when true the sidebar renders inline availability badges. Part of the
     // `as unknown as` cast below until the published FDR SDK adds the field.
@@ -353911,7 +353917,8 @@ var init_AbstractParameterConverter = __esm({
                 clientDefault: void 0,
                 defaultValue: parameterDefaultValue,
                 v2Examples: this.convertParameterExamples({
-                  schema: parameterSchemaWithExampleOverride ?? schema
+                  schema: parameterSchemaWithExampleOverride ?? schema,
+                  originalSchema: schema
                 }),
                 availability,
                 explode: this.getExplodeForQueryParameter()
@@ -353932,7 +353939,8 @@ var init_AbstractParameterConverter = __esm({
                 clientDefault: void 0,
                 defaultValue: parameterDefaultValue,
                 v2Examples: this.convertParameterExamples({
-                  schema: parameterSchemaWithExampleOverride ?? schema
+                  schema: parameterSchemaWithExampleOverride ?? schema,
+                  originalSchema: schema
                 }),
                 availability
               },
@@ -353949,7 +353957,8 @@ var init_AbstractParameterConverter = __esm({
                 variable: void 0,
                 clientDefault: void 0,
                 v2Examples: this.convertParameterExamples({
-                  schema: parameterSchemaWithExampleOverride ?? schema
+                  schema: parameterSchemaWithExampleOverride ?? schema,
+                  originalSchema: schema
                 }),
                 explode: this.getExplodeForPathParameter()
               },
@@ -353985,7 +353994,7 @@ var init_AbstractParameterConverter = __esm({
         }
         return schema;
       }
-      convertParameterExamples({ schema }) {
+      convertParameterExamples({ schema, originalSchema }) {
         const v2Examples = {
           userSpecifiedExamples: {},
           autogeneratedExamples: {}
@@ -354013,6 +354022,23 @@ var init_AbstractParameterConverter = __esm({
             exampleName: parameterExampleName
           });
         }
+        if (Object.keys(v2Examples.userSpecifiedExamples).length === 0) {
+          const schemaExamples = this.context.getExamplesFromSchema({
+            schema: this.resolveSchemaChain(originalSchema),
+            breadcrumbs: this.breadcrumbs
+          });
+          for (const schemaExample of schemaExamples) {
+            const exampleName = this.context.generateUniqueName({
+              prefix: `${this.parameter.name}_example`,
+              existingNames: Object.keys(v2Examples.userSpecifiedExamples)
+            });
+            v2Examples.userSpecifiedExamples[exampleName] = this.generateOrValidateExample({
+              schema,
+              example: this.context.resolveExample(schemaExample),
+              exampleName
+            });
+          }
+        }
         if (Object.keys(v2Examples.userSpecifiedExamples).length === 0) {
           const exampleName = `${this.parameter.name}_example`;
           v2Examples.autogeneratedExamples[exampleName] = this.generateOrValidateExample({
@@ -354024,6 +354050,26 @@ var init_AbstractParameterConverter = __esm({
         }
         return v2Examples;
       }
+      resolveSchemaChain(schemaOrReference) {
+        const visited = /* @__PURE__ */ new Set();
+        let current3 = schemaOrReference;
+        while (this.context.isReferenceObject(current3)) {
+          if (visited.has(current3.$ref)) {
+            return void 0;
+          }
+          visited.add(current3.$ref);
+          const resolved = this.context.resolveReference({
+            reference: current3,
+            breadcrumbs: this.breadcrumbs,
+            skipErrorCollector: true
+          });
+          if (!resolved.resolved) {
+            return void 0;
+          }
+          current3 = resolved.value;
+        }
+        return current3;
+      }
       generateOrValidateExample({ schema, example }) {
         const exampleConverter = new ExampleConverter({
           breadcrumbs: this.breadcrumbs,
@@ -465839,6 +465885,17 @@ og:description, headline, excerpt).`
             ],
             description: "Sets how nested object fields are rendered in the API reference.\n\n@default: `indented`\n\n- `indented` renders each nested level as an indented branch with a connector line and a color-coded path breadcrumb.\n- `cards` renders each nested level as a bordered card."
           },
+          "api-reference-expand-properties": {
+            oneOf: [
+              {
+                type: "boolean"
+              },
+              {
+                type: "null"
+              }
+            ],
+            description: 'If `api-reference-expand-properties` is set to true, the first level of nested object\nand union fields in the API reference is expanded on page load instead of hidden behind\na "Show N properties" button. Deeper levels stay collapsed. Defaults to false.'
+          },
           "show-nav-availability-badges": {
             oneOf: [
               {
@@ -706693,7 +706750,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.118.0",
+          version: "5.119.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -706759,7 +706816,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.118.0",
+        version: "5.119.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -888437,7 +888494,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.118.0";
+  const version7 = "5.119.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -915784,7 +915841,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.118.0",
+        cliVersion: "5.119.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -966825,6 +966882,11 @@ var TypescriptCustomConfigSchema = external_exports2.strictObject({
   tolerateRepublish: external_exports2.optional(external_exports2.boolean()),
   packageJson: external_exports2.optional(external_exports2.record(external_exports2.any())),
   packageJsonMergeStrategy: external_exports2.optional(external_exports2.enum(["shallow", "deep"])),
+  // When true, the generated SDK compiles cleanly under TypeScript's
+  // `exactOptionalPropertyTypes` compiler option: every optional property is
+  // emitted as `prop?: T | undefined`, and `exactOptionalPropertyTypes: true`
+  // is enabled in the generated tsconfig files.
+  exactOptionalPropertyTypes: external_exports2.optional(external_exports2.boolean()),
   publishToJsr: external_exports2.optional(external_exports2.boolean()),
   omitUndefined: external_exports2.optional(external_exports2.boolean()),
   useLegacyExports: external_exports2.optional(external_exports2.boolean()),
@@ -983197,7 +983259,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.118.0"
+    cli_version: "5.119.1"
   };
 }
 function isAutomationMode() {
@@ -984029,7 +984091,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.118.0";
+    return "5.119.1";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.118.0",
+  "version": "5.119.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",