feat: support boolean literal constraints

Author: razor-x

README.md

@@ -14,7 +14,9 @@ Please refer to the official [Seam Docs](https://docs.seam.co/latest/) to get st
 Parts of this SDK are generated from always up-to-date type information
 provided by [@seamapi/types](https://github.com/seamapi/types/).
 This ensures all API methods, request shapes, and response shapes are
-accurate and fully typed.
+accurate and fully typed. Ruby cannot statically enforce literal booleans, so
+the generated YARD types use `TrueClass` and `FalseClass` to document singleton
+constraints.
 
 <!-- toc -->
 

codegen/lib/handlebars-helpers.ts

@@ -34,10 +34,20 @@ const nullable = (
   value: { isOptional: boolean; isNullable: boolean },
 ): string => (value.isOptional || value.isNullable ? `${type}, nil` : type)
 
-const scalarType = (format: string, isInt = false): string => {
+const scalarType = (
+  format: string,
+  isInt = false,
+  booleanValues?: boolean[],
+): string => {
   switch (format) {
-    case 'boolean':
-      return 'Boolean'
+    case 'boolean': {
+      const values = [...new Set(booleanValues)]
+      return values.length === 1
+        ? values[0]
+          ? 'TrueClass'
+          : 'FalseClass'
+        : 'Boolean'
+    }
     case 'number':
       return isInt ? 'Integer' : 'Float'
     case 'datetime':
@@ -61,6 +71,7 @@ export const rubyPropertyType = (property: Property): string => {
       : scalarType(
           property.format,
           property.format === 'number' && property.isInt,
+          property.format === 'boolean' ? property.values : undefined,
         )
   // BaseResource normalizes response lists to [] even when the API sends nil.
   return nullable(
@@ -93,6 +104,7 @@ export const rubyParameterType = (parameter: Parameter): string => {
       : scalarType(
           parameter.format,
           parameter.format === 'number' && parameter.isInt,
+          parameter.format === 'boolean' ? parameter.values : undefined,
         )
   // Only a nullable parameter accepts the Seam::NULL sentinel, and only an
   // optional parameter accepts nil.

codegen/lib/merge-properties.ts

@@ -64,6 +64,19 @@ const mergeOccurrences = (occurrences: Property[], path: string): Property => {
     )
   }
 
+  if (first.format === 'boolean') {
+    const booleans = occurrences as Array<
+      Extract<Property, { format: 'boolean' }>
+    >
+    const values = booleans.some(({ values }) => values == null)
+      ? undefined
+      : [...new Set(booleans.flatMap(({ values }) => values ?? []))]
+    const merged = { ...first, ...docs }
+    if (values == null) delete merged.values
+    else merged.values = values
+    return merged
+  }
+
   if (first.format === 'object') {
     return {
       ...first,