You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/src/pages/versions/v8.mdx
+31-8Lines changed: 31 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -307,7 +307,30 @@ If you were using dynamic imports:
307
307
-**Future-proof**: Aligns with JavaScript ecosystem standards
308
308
-**Stricter module boundaries**: Better encapsulation and type safety
309
309
310
-
### 2. Changed default value of httpClient from `axios` to `fetch`
310
+
### 2. OpenAPI 3.0 Support Dropped in Favor of 3.1.0
311
+
312
+
Support for OpenAPI 3.0 specifications has been dropped in favor of the newer 3.1.0 standard. See [PR #2614](https://github.com/orval-labs/orval/pull/2614) for details.
313
+
314
+
#### How to migrate
315
+
316
+
If you're consuming APIs that use OpenAPI 3.0 specifications, you may need to update them to OpenAPI 3.1.0.
317
+
318
+
A common issue is replacing `nullable: true`:
319
+
320
+
```yaml
321
+
# OpenAPI 3.0
322
+
field:
323
+
type: string
324
+
nullable: true
325
+
326
+
# OpenAPI 3.1.0
327
+
field:
328
+
type: ["string", "null"]
329
+
```
330
+
331
+
For a complete migration guide, see the [official OpenAPI migration documentation](https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0).
332
+
333
+
### 3. Changed default value of httpClient from `axios` to `fetch`
311
334
312
335
We changed the default httpClient from `axios` to `fetch` to reduce bundle size and eliminate the need for additional dependencies.
313
336
@@ -329,7 +352,7 @@ export default {
329
352
};
330
353
```
331
354
332
-
### 3. Removed `override.fetch.explode` option
355
+
### 4. Removed `override.fetch.explode` option
333
356
334
357
This parameter was kept only for compatibility. Since compatibility maintenance is no longer needed in major versions, it has been removed.
335
358
@@ -349,7 +372,7 @@ paths:
349
372
type: array
350
373
```
351
374
352
-
### 4. Changed default value of `override.mock.delay` from `1000` to `false`
375
+
### 5. Changed default value of `override.mock.delay` from `1000` to `false`
353
376
354
377
We disabled the default delay as it creates noise.
355
378
@@ -369,7 +392,7 @@ export default {
369
392
};
370
393
```
371
394
372
-
### 5. Removed `override.coerceTypes`
395
+
### 6. Removed `override.coerceTypes`
373
396
374
397
This was removed as it has been replaced by the more flexible and explicit `override.zod.coerce`.
375
398
@@ -398,7 +421,7 @@ export default {
398
421
};
399
422
```
400
423
401
-
### 6. Removed `override.useNativeEnums`
424
+
### 7. Removed `override.useNativeEnums`
402
425
403
426
This was removed as it has been integrated into `enumGenerationType`.
Combined types (`anyOf`, `oneOf`, `allOf`) are now inlined by default instead of creating intermediate type aliases.
425
448
@@ -439,7 +462,7 @@ export default {
439
462
};
440
463
```
441
464
442
-
### 8. Zod Schema Naming Convention Changed to PascalCase
465
+
### 9. Zod Schema Naming Convention Changed to PascalCase
443
466
444
467
All Zod schema exports now use PascalCase naming convention to align with TypeScript type definition standards.
445
468
@@ -456,7 +479,7 @@ All Zod schema exports now use PascalCase naming convention to align with TypeSc
456
479
+ export type CreatePetsBody = zod.infer<typeof CreatePetsBody>
457
480
```
458
481
459
-
### 9. SWR custom error types are no longer generated by default
482
+
### 10. SWR custom error types are no longer generated by default
460
483
461
484
Custom error type aliases (e.g., `ListPetsQueryError`, `CreatePetsMutationError`) are no longer generated by default as they simply re-export the error type without providing additional value.
0 commit comments