{"id":29350138,"url":"https://github.com/zth/rescript-openapi-generator","last_synced_at":"2026-02-04T06:01:52.225Z","repository":{"id":301559922,"uuid":"1009639568","full_name":"zth/rescript-openapi-generator","owner":"zth","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-27T15:14:09.000Z","size":87,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-04T05:44:57.844Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"ReScript","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/zth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2025-06-27T13:11:45.000Z","updated_at":"2025-06-28T08:42:04.000Z","dependencies_parsed_at":"2025-06-27T14:28:05.049Z","dependency_job_id":"a72eaffa-adea-433e-b986-c993a54abd8c","html_url":"https://github.com/zth/rescript-openapi-generator","commit_stats":null,"previous_names":["zth/rescript-openapi-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zth/rescript-openapi-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zth%2Frescript-openapi-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zth%2Frescript-openapi-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zth%2Frescript-openapi-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zth%2Frescript-openapi-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zth","download_url":"https://codeload.github.com/zth/rescript-openapi-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zth%2Frescript-openapi-generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29072457,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T03:31:03.593Z","status":"ssl_error","status_checked_at":"2026-02-04T03:29:50.742Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2025-07-08T22:08:09.524Z","updated_at":"2026-02-04T06:01:52.168Z","avatar_url":"https://github.com/zth.png","language":"ReScript","readme":"# ReScript OpenAPI Generator\n\nGenerate a fully-typed, idiomatic ReScript client from any valid OpenAPI 2/3 specification. The generated output is ready-to-use in ReScript projects and comes with first-class encoders/decoders, endpoint helpers, and exhaustive type safety powered by `rescript-schema` and `rescript-rest`.\n\n---\n\n## Project Status\n\n🚧 **Early planning phase** – the repository currently contains documentation only. The implementation work will start once the initial design has been agreed upon (see [`IMPLEMENTATION_PLAN.md`](./IMPLEMENTATION_PLAN.md)). All APIs, file layouts, and generator options are subject to change.\n\n\u003e **AI-driven build** – this project doubles as an experiment in agent-assisted coding for ReScript. Wherever feasible, the codebase will be generated and evolved by AI tooling, with humans guiding high-level design and reviewing output.\n\n---\n\n## Motivation\n\nWorking with REST APIs should feel as effortless and type-safe as working with local modules. By generating strongly-typed bindings directly from an OpenAPI spec we can:\n\n1. **Eliminate runtime errors** caused by mismatched request/response shapes.\n2. **Provide auto-completion \u0026 refactor-safety** throughout the entire client surface.\n3. **Drastically reduce boilerplate** around HTTP calls, validation, and (de)serialization.\n4. **Guarantee schema compliance** via compile-time enforcement and exhaustive test suites.\n\n---\n\n## Building Blocks\n\nThe generator will leverage the following libraries:\n\n- **`rescript-openapi`** – typed representation of OpenAPI documents.\n- **`rescript-schema@9`** – value-level encoders \u0026 decoders derived from those types.\n- **`rescript-rest`** – higher-level combinators for describing REST endpoints.\n\nGenerated clients will be entirely dependency-free beyond these three libraries.\n\n---\n\n## Core Design Principles\n\n- **Idiomatic ReScript first** – prefer familiar ReScript constructs over generic code-gen artefacts.\n- **100 % type coverage** – every request, response, path parameter, and header is represented in the type system.\n- **Zero-config defaults, full-config power** – sensible defaults with room for advanced overrides.\n- **Test-driven development** – every behaviour will be backed by unit \u0026 integration tests.\n\n---\n\n## Contributing\n\nContributions are welcome! Please open an issue to discuss bugs, feature ideas, or questions. For larger changes, start with a design proposal so we can agree on direction before any code is written.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzth%2Frescript-openapi-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzth%2Frescript-openapi-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzth%2Frescript-openapi-generator/lists"}