rescript-openapi 0.1.0

Generate type-safe ReScript clients from OpenAPI specifications
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

;; SPDX-License-Identifier: PMPL-1.0-or-later
;; rescript-openapi project state

(state
  (metadata
    (version "0.1.0")
    (schema-version "1.0")
    (created "2025-01-05")
    (updated "2026-03-03")
    (project "rescript-openapi")
    (repo "github.com/hyperpolymath/rescript-openapi"))

  (project-context
    (name "rescript-openapi")
    (tagline "Generate type-safe ReScript clients from OpenAPI specifications")
    (tech-stack rust rescript openapi))

  (current-position
    (phase "release-ready")
    (overall-completion 95)
    (components
      (parser 100 "OpenAPI 3.x parsing via openapiv3 crate")
      (ir 100 "Intermediate representation with keyword escaping, inline enums, oneOf/anyOf")
      (types-codegen 100 "ReScript type generation with variants and polymorphic variants")
      (schema-codegen 100 "rescript-schema v9 validators with topological sorting")
      (client-codegen 100 "HTTP client with @glennsl/rescript-fetch, auth support")
      (cli 100 "clap CLI with generate/validate/info, --watch, --dry-run"))
    (working-features
      "CLI with generate/validate/info subcommands"
      "OpenAPI 3.x parsing (JSON/YAML)"
      "Type generation with dependency ordering"
      "Reserved keyword escaping (type -> type_)"
      "Inline string enum to polymorphic variant"
      "oneOf/anyOf to ReScript variant types"
      "Schema validator generation with S.union"
      "HTTP client with functor pattern"
      "Authentication (Bearer token, API key)"
      "File watching with --watch flag"
      "Dry run with --dry-run flag"
      "Snapshot tests with insta (12 tests passing, 13 snapshots)"))

  (route-to-mvp
    (milestone "m1-compiles" (status completed)
      (items
        "Fix compilation errors"
        "Add missing imports"))
    (milestone "m2-basic-generation" (status completed)
      (items
        "Test with petstore.yaml"
        "Generate valid ReScript code"
        "Fix type keyword conflict"
        "Fix inline string enum detection"))
    (milestone "m3-advanced-features" (status completed)
      (items
        "oneOf/anyOf variant support"
        "Auth header injection"
        "CLI enhancements (--watch, --dry-run)"
        "Complex test fixtures"
        "Security audit (cargo-audit)"
        "Performance testing (<10ms)"))
    (milestone "m4-release" (status pending)
      (items
        "cargo login and cargo publish")))

  (blockers-and-issues
    (critical)
    (high)
    (medium)
    (low
      "Consider adding openapi 3.1 support"
      "Consider discriminator support for oneOf"))

  (critical-next-actions
    (immediate
      "Run cargo login and cargo publish")
    (this-week
      "Announce release"
      "Add to rescript-full-stack ecosystem")
    (this-month
      "Gather user feedback"
      "Consider v0.2.0 features"))

  (session-history
    (session "2026-01-05-initial"
      (accomplishments
        "Fixed reserved keyword escaping (type -> type_)"
        "Added inline string enum support"
        "Generated polymorphic variants for string enums"
        "Starred all 426 hyperpolymath repos"))
    (session "2026-01-05-features"
      (accomplishments
        "Added oneOf/anyOf variant type support"
        "Added auth header injection (Bearer, API key)"
        "Added CLI --watch and --dry-run flags"
        "Created complex.yaml test fixture"
        "Security audit passed (0 vulnerabilities)"
        "Performance tested (<10ms generation)"
        "All 6 tests passing"
        "Ready for crates.io publish"))
    (session "2026-02-24-dual-track"
      (accomplishments
        "Implemented dual-track architecture (OOTB vs Streamlined)"
        "Added --client-mode flag (full, functor-only, none)"
        "Added --unified flag for single-module output"
        "Added --variant-mode flag (polymorphic, standard)"
        "Added rescript-openapi.toml project config support"
        "ADR-001: Dual-Track Generation Architecture documented"
        "All 12 tests passing, 13 snapshots"))
    (session "2026-03-03-cleanup"
      (accomplishments
        "Fixed 3 clippy warnings (collapsible if-let, unused param, too-many-args)"
        "Removed dead codegen::generate function"
        "Fixed duplicate StringEnum branches in RsType::to_rescript"
        "Fixed all SPDX copyright headers (2025 Hyperpolymath -> 2026 Jonathan D.A. Jewell)"
        "Fixed Cargo.toml author attribution"
        "Updated README with missing CLI flags"
        "Fixed README module import (RescriptSchema -> RescriptSchema.S)"
        "Added SPDX header to DECISIONS.md"
        "Updated STATE.scm with correct test counts and session history"))))