@hey-api/openapi-ts 0.33.2 → 0.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hey-api/openapi-ts",
-    "version": "0.33.2",
+    "version": "0.34.0",
     "type": "module",
     "description": "Turn your OpenAPI specification into a beautiful TypeScript client",
     "homepage": "https://github.com/hey-api/openapi-ts/",
@@ -41,8 +41,8 @@
         "build-types-check": "tsc --project tsconfig.check.json",
         "build-types-roll": "rollup --config rollup.dts.config.ts --configPlugin typescript && rimraf temp",
         "build-types-temp": "tsc --emitDeclarationOnly --outDir temp -p src/node",
-        "build-types": "run-s build-types-temp build-types-roll build-types-check",
-        "build": "run-s clean build-bundle build-types",
+        "build-types": "npm run build-types-temp && npm run build-types-roll && npm run build-types-check",
+        "build": "npm run clean && npm run build-bundle && npm run build-types",
         "clean": "rimraf dist test/generated test/e2e/generated coverage node_modules/.cache",
         "dev": "rimraf dist && npm run build-bundle -- --watch",
         "lint:fix": "eslint . --fix",
@@ -78,29 +78,27 @@
         "@angular/platform-browser": "17.3.2",
         "@angular/platform-browser-dynamic": "17.3.2",
         "@angular/router": "17.3.2",
-        "@changesets/cli": "2.27.1",
         "@rollup/plugin-commonjs": "25.0.7",
         "@rollup/plugin-json": "6.1.0",
         "@rollup/plugin-node-resolve": "15.2.3",
         "@rollup/plugin-terser": "0.4.4",
         "@rollup/plugin-typescript": "11.1.6",
-        "@svitejs/changesets-changelog-github-compact": "1.1.0",
         "@types/cross-spawn": "6.0.6",
         "@types/express": "4.17.21",
         "@types/node": "20.12.2",
-        "@typescript-eslint/eslint-plugin": "7.4.0",
-        "@typescript-eslint/parser": "7.4.0",
+        "@typescript-eslint/eslint-plugin": "7.5.0",
+        "@typescript-eslint/parser": "7.5.0",
         "@vitest/coverage-v8": "1.4.0",
-        "abort-controller": "3.0.0",
         "axios": "1.6.8",
         "cross-spawn": "7.0.3",
         "eslint": "8.57.0",
         "eslint-config-prettier": "9.1.0",
         "eslint-plugin-prettier": "5.1.3",
         "eslint-plugin-simple-import-sort": "12.0.0",
+        "eslint-plugin-sort-keys-fix": "1.1.2",
         "express": "4.19.2",
+        "glob": "10.3.12",
         "node-fetch": "3.3.2",
-        "npm-run-all2": "6.1.2",
         "prettier": "3.2.5",
         "puppeteer": "22.6.1",
         "rimraf": "5.0.5",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) Hey API
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,238 +0,0 @@
-# OpenAPI TypeScript 👋
-
-> ✨ Turn your OpenAPI specification into a beautiful TypeScript client
-
-## Table of Contents
-- [Table of Contents](#table-of-contents)
-- [About](#about)
-- [Features](#features)
-- [Quick Start](#quick-start)
-- [Installation](#installation)
-- [Configuration](#configuration)
-  - [Clients](#clients)
-  - [Formatting](#formatting)
-  - [Linting](#linting)
-  - [Enums](#enums)
-  - [Config API](#config-api)
-- [Interceptors](#interceptors)
-- [Migrating](#migrating)
-- [Contributing](#contributing)
-
-## About
-
-`openapi-ts` started as a fork of [openapi-typescript-codegen](https://github.com/ferdikoomen/openapi-typescript-codegen). We created it after the original project became [unmaintained](https://github.com/ferdikoomen/openapi-typescript-codegen/issues/1276#issuecomment-1302392146) to add support for OpenAPI v3.1. We plan to resolve the most pressing issues in the original project – open an issue if you'd like to prioritise your use case!
-
-## Features
-
-- generate TypeScript clients from OpenAPI v2.0, v3.0, and v3.1 specifications
-- support JSON or YAML input files
-- handle external references using [JSON Schema $Ref Parser](https://github.com/APIDevTools/json-schema-ref-parser/)
-- generate Fetch, Node-Fetch, Axios, Angular, or XHR HTTP clients
-- can be used with CLI, Node.js, or npx
-- abortable requests through cancellable promise pattern
-
-## Quick Start
-
-The fastest way to use `openapi-ts` is via npx
-
-```sh
-npx @hey-api/openapi-ts -i path/to/openapi.json -o src/client
-```
-
-Congratulations on creating your first client! 🎉
-
-## Installation
-
-```sh
-npm install @hey-api/openapi-ts --save-dev
-```
-
-or
-
-```sh
-yarn add @hey-api/openapi-ts -D
-```
-
-If you want to use `openapi-ts` with CLI, add a script to your `package.json` file
-
-```json
-"scripts": {
-  "openapi-ts": "openapi-ts"
-}
-```
-
-You can also generate your client programmatically by importing `openapi-ts` in a `.ts` file.
-
-```ts
-import { createClient } from '@hey-api/openapi-ts'
-
-createClient({
-  input: 'path/to/openapi.json',
-  output: 'src/client',
-})
-```
-
-> ⚠️ You need to be running Node.js v18 or newer
-
-## Configuration
-
-`openapi-ts` supports loading configuration from a file inside your project root directory. You can either create a `openapi-ts.config.cjs` file
-
-```cjs
-/** @type {import('@hey-api/openapi-ts').UserConfig} */
-module.exports = {
-  input: 'path/to/openapi.json',
-  output: 'src/client',
-}
-```
-
-or `openapi-ts.config.mjs`
-
-```mjs
-/** @type {import('@hey-api/openapi-ts').UserConfig} */
-export default {
-  input: 'path/to/openapi.json',
-  output: 'src/client',
-}
-```
-
-Alternatively, you can use `openapi-ts.config.js` and configure the export statement depending on your project setup.
-
-### Clients
-
-By default, `openapi-ts` will try to guess your client based on your project dependencies. If we don't get it right, you can specify the desired client
-
-```mjs
-/** @type {import('@hey-api/openapi-ts').UserConfig} */
-export default {
-  client: 'fetch',
-  input: 'path/to/openapi.json',
-  output: 'src/client',
-}
-```
-
-We support these clients:
-
-- [angular](https://angular.io/) (using [RxJS](https://rxjs.dev/))
-- [axios](https://axios-http.com/)
-- [fetch](https://developer.mozilla.org/docs/Web/API/Fetch_API)
-
-We also support the legacy Node.js and XHR clients:
-
-- [node](https://nodejs.org/) (using [node-fetch](https://www.npmjs.com/package/node-fetch))
-- [xhr](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest)
-
-> ⚠️ You might not need a `node` client. Fetch API is [experimental](https://nodejs.org/docs/latest-v18.x/api/globals.html#fetch) in Node.js v18 and [stable](https://nodejs.org/docs/latest-v21.x/api/globals.html#fetch) in Node.js v21. We recommend upgrading to the latest Node.js version.
-
-### Formatting
-
-By default, `openapi-ts` will automatically format your client according to your project configuration. To disable automatic formatting, set `format` to false
-
-```mjs
-/** @type {import('@hey-api/openapi-ts').UserConfig} */
-export default {
-  format: false,
-  input: 'path/to/openapi.json',
-  output: 'src/client',
-}
-```
-
-You can also prevent your client from being processed by formatters by adding your output path to the tool's ignore file (e.g. `.prettierignore`).
-
-### Linting
-
-For performance reasons, `openapi-ts` does not automatically lint your client. To enable this feature, set `lint` to true
-
-```mjs
-/** @type {import('@hey-api/openapi-ts').UserConfig} */
-export default {
-  input: 'path/to/openapi.json',
-  lint: true,
-  output: 'src/client',
-}
-```
-
-You can also prevent your client from being processed by linters by adding your output path to the tool's ignore file (e.g. `.eslintignore`).
-
-### Enums
-
-If you need to iterate through possible field values without manually typing arrays, you can export enums with
-
-```mjs
-/** @type {import('@hey-api/openapi-ts').UserConfig} */
-export default {
-  enums: 'javascript',
-  input: 'path/to/openapi.json',
-  output: 'src/client',
-}
-```
-
-This will export enums as plain JavaScript objects. For example, `Foo` would become
-
-```ts
-export const FooEnum = {
-  FOO: 'foo',
-  BAR: 'bar',
-} as const;
-```
-
-We discourage generating [TypeScript enums](https://www.typescriptlang.org/docs/handbook/enums.html) because they are not standard JavaScript and pose [typing challenges](https://dev.to/ivanzm123/dont-use-enums-in-typescript-they-are-very-dangerous-57bh). If you really need TypeScript enums, you can export them with
-
-```mjs
-/** @type {import('@hey-api/openapi-ts').UserConfig} */
-export default {
-  enums: 'typescript',
-  input: 'path/to/openapi.json',
-  output: 'src/client',
-}
-```
-
-### Config API
-
-You can view the complete list of options in the [UserConfig](./src/types/config.ts) interface.
-
-## Interceptors
-
-Interceptors (middleware) can be used to modify requests before they're sent or responses before they're returned to the rest of your application. Below is an example request interceptor
-
-```ts
-OpenAPI.interceptors.request.use((request) => {
-  doSomethingWithRequest(request)
-  return request // <-- must return request
-})
-```
-
-and an example response interceptor
-
-```ts
-OpenAPI.interceptors.response.use(async (response) => {
-  await doSomethingWithResponse(response) // async
-  return response // <-- must return response
-})
-```
-
-If you need to remove an interceptor, pass the same function to `OpenAPI.interceptors.request.eject()` or `OpenAPI.interceptors.response.eject()`.
-
-> ⚠️ Angular client does not currently support request interceptors.
-
-## Migrating
-
-While we try to avoid breaking changes, sometimes it's unavoidable in order to offer you the latest features.
-
-### v0.27.38
-
-### `useOptions: true`
-
-By default, generated clients will use a single object argument to pass values to API calls. This is a significant change from the previous default of unspecified array of arguments. If migrating your application in one go isn't feasible, we recommend deprecating your old client and generating a new client.
-
-```ts
-import { DefaultService } from 'client' // <-- old client with array arguments
-
-import { DefaultService } from 'client_v2' // <-- new client with options argument
-```
-
-This way, you can gradually switch over to the new syntax as you update parts of your code. Once you've removed all instances of `client` imports, you can safely delete the old `client` folder and find and replace all `client_v2` calls to `client`.
-
-## Contributing
-
-Please refer to the [contributing guide](CONTRIBUTING.md) for how to install the project for development purposes.