{"id":13496283,"url":"https://github.com/ferdikoomen/openapi-typescript-codegen","last_synced_at":"2025-05-14T12:05:24.033Z","repository":{"id":37263663,"uuid":"219705144","full_name":"ferdikoomen/openapi-typescript-codegen","owner":"ferdikoomen","description":"NodeJS library that generates Typescript or Javascript clients based on the OpenAPI specification","archived":false,"fork":false,"pushed_at":"2025-05-05T21:46:30.000Z","size":25712,"stargazers_count":3183,"open_issues_count":251,"forks_count":534,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-05-07T11:41:53.123Z","etag":null,"topics":["angular","axios","codegen","generator","javascript","nodejs","openapi","swagger","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ferdikoomen.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["ferdikoomen"]}},"created_at":"2019-11-05T09:22:03.000Z","updated_at":"2025-05-07T10:10:18.000Z","dependencies_parsed_at":"2023-09-27T03:06:26.930Z","dependency_job_id":"07c64283-a01b-46a0-99e9-7fa04429edca","html_url":"https://github.com/ferdikoomen/openapi-typescript-codegen","commit_stats":{"total_commits":1938,"total_committers":59,"mean_commits":"32.847457627118644","dds":0.6233230134158927,"last_synced_commit":"f3c384dc4ea7bd33647bc494b92abb4c4c7110a0"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ferdikoomen%2Fopenapi-typescript-codegen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ferdikoomen%2Fopenapi-typescript-codegen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ferdikoomen%2Fopenapi-typescript-codegen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ferdikoomen%2Fopenapi-typescript-codegen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ferdikoomen","download_url":"https://codeload.github.com/ferdikoomen/openapi-typescript-codegen/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253411540,"owners_count":21904149,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","axios","codegen","generator","javascript","nodejs","openapi","swagger","typescript"],"created_at":"2024-07-31T19:01:45.057Z","updated_at":"2025-05-14T12:05:23.938Z","avatar_url":"https://github.com/ferdikoomen.png","language":"TypeScript","readme":"# Important announcement\n\n\u003e [!IMPORTANT] \n\u003e Please migrate your projects to use [@hey-api/openapi-ts](https://github.com/hey-api/openapi-ts)\n\nDue to time limitations on my end, this project has been unmaintained for a while now. The `@hey-api/openapi-ts`\nproject started as a fork with the goal to resolve the most pressing issues. going forward they are planning to\nmaintain the OpenAPI generator and give it the love it deserves. Please support them with their work and make\nsure to migrate your projects: https://heyapi.dev/openapi-ts/migrating.html#openapi-typescript-codegen\n\n- All open PR's and issues will be archived on the 1st of May 2024\n- All versions of this package will be deprecated in NPM\n\n👋 Thanks for all the support, downloads and love! Cheers Ferdi.\n\n---\n\n# OpenAPI Typescript Codegen\n\n[![NPM][npm-image]][npm-url]\n[![License][license-image]][license-url]\n[![Downloads][downloads-image]][downloads-url]\n[![Build][build-image]][build-url]\n\n\u003e Node.js library that generates Typescript clients based on the OpenAPI specification.\n\n## Why?\n- Frontend ❤️ OpenAPI, but we do not want to use JAVA codegen in our builds\n- Quick, lightweight, robust and framework-agnostic 🚀\n- Supports generation of TypeScript clients\n- Supports generations of Fetch, Node-Fetch, Axios, Angular and XHR http clients\n- Supports OpenAPI specification v2.0 and v3.0\n- Supports JSON and YAML files for input\n- Supports generation through CLI, Node.js and NPX\n- Supports tsc and @babel/plugin-transform-typescript\n- Supports aborting of requests (cancelable promise pattern)\n- Supports external references using [json-schema-ref-parser](https://github.com/APIDevTools/json-schema-ref-parser/)\n\n## Install\n\n```\nnpm install openapi-typescript-codegen --save-dev\n```\n\n## Usage\n\n```\n$ openapi --help\n\n  Usage: openapi [options]\n\n  Options:\n    -V, --version             output the version number\n    -i, --input \u003cvalue\u003e       OpenAPI specification, can be a path, url or string content (required)\n    -o, --output \u003cvalue\u003e      Output directory (required)\n    -c, --client \u003cvalue\u003e      HTTP client to generate [fetch, xhr, node, axios, angular] (default: \"fetch\")\n    --name \u003cvalue\u003e            Custom client class name\n    --useOptions              Use options instead of arguments\n    --useUnionTypes           Use union types instead of enums\n    --exportCore \u003cvalue\u003e      Write core files to disk (default: true)\n    --exportServices \u003cvalue\u003e  Write services to disk (default: true)\n    --exportModels \u003cvalue\u003e    Write models to disk (default: true)\n    --exportSchemas \u003cvalue\u003e   Write schemas to disk (default: false)\n    --indent \u003cvalue\u003e          Indentation options [4, 2, tab] (default: \"4\")\n    --postfixServices         Service name postfix (default: \"Service\")\n    --postfixModels           Model name postfix\n    --request \u003cvalue\u003e         Path to custom request file\n    -h, --help                display help for command\n\n  Examples\n    $ openapi --input ./spec.json --output ./generated\n    $ openapi --input ./spec.json --output ./generated --client xhr\n```\n\nDocumentation\n===\n\nThe main documentation can be found in the [openapi-typescript-codegen/wiki](https://github.com/ferdikoomen/openapi-typescript-codegen/wiki)\n\nSponsors\n===\n\nIf you or your company use the OpenAPI Typescript Codegen, please consider supporting me. By sponsoring I can free up time to give this project some love! Details can be found here: https://github.com/sponsors/ferdikoomen\n\nIf you're from an enterprise looking for a fully managed SDK generation, please consider our sponsor:\n\n\u003ca href=\"https://speakeasyapi.dev/?utm_source=ferdi+repo\u0026utm_medium=github+sponsorship\"\u003e\n    \u003cimg alt=\"speakeasy\" src=\"https://storage.googleapis.com/speakeasy-design-assets/ferdi-sponsorship.png\" width=\"640\"/\u003e\n\u003c/a\u003e\n\n[npm-url]: https://npmjs.org/package/openapi-typescript-codegen\n[npm-image]: https://img.shields.io/npm/v/openapi-typescript-codegen.svg\n[license-url]: LICENSE\n[license-image]: http://img.shields.io/npm/l/openapi-typescript-codegen.svg\n[coverage-url]: https://codecov.io/gh/ferdikoomen/openapi-typescript-codegen\n[coverage-image]: https://img.shields.io/codecov/c/github/ferdikoomen/openapi-typescript-codegen.svg\n[downloads-url]: http://npm-stat.com/charts.html?package=openapi-typescript-codegen\n[downloads-image]: http://img.shields.io/npm/dm/openapi-typescript-codegen.svg\n[build-url]: https://circleci.com/gh/ferdikoomen/openapi-typescript-codegen/tree/main\n[build-image]: https://circleci.com/gh/ferdikoomen/openapi-typescript-codegen/tree/main.svg?style=svg\n","funding_links":["https://github.com/sponsors/ferdikoomen"],"categories":["TypeScript","HarmonyOS","angular","Popular Frameworks","Full-Stack \u0026 Backend Tools"],"sub_categories":["Windows Manager","OpenAPI and Swagger Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fferdikoomen%2Fopenapi-typescript-codegen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fferdikoomen%2Fopenapi-typescript-codegen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fferdikoomen%2Fopenapi-typescript-codegen/lists"}