apiwork 0.4.0 → 0.6.0

data/lib/apiwork/export/type_script_mapper.rb

@@ -30,7 +30,7 @@ module Apiwork
           ts_type = map_field(param)
           optional_marker = param.optional? ? '?' : ''
 
-          prop_jsdoc = jsdoc(description: param.description, example: param.example)
+          prop_jsdoc = jsdoc(description: param.description, example: param.concrete? ? param.example : nil)
           if prop_jsdoc
             indented_jsdoc = prop_jsdoc.lines.map { |line| "  #{line.chomp}" }.join("\n")
             "#{indented_jsdoc}\n  #{key}#{optional_marker}: #{ts_type};"
@@ -165,6 +165,8 @@ module Apiwork
           map_object_type(param)
         elsif param.array?
           map_array_type(param)
+        elsif param.record?
+          map_record_type(param)
         elsif param.union?
           map_union_type(param)
         elsif param.literal?
@@ -207,8 +209,29 @@ module Apiwork
         end
       end
 
+      def map_record_type(param)
+        value_type = param.of ? map_param(param.of) : 'unknown'
+        "Record<string, #{value_type}>"
+      end
+
       def map_union_type(param)
-        param.variants.map { |variant| map_param(variant) }.sort.join(' | ')
+        variant_types = param.variants.map do |variant|
+          if param.discriminator && variant.tag && variant.object?
+            discriminator_prop = "#{@export.transform_key(param.discriminator)}: '#{variant.tag}'"
+            properties = variant.shape.sort_by { |name, _| name.to_s }.map do |name, field|
+              "#{@export.transform_key(name)}: #{map_field(field)}"
+            end
+            all_properties = [discriminator_prop, *properties].join('; ')
+            "{ #{all_properties} }"
+          elsif param.discriminator && variant.tag
+            base_type = map_param(variant)
+            "{ #{@export.transform_key(param.discriminator)}: '#{variant.tag}' } & #{base_type}"
+          else
+            map_param(variant)
+          end
+        end
+
+        variant_types.sort.join(' | ')
       end
 
       def map_literal_type(param)

data/lib/apiwork/export/zod.rb

@@ -7,6 +7,7 @@ module Apiwork
       output :string
       file_extension '.ts'
 
+      option :builders, default: false, type: :boolean
       option :version, default: '4', enum: %w[4], type: :string
 
       def generate
@@ -26,6 +27,14 @@ module Apiwork
           parts << ''
         end
 
+        if options[:builders]
+          builder_output = BuilderMapper.map(self, surface)
+          if builder_output.present?
+            parts << builder_output
+            parts << ''
+          end
+        end
+
         parts.join("\n")
       end
 

data/lib/apiwork/export/zod_mapper.rb

@@ -200,6 +200,8 @@ module Apiwork
           map_object_type(param)
         elsif param.array?
           map_array_type(param)
+        elsif param.record?
+          map_record_type(param)
         elsif param.union?
           map_union_type(param)
         elsif param.literal?
@@ -248,6 +250,11 @@ module Apiwork
         base
       end
 
+      def map_record_type(param)
+        value_schema = param.of ? map_param(param.of) : 'z.unknown()'
+        "z.record(z.string(), #{value_schema})"
+      end
+
       def map_union_type(param)
         if param.discriminator
           map_discriminated_union(param)
@@ -260,7 +267,21 @@ module Apiwork
       def map_discriminated_union(param)
         discriminator_field = @export.transform_key(param.discriminator)
 
-        variant_schemas = param.variants.map { |variant| map_param(variant) }
+        variant_schemas = param.variants.map do |variant|
+          if variant.tag && variant.object?
+            discriminator_prop = "#{discriminator_field}: z.literal('#{variant.tag}')"
+            properties = variant.shape.sort_by { |name, _| name.to_s }.map do |name, field|
+              "#{@export.transform_key(name)}: #{map_field(field)}"
+            end
+            all_properties = [discriminator_prop, *properties].join(', ')
+            "z.object({ #{all_properties} })"
+          elsif variant.tag
+            base_schema = map_param(variant)
+            "#{base_schema}.extend({ #{discriminator_field}: z.literal('#{variant.tag}') })"
+          else
+            map_param(variant)
+          end
+        end
 
         "z.discriminatedUnion('#{discriminator_field}', [#{variant_schemas.join(', ')}])"
       end

data/lib/apiwork/introspection/dump/action.rb

@@ -52,7 +52,7 @@ module Apiwork
 
         def build_response(response)
           return { body: {}, description: i18n_lookup(:response, :description), no_content: false } unless response
-          return { body: {}, description: response.description || i18n_lookup(:response, :description), no_content: true } if response.no_content?
+          return { body: nil, description: response.description || i18n_lookup(:response, :description), no_content: true } if response.no_content?
 
           description = response.description || i18n_lookup(:response, :description)
           body_shape = response.body

data/lib/apiwork/introspection/dump/param.rb

@@ -162,15 +162,28 @@ module Apiwork
 
           result = {
             reference:,
+            as: nil,
+            default: nil,
+            deprecated: false,
+            description: nil,
+            discriminator: nil,
             enum: element.enum,
+            example: nil,
             format: element.format,
             max: element.max,
             min: element.min,
+            nullable: false,
+            of: nil,
+            optional: false,
+            partial: false,
             shape: resolved_shape,
+            tag: nil,
             type: reference ? :reference : type_value,
+            value: nil,
+            variants: [],
           }
 
-          result[:of] = build_of_from_element(element.inner) if element.type == :array && element.inner
+          result[:of] = build_of_from_element(element.inner) if [:array, :record].include?(element.type) && element.inner
 
           result
         end
@@ -294,19 +307,39 @@ module Apiwork
           of = options[:of]
           return nil unless of
 
+          union = of.type == :union
+          union_shape = union && of.shape.is_a?(Apiwork::API::Union) ? of.shape : nil
+
           result = {
+            as: nil,
+            default: nil,
+            deprecated: false,
+            description: nil,
+            discriminator: union ? of.discriminator : nil,
             enum: of.enum,
+            example: nil,
             format: of.format,
             max: of.max,
             min: of.min,
+            nullable: false,
+            of: nil,
+            optional: false,
+            partial: false,
             reference: nil,
-            shape: of.shape ? build_nested_shape(of.shape) : {},
+            shape: union ? {} : build_of_shape(of),
+            tag: nil,
             type: of.type,
+            value: nil,
+            variants: union_shape ? union_shape.variants.map { |variant| build_api_variant(variant) } : [],
           }
           result[:of] = build_api_of({ of: of.inner }) if of.type == :array && of.inner
           result
         end
 
+        def build_of_shape(of)
+          of.shape ? build_nested_shape(of.shape) : {}
+        end
+
         def build_api_variant(variant)
           {
             as: nil,
@@ -320,7 +353,7 @@ module Apiwork
             max: nil,
             min: nil,
             nullable: false,
-            of: build_api_variant_of(variant),
+            of: build_api_of(variant),
             optional: false,
             partial: variant[:partial] == true,
             reference: nil,
@@ -332,23 +365,6 @@ module Apiwork
           }
         end
 
-        def build_api_variant_of(variant)
-          of = variant[:of]
-          return nil unless of
-
-          result = {
-            enum: of.enum,
-            format: of.format,
-            max: of.max,
-            min: of.min,
-            reference: nil,
-            shape: of.shape ? build_nested_shape(of.shape) : {},
-            type: of.type,
-          }
-          result[:of] = build_api_variant_of({ of: of.inner }) if of.type == :array && of.inner
-          result
-        end
-
         def build_shape(options)
           dumped = options[:shape] ? build_nested_shape(options[:shape]) : nil
 

data/lib/apiwork/introspection/dump/type.rb

@@ -4,6 +4,11 @@ module Apiwork
   module Introspection
     module Dump
       class Type
+        PRIMITIVE_TYPES = %i[
+          array binary boolean date datetime decimal enum float integer json
+          literal number object record string text time union unknown uuid
+        ].to_set.freeze
+
         def initialize(api_class)
           @api_class = api_class
         end
@@ -99,7 +104,11 @@ module Apiwork
         end
 
         def build_param(name, options, scope)
-          reference = resolve_type_reference(options[:type], scope)
+          reference = if options[:custom_type]
+                        resolve_type_reference(options[:custom_type], scope)
+                      elsif options[:type] && !PRIMITIVE_TYPES.include?(options[:type])
+                        resolve_type_reference(options[:type], scope)
+                      end
 
           {
             reference:,
@@ -142,7 +151,7 @@ module Apiwork
             max: nil,
             min: nil,
             nullable: false,
-            of: resolve_variant_of(variant, scope),
+            of: resolve_of(variant, scope),
             optional: false,
             partial: variant[:partial] == true,
             shape: build_nested_shape(variant[:shape]),
@@ -201,23 +210,41 @@ module Apiwork
           of = options[:of]
           return nil unless of
 
+          union = of.type == :union
+          union_shape = union && of.shape.is_a?(Apiwork::API::Union) ? of.shape : nil
           type_value = of.type
           scoped_name = resolve_scoped_type_name(type_value, scope)
-          resolved_shape = of.shape ? build_nested_shape(of.shape) : {}
 
           result = {
+            as: nil,
+            default: nil,
+            deprecated: false,
+            description: nil,
+            discriminator: union ? of.discriminator : nil,
             enum: of.enum,
+            example: nil,
             format: of.format,
             max: of.max,
             min: of.min,
+            nullable: false,
+            of: nil,
+            optional: false,
+            partial: false,
             reference: scoped_name,
-            shape: resolved_shape,
+            shape: union ? {} : resolve_of_shape(of),
+            tag: nil,
             type: scoped_name ? :reference : type_value,
+            value: nil,
+            variants: union_shape ? union_shape.variants.map { |variant| build_variant(variant, scope) } : [],
           }
           result[:of] = resolve_of({ of: of.inner }, scope) if of.type == :array && of.inner
           result
         end
 
+        def resolve_of_shape(of)
+          of.shape ? build_nested_shape(of.shape) : {}
+        end
+
         def resolve_variant_enum(variant, scope)
           return nil unless variant[:enum]
 
@@ -228,27 +255,6 @@ module Apiwork
           end
         end
 
-        def resolve_variant_of(variant, scope)
-          of = variant[:of]
-          return nil unless of
-
-          type_value = of.type
-          scoped_name = resolve_scoped_type_name(type_value, scope)
-          resolved_shape = of.shape ? build_nested_shape(of.shape) : {}
-
-          result = {
-            enum: of.enum,
-            format: of.format,
-            max: of.max,
-            min: of.min,
-            reference: scoped_name,
-            shape: resolved_shape,
-            type: scoped_name ? :reference : type_value,
-          }
-          result[:of] = resolve_variant_of({ of: of.inner }, scope) if of.type == :array && of.inner
-          result
-        end
-
         def build_enum(qualified_name, enum_definition)
           {
             deprecated: enum_definition.deprecated?,

data/lib/apiwork/introspection/param/array.rb

@@ -20,6 +20,22 @@ module Apiwork
       #   param.max # => 10 or nil
       #   param.boundable? # => true
       class Array < Base
+        # @api public
+        # The default for this param.
+        #
+        # @return [Object, nil]
+        def default
+          @dump[:default]
+        end
+
+        # @api public
+        # The example for this param.
+        #
+        # @return [Object, nil]
+        def example
+          @dump[:example]
+        end
+
         # @api public
         # The of for this param.
         #
@@ -62,6 +78,14 @@ module Apiwork
           true
         end
 
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          true
+        end
+
         # @api public
         # Whether this param is boundable.
         #
@@ -76,6 +100,8 @@ module Apiwork
         # @return [Hash]
         def to_h
           result = super
+          result[:default] = default
+          result[:example] = example
           result[:max] = max
           result[:min] = min
           result[:of] = of&.to_h

data/lib/apiwork/introspection/param/base.rb

@@ -48,22 +48,6 @@ module Apiwork
           @dump[:description]
         end
 
-        # @api public
-        # The example for this param.
-        #
-        # @return [Object, nil]
-        def example
-          @dump[:example]
-        end
-
-        # @api public
-        # The default for this param.
-        #
-        # @return [Object, nil]
-        def default
-          @dump[:default]
-        end
-
         # @api public
         # The tag for this param.
         #
@@ -72,6 +56,14 @@ module Apiwork
           @dump[:tag]
         end
 
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          false
+        end
+
         # @api public
         # Whether this param is scalar.
         #
@@ -96,6 +88,14 @@ module Apiwork
           false
         end
 
+        # @api public
+        # Whether this param is a record.
+        #
+        # @return [Boolean]
+        def record?
+          false
+        end
+
         # @api public
         # Whether this param is a union.
         #
@@ -262,10 +262,8 @@ module Apiwork
         # @return [Hash]
         def to_h
           {
-            default: default,
             deprecated: deprecated?,
             description: description,
-            example: example,
             nullable: nullable?,
             optional: optional?,
             type: type,

data/lib/apiwork/introspection/param/binary.rb

@@ -20,6 +20,30 @@ module Apiwork
       #     param.enum_reference? # => false
       #   end
       class Binary < Base
+        # @api public
+        # The default for this param.
+        #
+        # @return [Object, nil]
+        def default
+          @dump[:default]
+        end
+
+        # @api public
+        # The example for this param.
+        #
+        # @return [Object, nil]
+        def example
+          @dump[:example]
+        end
+
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          true
+        end
+
         # @api public
         # Whether this param is scalar.
         #
@@ -67,6 +91,18 @@ module Apiwork
         def formattable?
           false
         end
+
+        # @api public
+        # Converts this param to a hash.
+        #
+        # @return [Hash]
+        def to_h
+          result = super
+          result[:default] = default
+          result[:enum] = enum if enum?
+          result[:example] = example
+          result
+        end
       end
     end
   end

data/lib/apiwork/introspection/param/boolean.rb

@@ -20,6 +20,30 @@ module Apiwork
       #     param.enum_reference? # => false
       #   end
       class Boolean < Base
+        # @api public
+        # The default for this param.
+        #
+        # @return [Object, nil]
+        def default
+          @dump[:default]
+        end
+
+        # @api public
+        # The example for this param.
+        #
+        # @return [Object, nil]
+        def example
+          @dump[:example]
+        end
+
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          true
+        end
+
         # @api public
         # Whether this param is scalar.
         #
@@ -67,6 +91,18 @@ module Apiwork
         def formattable?
           false
         end
+
+        # @api public
+        # Converts this param to a hash.
+        #
+        # @return [Hash]
+        def to_h
+          result = super
+          result[:default] = default
+          result[:enum] = enum if enum?
+          result[:example] = example
+          result
+        end
       end
     end
   end

data/lib/apiwork/introspection/param/date.rb

@@ -20,6 +20,30 @@ module Apiwork
       #     param.enum_reference? # => false
       #   end
       class Date < Base
+        # @api public
+        # The default for this param.
+        #
+        # @return [Object, nil]
+        def default
+          @dump[:default]
+        end
+
+        # @api public
+        # The example for this param.
+        #
+        # @return [Object, nil]
+        def example
+          @dump[:example]
+        end
+
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          true
+        end
+
         # @api public
         # Whether this param is scalar.
         #
@@ -67,6 +91,18 @@ module Apiwork
         def formattable?
           false
         end
+
+        # @api public
+        # Converts this param to a hash.
+        #
+        # @return [Hash]
+        def to_h
+          result = super
+          result[:default] = default
+          result[:enum] = enum if enum?
+          result[:example] = example
+          result
+        end
       end
     end
   end

data/lib/apiwork/introspection/param/date_time.rb

@@ -20,6 +20,30 @@ module Apiwork
       #     param.enum_reference? # => false
       #   end
       class DateTime < Base
+        # @api public
+        # The default for this param.
+        #
+        # @return [Object, nil]
+        def default
+          @dump[:default]
+        end
+
+        # @api public
+        # The example for this param.
+        #
+        # @return [Object, nil]
+        def example
+          @dump[:example]
+        end
+
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          true
+        end
+
         # @api public
         # Whether this param is scalar.
         #
@@ -67,6 +91,18 @@ module Apiwork
         def formattable?
           false
         end
+
+        # @api public
+        # Converts this param to a hash.
+        #
+        # @return [Hash]
+        def to_h
+          result = super
+          result[:default] = default
+          result[:enum] = enum if enum?
+          result[:example] = example
+          result
+        end
       end
     end
   end

data/lib/apiwork/introspection/param/decimal.rb

@@ -24,6 +24,22 @@ module Apiwork
       #     param.enum_reference? # => false
       #   end
       class Decimal < Base
+        # @api public
+        # The default for this param.
+        #
+        # @return [Object, nil]
+        def default
+          @dump[:default]
+        end
+
+        # @api public
+        # The example for this param.
+        #
+        # @return [Object, nil]
+        def example
+          @dump[:example]
+        end
+
         # @api public
         # The minimum for this param.
         #
@@ -40,6 +56,14 @@ module Apiwork
           @dump[:max]
         end
 
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          true
+        end
+
         # @api public
         # Whether this param is scalar.
         #
@@ -110,7 +134,9 @@ module Apiwork
         # @return [Hash]
         def to_h
           result = super
+          result[:default] = default
           result[:enum] = enum if enum?
+          result[:example] = example
           result[:max] = max
           result[:min] = min
           result