forked from fern-api/fern
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathversions.yml
More file actions
183 lines (165 loc) · 5.85 KB
/
versions.yml
File metadata and controls
183 lines (165 loc) · 5.85 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
# yaml-language-server: $schema=../../fern-versions-yml.schema.json
- version: 0.5.0
changelogEntry:
- summary: |
The generator now emits OpenAPI 3.1.0 specifications (previously 3.0.1). As part of this:
- `nullable: true` is no longer emitted. Optional/nullable types now use the OAS 3.1
idiom: `type: [T, "null"]` for primitives, and `anyOf: [$ref, {type: "null"}]` for
references. This fixes the silent no-op where `$ref` + sibling `nullable` did nothing.
- Parameters no longer emit both `example` and `examples` (they are mutually exclusive
in OAS 3.0 and 3.1). `examples` is preferred when present.
- `info.version` is populated with a non-empty default (`"0.0.0"`) instead of an empty
string, which violated the spec.
- `exclusiveMinimum`/`exclusiveMaximum` now emit as numbers (JSON Schema 2020-12)
instead of the 3.0-era boolean format.
- Single-element enums and union discriminant properties now use `const` instead of
`enum: [singleValue]`.
- Redundant `additionalProperties: true` is no longer emitted (defaults to true in 3.1).
- Schema property examples use the 3.1 `examples` array instead of the deprecated
singular `example` keyword.
- Response descriptions now have meaningful defaults instead of empty strings.
This is a breaking change for consumers relying on OAS 3.0 tooling.
type: feat
createdAt: "2026-04-13"
irVersion: 66
- version: 0.4.0-rc.0
changelogEntry:
- summary: |
Upgrade to IR v66 which compresses the IR Name type, reducing IR size and increasing performance.
type: feat
- summary: |
Fix security scheme names in the generated OpenAPI spec to use the casing configuration from the IR
instead of hardcoded names. Scheme names now reflect the original key from the Fern definition,
pascal-cased.
type: fix
createdAt: "2026-04-01"
irVersion: 66
- version: 0.3.0
createdAt: "2026-02-27"
changelogEntry:
- type: feat
summary: |
The OpenAPI generator now includes `x-fern-availability` extensions in the generated OpenAPI spec
for endpoints, query parameters, headers, object properties, and type declarations.
irVersion: 53
- version: 0.2.0
createdAt: "2026-02-10"
changelogEntry:
- type: feat
summary: |
Add support for numeric validation constraints (minimum/maximum, exclusiveMinimum/exclusiveMaximum, multipleOf)
and string length constraints (minLength/maxLength) in the generated OpenAPI schemas, parameters, and request bodies.
irVersion: 53
- version: 0.1.8
createdAt: "2025-11-19"
changelogEntry:
- type: chore
summary: |
Bump generator CLI version to publish new Docker image.
irVersion: 53
- version: 0.1.7
createdAt: "2025-01-24"
changelogEntry:
- type: fix
summary: |
The generator now correctly handles different success response codes.
irVersion: 53
- version: 0.1.6
createdAt: "2024-12-20"
changelogEntry:
- type: fix
summary: |
The generator now correctly handles float types when converting to OpenAPI specs.
irVersion: 53
- version: 0.1.5
createdAt: "2024-10-06"
changelogEntry:
- type: fix
summary: |
The generator now adds parameter level examples for global parameters.
irVersion: 53
- version: 0.1.4
createdAt: "2024-09-25"
changelogEntry:
- type: fix
summary: |
The generator now handles `config.filename` being null so that the
configuration for the generator can continue to be backwards compatible.
irVersion: 53
- version: 0.1.3
createdAt: "2024-09-25"
changelogEntry:
- type: fix
summary: |
The OpenAPI generator now supports adding patterns to any string references.
irVersion: 53
- version: 0.1.2
createdAt: "2024-09-25"
changelogEntry:
- type: feat
summary: |
The OpenAPI generator now supports a configuration to define the name
of the file that you would like to output.
```yml generators.yml
- name: fernapi/fern-openapi
version: 0.1.2
config:
filename: My-Openapi.yml
```
irVersion: 53
- version: 0.1.1
createdAt: "2024-09-25"
changelogEntry:
- type: fix
summary: |
The `customOverrides` configuration flag now supports explicit nulls as a way to
delete keys in the generated OpenAPI spec. For example, if you want to
exclude the `openapi.info` block in the generated spec, then you can do something
along the lines:
```yml generators.yml
- name: fernapi/fern-openapi
version: 0.1.1
config:
customOverrides:
info: null # excludes the info field
```
irVersion: 53
- version: 0.1.0
createdAt: "2024-09-25"
changelogEntry:
- type: chore
summary: |
The OpenAPI generator now uses version 53 of the IR (previously was on version 23). You
will need to upgrade your Fern CLI to the latest to run this version of the OpenAPI
generator.
irVersion: 53
- version: 0.0.32
createdAt: "2024-03-24"
changelogEntry:
- type: fix
summary: |
The generated OpenAPI spec now takes into account global path parameters.
irVersion: 23
- version: 0.0.31
createdAt: "2024-03-22"
changelogEntry:
- type: fix
summary: >-
Update open api generator to v2 urls.
- type: internal
summary: >-
Shared generator notification and config parsing logic.
irVersion: 23
- version: 0.0.31-rc0
createdAt: "2024-03-20"
changelogEntry:
- type: fix
summary: >-
Update open api generator to v2 urls.
irVersion: 23
- version: 0.0.30
createdAt: "2024-01-21"
changelogEntry:
- type: internal
summary: Release 0.0.30
irVersion: 23