OpenAPI Specification for Enums in Effect Typescript Library

cortopy · 2025-09-20T09:41:49.837Z

It seems that `Schema.Enums` are converted into a strange `anyOf` in OpenApi Specs when using `OpenApi.fromApi`. For this enum ```ts export enum DiscountKindEnum { PERCENTAGE = "PERCENTAGE", FREE_DELIVERY = "FREE_DELIVERY", } const kind = S.Enums(DiscountKindEnum) ``` I'm getting this in the generated OpenAPI spec ```json "kind": { "$comment": "/schemas/enums", "anyOf": [ { "type": "string", "title": "PERCENTAGE", "enum": [ "PERCENTAGE" ] }, { "type": "string", "title": "FREE_DELIVERY", "enum": [ "FREE_DELIVERY" ] } ] }, ``` which is weird and confuses cli code generators a lot. I would have expected that an enum maps to an enum. Is there a way to convert `Schema.Enums` to OpenApi enums?

It seems that

Schema.Enums

Schema.Enums

are converted into a strange

anyOf

anyOf

in OpenApi Specs when using

OpenApi.fromApi

OpenApi.fromApi

. For this enum

export enum DiscountKindEnum {
  PERCENTAGE = "PERCENTAGE",
  FREE_DELIVERY = "FREE_DELIVERY",
}

const kind = S.Enums(DiscountKindEnum)

export enum DiscountKindEnum {
  PERCENTAGE = "PERCENTAGE",
  FREE_DELIVERY = "FREE_DELIVERY",
}

const kind = S.Enums(DiscountKindEnum)

I'm getting this in the generated OpenAPI spec

"kind": {
  "$comment": "/schemas/enums",
  "anyOf": [
    {
      "type": "string",
      "title": "PERCENTAGE",
      "enum": [
        "PERCENTAGE"
      ]
    },
    {
      "type": "string",
      "title": "FREE_DELIVERY",
      "enum": [
        "FREE_DELIVERY"
      ]
    }
  ]
},

"kind": {
  "$comment": "/schemas/enums",
  "anyOf": [
    {
      "type": "string",
      "title": "PERCENTAGE",
      "enum": [
        "PERCENTAGE"
      ]
    },
    {
      "type": "string",
      "title": "FREE_DELIVERY",
      "enum": [
        "FREE_DELIVERY"
      ]
    }
  ]
},

which is weird and confuses cli code generators a lot. I would have expected that an enum maps to an enum. Is there a way to convert

Schema.Enums

Schema.Enums

to OpenApi enums?

Effect Community•7mo ago

cortopy

OpenAPI Specification for Enums in Effect Typescript Library

It seems that

Schema.Enums

Schema.Enums

are converted into a strange

anyOf

anyOf

in OpenApi Specs when using

OpenApi.fromApi

OpenApi.fromApi

. For this enum

export enum DiscountKindEnum {
  PERCENTAGE = "PERCENTAGE",
  FREE_DELIVERY = "FREE_DELIVERY",
}

const kind = S.Enums(DiscountKindEnum)

export enum DiscountKindEnum {
  PERCENTAGE = "PERCENTAGE",
  FREE_DELIVERY = "FREE_DELIVERY",
}

const kind = S.Enums(DiscountKindEnum)

I'm getting this in the generated OpenAPI spec

"kind": {
  "$comment": "/schemas/enums",
  "anyOf": [
    {
      "type": "string",
      "title": "PERCENTAGE",
      "enum": [
        "PERCENTAGE"
      ]
    },
    {
      "type": "string",
      "title": "FREE_DELIVERY",
      "enum": [
        "FREE_DELIVERY"
      ]
    }
  ]
},

"kind": {
  "$comment": "/schemas/enums",
  "anyOf": [
    {
      "type": "string",
      "title": "PERCENTAGE",
      "enum": [
        "PERCENTAGE"
      ]
    },
    {
      "type": "string",
      "title": "FREE_DELIVERY",
      "enum": [
        "FREE_DELIVERY"
      ]
    }
  ]
},

which is weird and confuses cli code generators a lot. I would have expected that an enum maps to an enum. Is there a way to convert

Schema.Enums

Schema.Enums

to OpenApi enums?

OpenAPI Specification for Enums in Effect Typescript Library

Similar Threads

OpenAPI Specification for Enums in Effect Typescript Library

Similar Threads

Similar Threads

Similar Threads