apiwork 0.4.0 → 0.5.0

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

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

@@ -25,6 +25,22 @@ module Apiwork
       #     param.enum_reference? # => false
       #   end
       class Integer < 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.
         #
@@ -49,6 +65,14 @@ module Apiwork
           @dump[:format]
         end
 
+        # @api public
+        # Whether this param is concrete.
+        #
+        # @return [Boolean]
+        def concrete?
+          true
+        end
+
         # @api public
         # Whether this param is scalar.
         #
@@ -119,7 +143,9 @@ module Apiwork
         # @return [Hash]
         def to_h
           result = super
+          result[:default] = default
           result[:enum] = enum if enum?
+          result[:example] = example
           result[:format] = format
           result[:max] = max
           result[:min] = min

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

@@ -24,6 +24,22 @@ module Apiwork
       #     param.enum_reference? # => false
       #   end
       class Number < 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