···11+---
22+"openapi-ts-docs": minor
33+---
44+55+docs: add integrations
+4
README.md
···44 <p align="center">✨ Turn your OpenAPI specification into a beautiful TypeScript client.</p>
55</div>
6677+## GitHub Integration (coming soon)
88+99+Automatically update your code when the APIs it depends on change. [Find out more](https://heyapi.vercel.app/openapi-ts/integrations.html).
1010+711## Migrating from OpenAPI Typescript Codegen?
812913Please read our [migration guide](https://heyapi.vercel.app/openapi-ts/migrating.html#openapi-typescript-codegen).
···11---
22-title: About
22+title: Philosophy
33description: Hello from Hey API.
44---
55···1313- send and fetch this data from server in a typesafe way
1414- build further abstractions on top of this data
15151616-```mermaid
1717-flowchart LR
1818- id1(Application) --> id2(API types) --> id3(API request wrapper) --> id4(REST endpoint)
1919-```
2020-2116Doing any of these steps manually quickly becomes a huge time sink as your project grows and APIs evolve. Ideally, you want to spend most time on your application. Hey API allows you to do just that.
2222-2323-```mermaid
2424-flowchart LR
2525- id1(Application) --> id2(Hey API) --> id3(REST endpoint)
2626-```
27172818We're constantly learning about the ways in which you use our tools. If you have any feedback, please [email us](mailto:lmenus@lmen.us), [open an issue](https://github.com/hey-api/openapi-ts/issues), or [join a discussion](https://github.com/hey-api/openapi-ts/discussions).
2919
···11+---
22+title: Integrations
33+description: Automate your client generation.
44+---
55+66+# Integrations <span class="soon">Soon</span>
77+88+Integrations allow you to automate your client generation workflow. We suggest using them with `openapi-ts`, but you can use any codegen.
99+1010+<br/>
1111+1212+::: tip
1313+Integrations are in beta. If you'd like to be one of the first users, [send us an email](mailto:lmenus@lmen.us).
1414+:::
1515+1616+## Upload OpenAPI Spec
1717+1818+More information will be provided as we finalize the tooling.
1919+2020+## Configure Clients
2121+2222+More information will be provided as we finalize the tooling.
+8-9
docs/openapi-ts/migrating.md
···52525353## v0.39.0
54545555-### Prefer `unknown` over `any`
5656-5757-Types that cannot be determined will now be generated as `unknown` instead of `any`.
5858-5959-```js
6060-200: any // [!code --]
6161-200: unknown // [!code ++]
6262-```
6363-6455### Single `enums.gen.ts` file
65566657Enums are now exported from a separate file. If you use imports from `models.ts`, you can change them to `enums.gen.ts`.
···10798import type { Model } from 'client/models.gen' // [!code ++]
10899import { $Schema } from 'client/schemas.gen' // [!code ++]
109100import { DefaultService } from 'client/services.gen' // [!code ++]
101101+```
102102+103103+### Prefer `unknown`
104104+105105+Types that cannot be determined will now be generated as `unknown` instead of `any`. To dismiss any errors, you can cast your variables back to `any`, but we recommend updating your code to work with `unknown` types.
106106+107107+```js
108108+const foo = bar as any
110109```
111110112111## v0.38.0
···11<div align="center">
22- <img width="150" height="150" src="https://heyapi.vercel.app/logo.png" alt="Logo">
33- <h1 align="center"><b>OpenAPI Typescript</b></h1>
44- <p align="center">✨ Turn your OpenAPI specification into a beautiful TypeScript client.</p>
22+ <img width="150" height="150" src="https://heyapi.vercel.app/logo.png" alt="Logo">
33+ <h1 align="center"><b>OpenAPI Typescript</b></h1>
44+ <p align="center">✨ Turn your OpenAPI specification into a beautiful TypeScript client.</p>
55</div>
6677+`openapi-ts` allows you to create TypeScript interfaces, REST clients, and JSON Schemas from an OpenAPI specification.
88+79## Features
81099-- Generate TypeScript clients from OpenAPI v2.0, v3.0, and v3.1 specifications
1010-- Support JSON or YAML input files
1111-- Handle external references using [JSON Schema $Ref Parser](https://github.com/APIDevTools/json-schema-ref-parser/)
1212-- Generate Fetch, Node-Fetch, Axios, Angular, or XHR HTTP clients
1313-- Can be used with CLI, Node.js, or npx
1414-- Abortable requests through cancellable promise pattern
1111+- use with CLI, Node.js, or npx
1212+- export TypeScript interfaces from OpenAPI v2.0, v3.0, and v3.1 specifications
1313+- support JSON or YAML input files
1414+- support external references using [json-schema-ref-parser](https://github.com/APIDevTools/json-schema-ref-parser/)
1515+- create fetch, axios, angular, node.js, or xhr REST clients
1616+- export JSON Schemas from OpenAPI specifications
1717+- abortable requests through cancellable promise pattern
1818+1919+## GitHub Integration (coming soon)
2020+2121+Automatically update your code when the APIs it depends on change. [Find out more](https://heyapi.vercel.app/openapi-ts/integrations.html).
15221623## Migrating from OpenAPI Typescript Codegen?
1724