From 6cf7ec2002286c68e7146f7ef165cb9804d27336 Mon Sep 17 00:00:00 2001 From: davidkonigsberg <72822263+davidkonigsberg@users.noreply.github.com> Date: Wed, 23 Jul 2025 13:20:30 +0000 Subject: [PATCH] copy over changelogs --- .../cli-changelog/2025-06-27.mdx | 10 +++++ .../cli-changelog/2025-06-28.mdx | 4 ++ .../cli-changelog/2025-07-01.mdx | 29 ++++++++++++++ .../cli-changelog/2025-07-02.mdx | 8 ++++ .../cli-changelog/2025-07-03.mdx | 12 ++++++ .../cli-changelog/2025-07-08.mdx | 14 +++++++ .../cli-changelog/2025-07-09.mdx | 12 ++++++ .../cli-changelog/2025-07-10.mdx | 4 ++ .../cli-changelog/2025-07-11.mdx | 4 ++ .../cli-changelog/2025-07-12.mdx | 17 +++++++++ .../cli-changelog/2025-07-14.mdx | 4 ++ .../cli-changelog/2025-07-15.mdx | 20 ++++++++++ .../cli-changelog/2025-07-16.mdx | 4 ++ .../cli-changelog/2025-07-18.mdx | 8 ++++ .../cli-changelog/2025-07-21.mdx | 12 ++++++ .../cli-changelog/2025-07-22.mdx | 12 ++++++ .../sdks/overview/go/changelog/2025-07-21.mdx | 9 +++++ .../overview/java/changelog/2025-07-16.mdx | 4 ++ .../overview/java/changelog/2025-07-17.mdx | 4 ++ .../overview/java/changelog/2025-07-18.mdx | 4 ++ .../overview/php/changelog/2025-07-10.mdx | 7 ++++ .../overview/python/changelog/2025-07-11.mdx | 4 ++ .../overview/python/changelog/2025-07-14.mdx | 4 ++ .../overview/python/changelog/2025-07-15.mdx | 4 ++ .../overview/python/changelog/2025-07-17.mdx | 4 ++ .../overview/python/changelog/2025-07-22.mdx | 4 ++ .../typescript/changelog/2025-07-10.mdx | 10 +++++ .../typescript/changelog/2025-07-15.mdx | 6 +++ .../typescript/changelog/2025-07-17.mdx | 38 +++++++++++++++++++ .../typescript/changelog/2025-07-18.mdx | 3 ++ .../typescript/changelog/2025-07-22.mdx | 3 ++ 31 files changed, 282 insertions(+) create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-06-27.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-06-28.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-01.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-02.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-03.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-08.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-09.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-10.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-11.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-12.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-14.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-15.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-16.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-18.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-21.mdx create mode 100644 fern/products/cli-api-reference/cli-changelog/2025-07-22.mdx create mode 100644 fern/products/sdks/overview/go/changelog/2025-07-21.mdx create mode 100644 fern/products/sdks/overview/java/changelog/2025-07-16.mdx create mode 100644 fern/products/sdks/overview/java/changelog/2025-07-17.mdx create mode 100644 fern/products/sdks/overview/java/changelog/2025-07-18.mdx create mode 100644 fern/products/sdks/overview/php/changelog/2025-07-10.mdx create mode 100644 fern/products/sdks/overview/python/changelog/2025-07-11.mdx create mode 100644 fern/products/sdks/overview/python/changelog/2025-07-14.mdx create mode 100644 fern/products/sdks/overview/python/changelog/2025-07-15.mdx create mode 100644 fern/products/sdks/overview/python/changelog/2025-07-17.mdx create mode 100644 fern/products/sdks/overview/python/changelog/2025-07-22.mdx create mode 100644 fern/products/sdks/overview/typescript/changelog/2025-07-10.mdx create mode 100644 fern/products/sdks/overview/typescript/changelog/2025-07-15.mdx create mode 100644 fern/products/sdks/overview/typescript/changelog/2025-07-17.mdx create mode 100644 fern/products/sdks/overview/typescript/changelog/2025-07-18.mdx create mode 100644 fern/products/sdks/overview/typescript/changelog/2025-07-22.mdx diff --git a/fern/products/cli-api-reference/cli-changelog/2025-06-27.mdx b/fern/products/cli-api-reference/cli-changelog/2025-06-27.mdx new file mode 100644 index 000000000..e5043e2f9 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-06-27.mdx @@ -0,0 +1,10 @@ +## 0.64.25 +**`(feat):`** Remove all org-specific legacy preview pins. + + +## 0.64.24 +**`(feat):`** Added Server-Sent Events (SSE) support to Java stream implementation. The Java SDK generator now +supports SSE streaming alongside existing JSON streaming, enabling real-time incremental responses +for chat applications and live data feeds. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-06-28.mdx b/fern/products/cli-api-reference/cli-changelog/2025-06-28.mdx new file mode 100644 index 000000000..f847f8c19 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-06-28.mdx @@ -0,0 +1,4 @@ +## 0.64.26 +**`(fix):`** Fixes the OpenAPI parser to correctly include query parameters in `Content-Type: application/octet-stream` requests. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-01.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-01.mdx new file mode 100644 index 000000000..04bc84922 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-01.mdx @@ -0,0 +1,29 @@ +## 0.64.35 +**`(fix):`** Upgrade fdr and fdr-cjs dependencies to support grpc endpoints in convertIrToFdrApi. + + +## 0.64.34 +**`(fix):`** Add global headers in endpoint example generation. + + +## 0.64.33 +**`(feat):`** GA release with support for protobuf generation + + +## 0.64.32-rc1 +**`(feat):`** Use 'fern protoc-gen-fern' in buf shell proxy instead of local cli build. + + +## 0.64.32-rc0 +**`(feat):`** Reintroduce buf command/dependency. + + +## 0.64.31 +**`(fix):`** Revert dependency on bufbuild package. + + +## 0.64.28 +**`(feat):`** Support the `x-displayName` extension on the tag definition in OpenAPI. This allows OpenAPI + specifications to define custom display names for tags that will be used in generated documentation. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-02.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-02.mdx new file mode 100644 index 000000000..50f78eabd --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-02.mdx @@ -0,0 +1,8 @@ +## 0.64.37 +**`(fix):`** Remove default docs for well known types in gRPC. Add support for field-level docs. + + +## 0.64.36 +**`(fix):`** Change grpc converters to use the fully qualified name with package prefix for all conversions. Build support for well-known types. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-03.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-03.mdx new file mode 100644 index 000000000..88ae817b3 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-03.mdx @@ -0,0 +1,12 @@ +## 0.65.1 +**`(chore):`** Re-release changes from 0.65.0. + + +## 0.65.0 +**`(feat):`** Rename the TypeScript SDK generator image from `fernapi/fern-typescript-node-sdk` to `fernapi/fern-typescript-sdk`. + + +## 0.65.0-rc0 +**`(feat):`** Rename the TypeScript SDK generator image from `fernapi/fern-typescript-node-sdk` to `fernapi/fern-typescript-sdk`. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-08.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-08.mdx new file mode 100644 index 000000000..1084d2c1d --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-08.mdx @@ -0,0 +1,14 @@ +## 0.65.4 +**`(fix):`** Previously if the OpenAPI parser v3 was enabled where the CLI would skip parsing any additional Fern Definitions +along the OpenAPI spec. With the fix, you can use whatever combination of OpenAPI Spec(s) and Fern Definitions that +you would like. + + +## 0.65.3 +**`(fix):`** Update `fern init` for java and go SDKs. + + +## 0.65.2 +**`(fix):`** Global header examples are only used when a corresponding endpoint header with the same name is not present. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-09.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-09.mdx new file mode 100644 index 000000000..e73f763d9 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-09.mdx @@ -0,0 +1,12 @@ +## 0.65.7 +**`(feat):`** Support example generation for gRPC docs. + + +## 0.65.6 +**`(feat):`** Support response error examples in the v3 parser. + + +## 0.65.5 +**`(fix):`** Fix how multipart encoding is handled in the v3 parser + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-10.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-10.mdx new file mode 100644 index 000000000..f715834f8 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-10.mdx @@ -0,0 +1,4 @@ +## 0.65.8 +**`(feat):`** Support date and date-time in v3 example generation. Change fallback string example to use "string" instead of "foo". + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-11.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-11.mdx new file mode 100644 index 000000000..ae076a72c --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-11.mdx @@ -0,0 +1,4 @@ +## 0.65.9 +**`(feat):`** Convert relevant endpoints to GrpcNode type in ApiReferenceNodeConverter + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-12.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-12.mdx new file mode 100644 index 000000000..9566cd63f --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-12.mdx @@ -0,0 +1,17 @@ +## 0.65.11 +**`(feat):`** The extension `x-fern-global-headers` now supports a type field that can point to +arbitrary schemas. For example you can do the following to describe a header +that is an enum. + +```yml +x-fern-global-headers: + - header: X-API-Version + name: version + type: VersionEnum +``` + + +## 0.65.10 +**`(feat):`** Clarify `fern upgrade` command description. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-14.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-14.mdx new file mode 100644 index 000000000..47bcc9109 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-14.mdx @@ -0,0 +1,4 @@ +## 0.65.12 +**`(feat):`** Use service display name for grpc services. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-15.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-15.mdx new file mode 100644 index 000000000..95dbd2824 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-15.mdx @@ -0,0 +1,20 @@ +## 0.65.17 +**`(fix):`** Use the nested "value" field for OpenAPI examples if it exists. + + +## 0.65.16 +**`(fix):`** Add a fallback version for buf export config. + + +## 0.65.15 +**`(fix):`** Fix enum type reference conversions for protobuf docs generation. + + +## 0.65.14 +**`(fix):`** Ignore buf.yaml and buf.gen.yaml when copying/exporting protobuf files. + + +## 0.65.13 +**`(feat):`** Add support for specifying target protobuf files for gRPC docs generation. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-16.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-16.mdx new file mode 100644 index 000000000..8e40ce9bf --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-16.mdx @@ -0,0 +1,4 @@ +## 0.65.18 +**`(feat):`** Add reference.md generation for Java SDKs. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-18.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-18.mdx new file mode 100644 index 000000000..b2be22b4e --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-18.mdx @@ -0,0 +1,8 @@ +## 0.65.20 +**`(feat):`** Added smart display naming for undiscriminated unions. + + +## 0.65.19 +**`(feat):`** Upgrade docs dev to use new docs bundle on Windows. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-21.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-21.mdx new file mode 100644 index 000000000..8deea6e76 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-21.mdx @@ -0,0 +1,12 @@ +## 0.65.23 +**`(fix):`** `fern docs dev` server connection should no longer require frequent refresh. + + +## 0.65.22 +**`(fix):`** Auto upgrade corepack within fern docs dev if corepack missing key error. + + +## 0.65.21 +**`(fix):`** Improve logging in fern docs dev. + + diff --git a/fern/products/cli-api-reference/cli-changelog/2025-07-22.mdx b/fern/products/cli-api-reference/cli-changelog/2025-07-22.mdx new file mode 100644 index 000000000..1ca2b2392 --- /dev/null +++ b/fern/products/cli-api-reference/cli-changelog/2025-07-22.mdx @@ -0,0 +1,12 @@ +## 0.65.26 +**`(feat):`** Support RBAC roles across products. + + +## 0.65.25 +**`(fix):`** IR gen fix: added default response example for 2xx status codes. + + +## 0.65.24 +**`(fix):`** improved grabbing of read only property of allOf schemas + + diff --git a/fern/products/sdks/overview/go/changelog/2025-07-21.mdx b/fern/products/sdks/overview/go/changelog/2025-07-21.mdx new file mode 100644 index 000000000..a5384d629 --- /dev/null +++ b/fern/products/sdks/overview/go/changelog/2025-07-21.mdx @@ -0,0 +1,9 @@ +## 1.5.1 +**`(fix):`** Enum headers are now correctly serialized in API requests. When an endpoint specifies an enum type for a header +parameter, the SDK will automatically serialize the enum value to its string representation as expected by the API. + + +## 1.5.0 +**`(internal):`** Update the primary client to delegate to the new raw client to reduce code duplication. + + diff --git a/fern/products/sdks/overview/java/changelog/2025-07-16.mdx b/fern/products/sdks/overview/java/changelog/2025-07-16.mdx new file mode 100644 index 000000000..279574fb4 --- /dev/null +++ b/fern/products/sdks/overview/java/changelog/2025-07-16.mdx @@ -0,0 +1,4 @@ +## 2.38.3 +**`(fix):`** Add reference.md generation for Java SDKs. + + diff --git a/fern/products/sdks/overview/java/changelog/2025-07-17.mdx b/fern/products/sdks/overview/java/changelog/2025-07-17.mdx new file mode 100644 index 000000000..3a9afe8ce --- /dev/null +++ b/fern/products/sdks/overview/java/changelog/2025-07-17.mdx @@ -0,0 +1,4 @@ +## 2.38.4 +**`(fix):`** Fix stream SSE test to use Java 8 compatible stream collection method. + + diff --git a/fern/products/sdks/overview/java/changelog/2025-07-18.mdx b/fern/products/sdks/overview/java/changelog/2025-07-18.mdx new file mode 100644 index 000000000..306a9fc75 --- /dev/null +++ b/fern/products/sdks/overview/java/changelog/2025-07-18.mdx @@ -0,0 +1,4 @@ +## 2.38.5 +**`(chore):`** Remove internal OkHttp utility dependency and use a more robust file closing method. + + diff --git a/fern/products/sdks/overview/php/changelog/2025-07-10.mdx b/fern/products/sdks/overview/php/changelog/2025-07-10.mdx new file mode 100644 index 000000000..e5aefe26a --- /dev/null +++ b/fern/products/sdks/overview/php/changelog/2025-07-10.mdx @@ -0,0 +1,7 @@ +## 1.16.5 +**`(fix):`** Fix duplicate array types in undiscriminated union properties. Previously, nested unions +containing different array types (e.g., `array` and `array`) would +generate duplicate array annotations in PHP union types (array|array|null). The fix implements +recursive union flattening with proper deduplication during type generation. + + diff --git a/fern/products/sdks/overview/python/changelog/2025-07-11.mdx b/fern/products/sdks/overview/python/changelog/2025-07-11.mdx new file mode 100644 index 000000000..576679824 --- /dev/null +++ b/fern/products/sdks/overview/python/changelog/2025-07-11.mdx @@ -0,0 +1,4 @@ +## 4.25.2 +**`(fix):`** Generator fix: automatically switch tabs to spaces, following PEP8 standards. + + diff --git a/fern/products/sdks/overview/python/changelog/2025-07-14.mdx b/fern/products/sdks/overview/python/changelog/2025-07-14.mdx new file mode 100644 index 000000000..66df7e4bb --- /dev/null +++ b/fern/products/sdks/overview/python/changelog/2025-07-14.mdx @@ -0,0 +1,4 @@ +## 4.25.3 +**`(fix):`** Fix websocket connect method generation for single base URL environments. + + diff --git a/fern/products/sdks/overview/python/changelog/2025-07-15.mdx b/fern/products/sdks/overview/python/changelog/2025-07-15.mdx new file mode 100644 index 000000000..aa3e0ab9e --- /dev/null +++ b/fern/products/sdks/overview/python/changelog/2025-07-15.mdx @@ -0,0 +1,4 @@ +## 4.25.4 +**`(fix):`** Updated construct_type function to handles undiscriminated unions with lists, sets, and dictionaries of objects. + + diff --git a/fern/products/sdks/overview/python/changelog/2025-07-17.mdx b/fern/products/sdks/overview/python/changelog/2025-07-17.mdx new file mode 100644 index 000000000..5ff08f5e2 --- /dev/null +++ b/fern/products/sdks/overview/python/changelog/2025-07-17.mdx @@ -0,0 +1,4 @@ +## 4.25.5 +**`(feat):`** Enabled "ignore" as an option for extra fields + + diff --git a/fern/products/sdks/overview/python/changelog/2025-07-22.mdx b/fern/products/sdks/overview/python/changelog/2025-07-22.mdx new file mode 100644 index 000000000..ab38656ae --- /dev/null +++ b/fern/products/sdks/overview/python/changelog/2025-07-22.mdx @@ -0,0 +1,4 @@ +## 4.25.6 +**`(feat):`** Removed snippet generation + + diff --git a/fern/products/sdks/overview/typescript/changelog/2025-07-10.mdx b/fern/products/sdks/overview/typescript/changelog/2025-07-10.mdx new file mode 100644 index 000000000..3a8d18697 --- /dev/null +++ b/fern/products/sdks/overview/typescript/changelog/2025-07-10.mdx @@ -0,0 +1,10 @@ +## 2.4.8 +**`(fix):`** Fix ts readme snippet where const was reassigned. Changed to let. + + +## 2.4.7 +**`(fix):`** Make sure `extraDependencies`, `extraPeerDependencies`, `extraPeerDependenciesMeta`, and `extraDevDependencies` are always merged into _package.json_. +This was previously fixed for `shouldBundle: true`, but not for `shouldBundle: false` (default). +All dependencies should now come through. + + diff --git a/fern/products/sdks/overview/typescript/changelog/2025-07-15.mdx b/fern/products/sdks/overview/typescript/changelog/2025-07-15.mdx new file mode 100644 index 000000000..ee9547306 --- /dev/null +++ b/fern/products/sdks/overview/typescript/changelog/2025-07-15.mdx @@ -0,0 +1,6 @@ +## 2.4.10 +**`(fix):`** Escape strings containing `*/` inside of JSDoc comments to avoid premature JSDoc block ending. + +## 2.4.9 +**`(fix):`** Preserve trailing slash of URL and path if present + diff --git a/fern/products/sdks/overview/typescript/changelog/2025-07-17.mdx b/fern/products/sdks/overview/typescript/changelog/2025-07-17.mdx new file mode 100644 index 000000000..fb33311e2 --- /dev/null +++ b/fern/products/sdks/overview/typescript/changelog/2025-07-17.mdx @@ -0,0 +1,38 @@ +## 2.5.0 +**`(feat):`** Support uploading file-like types for binary upload endpoints (not multipart-form): +* Buffered types: `Buffer`, `Blob`, `File`, `ArrayBuffer`, `ArrayBufferView`, and `Uint8Array` +* Stream types: `fs.ReadStream`, `stream.Readable`, and `ReadableStream` + + +**`(feat):`** Users can configure metadata when uploading a file to a binary upload endpoint using the `Uploadable.WithMetadata` type: +```typescript +import { createReadStream } from "fs"; + +await client.upload({ + data: createReadStream("path/to/file"), + filename: "my-file", + contentType: "audio/mpeg", + contentLength: 1949, +}); +``` +The `filename`, `contentType`, and `contentLength` properties are optional. + +Alternatively, users can use the `Uploadable.FromPath` type to upload directly from a file path: +```typescript +await client.upload({ + path: "path/to/file", + filename: "my-file", + contentType: "audio/mpeg", + contentLength: 1949, +}); +``` + +The metadata is used to set the `Content-Length`, `Content-Type`, and `Content-Disposition` headers. If not provided, the client will attempt to determine them automatically. +For example, `fs.ReadStream` has a `path` property which the SDK uses to retrieve the file size from the filesystem without loading it into memory: +```typescript +import { createReadStream } from "fs"; + +await client.upload(createReadStream("path/to/file")); +``` + + diff --git a/fern/products/sdks/overview/typescript/changelog/2025-07-18.mdx b/fern/products/sdks/overview/typescript/changelog/2025-07-18.mdx new file mode 100644 index 000000000..be65f98b6 --- /dev/null +++ b/fern/products/sdks/overview/typescript/changelog/2025-07-18.mdx @@ -0,0 +1,3 @@ +## 2.4.11 +**`(chore):`** Bump the docker image for the generator to node:22.12-alpine3.20 + diff --git a/fern/products/sdks/overview/typescript/changelog/2025-07-22.mdx b/fern/products/sdks/overview/typescript/changelog/2025-07-22.mdx new file mode 100644 index 000000000..21918ff09 --- /dev/null +++ b/fern/products/sdks/overview/typescript/changelog/2025-07-22.mdx @@ -0,0 +1,3 @@ +## 2.5.1 +**`(chore):`** Update README.md generation to be more accurate +