knockapi 1.0.0 → 1.1.0

data/lib/knockapi/internal/type/base_model.rb

@@ -6,6 +6,7 @@ module Knockapi
       # @abstract
       class BaseModel
         extend Knockapi::Internal::Type::Converter
+        extend Knockapi::Internal::Util::SorbetRuntimeSupport
 
         class << self
           # @api private
@@ -13,11 +14,17 @@ module Knockapi
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
           #
-          # @return [Hash{Symbol=>Hash{Symbol=>Object}}]
-          def known_fields
-            @known_fields ||= (self < Knockapi::Internal::Type::BaseModel ? superclass.known_fields.dup : {})
+          # @param child [Class<Knockapi::Internal::Type::BaseModel>]
+          def inherited(child)
+            super
+            child.known_fields.replace(known_fields.dup)
           end
 
+          # @api private
+          #
+          # @return [Hash{Symbol=>Hash{Symbol=>Object}}]
+          def known_fields = @known_fields ||= {}
+
           # @api private
           #
           # @return [Hash{Symbol=>Hash{Symbol=>Object}}]
@@ -206,7 +213,7 @@ module Knockapi
           #
           #   @option state [Integer] :branched
           #
-          # @return [Knockapi::Internal::Type::BaseModel, Object]
+          # @return [self, Object]
           def coerce(value, state:)
             exactness = state.fetch(:exactness)
 
@@ -265,7 +272,7 @@ module Knockapi
 
           # @api private
           #
-          # @param value [Knockapi::Internal::Type::BaseModel, Object]
+          # @param value [self, Object]
           #
           # @param state [Hash{Symbol=>Object}] .
           #
@@ -306,6 +313,39 @@ module Knockapi
           end
         end
 
+        class << self
+          # @api private
+          #
+          # @param model [Knockapi::Internal::Type::BaseModel]
+          # @param convert [Boolean]
+          #
+          # @return [Hash{Symbol=>Object}]
+          def recursively_to_h(model, convert:)
+            rec = ->(x) do
+              case x
+              in Knockapi::Internal::Type::BaseModel
+                if convert
+                  fields = x.class.known_fields
+                  x.to_h.to_h do |key, val|
+                    [key, rec.call(fields.key?(key) ? x.public_send(key) : val)]
+                  rescue Knockapi::Errors::ConversionError
+                    [key, rec.call(val)]
+                  end
+                else
+                  rec.call(x.to_h)
+                end
+              in Hash
+                x.transform_values(&rec)
+              in Array
+                x.map(&rec)
+              else
+                x
+              end
+            end
+            rec.call(model)
+          end
+        end
+
         # @api public
         #
         # Returns the raw value associated with the given key, if found. Otherwise, nil is
@@ -342,9 +382,25 @@ module Knockapi
 
         alias_method :to_hash, :to_h
 
+        # @api public
+        #
+        # In addition to the behaviour of `#to_h`, this method will recursively call
+        # `#to_h` on nested models.
+        #
+        # @return [Hash{Symbol=>Object}]
+        def deep_to_h = self.class.recursively_to_h(@data, convert: false)
+
         # @param keys [Array<Symbol>, nil]
         #
         # @return [Hash{Symbol=>Object}]
+        #
+        # @example
+        #   # `condition` is a `Knockapi::Condition`
+        #   condition => {
+        #     argument: argument,
+        #     operator: operator,
+        #     variable: variable
+        #   }
         def deconstruct_keys(keys)
           (keys || self.class.known_fields.keys)
             .filter_map do |k|
@@ -357,29 +413,6 @@ module Knockapi
             .to_h
         end
 
-        class << self
-          # @api private
-          #
-          # @param model [Knockapi::Internal::Type::BaseModel]
-          #
-          # @return [Hash{Symbol=>Object}]
-          def walk(model)
-            walk = ->(x) do
-              case x
-              in Knockapi::Internal::Type::BaseModel
-                walk.call(x.to_h)
-              in Hash
-                x.transform_values(&walk)
-              in Array
-                x.map(&walk)
-              else
-                x
-              end
-            end
-            walk.call(model)
-          end
-        end
-
         # @api public
         #
         # @param a [Object]
@@ -397,15 +430,7 @@ module Knockapi
         # Create a new instance of a model.
         #
         # @param data [Hash{Symbol=>Object}, self]
-        def initialize(data = {})
-          case Knockapi::Internal::Util.coerce_hash(data)
-          in Hash => coerced
-            @data = coerced
-          else
-            message = "Expected a #{Hash} or #{Knockapi::Internal::Type::BaseModel}, got #{data.inspect}"
-            raise ArgumentError.new(message)
-          end
-        end
+        def initialize(data = {}) = (@data = Knockapi::Internal::Util.coerce_hash!(data).to_h)
 
         class << self
           # @api private
@@ -433,12 +458,19 @@ module Knockapi
         # @api public
         #
         # @return [String]
-        def to_s = self.class.walk(@data).to_s
+        def to_s = deep_to_h.to_s
 
         # @api private
         #
         # @return [String]
-        def inspect = "#<#{self.class}:0x#{object_id.to_s(16)} #{self}>"
+        def inspect
+          converted = self.class.recursively_to_h(self, convert: true)
+          "#<#{self.class}:0x#{object_id.to_s(16)} #{converted}>"
+        end
+
+        define_sorbet_constant!(:KnownField) do
+          T.type_alias { {mode: T.nilable(Symbol), required: T::Boolean, nilable: T::Boolean} }
+        end
       end
     end
   end

data/lib/knockapi/internal/type/converter.rb

@@ -5,6 +5,8 @@ module Knockapi
     module Type
       # @api private
       module Converter
+        extend Knockapi::Internal::Util::SorbetRuntimeSupport
+
         # rubocop:disable Lint/UnusedMethodArgument
 
         # @api private
@@ -268,6 +270,22 @@ module Knockapi
             end
           end
         end
+
+        define_sorbet_constant!(:Input) do
+          T.type_alias { T.any(Knockapi::Internal::Type::Converter, T::Class[T.anything]) }
+        end
+        define_sorbet_constant!(:CoerceState) do
+          T.type_alias do
+            {
+              strictness: T.any(T::Boolean, Symbol),
+              exactness: {yes: Integer, no: Integer, maybe: Integer},
+              branched: Integer
+            }
+          end
+        end
+        define_sorbet_constant!(:DumpState) do
+          T.type_alias { {can_retry: T::Boolean} }
+        end
       end
     end
   end

data/lib/knockapi/internal/type/enum.rb

@@ -17,6 +17,7 @@ module Knockapi
       # values safely.
       module Enum
         include Knockapi::Internal::Type::Converter
+        include Knockapi::Internal::Util::SorbetRuntimeSupport
 
         # All of the valid Symbol values for this enum.
         #

data/lib/knockapi/internal/type/hash_of.rb

@@ -29,7 +29,7 @@ module Knockapi
         #
         #   @option spec [Boolean] :"nil?"
         #
-        # @return [Knockapi::Internal::Type::HashOf]
+        # @return [self]
         def self.[](...) = new(...)
 
         # @api public

data/lib/knockapi/internal/type/request_parameters.rb

@@ -5,10 +5,10 @@ module Knockapi
     module Type
       # @api private
       module RequestParameters
-        # @!parse
-        #   # Options to specify HTTP behaviour for this request.
-        #   # @return [Knockapi::RequestOptions, Hash{Symbol=>Object}]
-        #   attr_accessor :request_options
+        # @!attribute request_options
+        # Options to specify HTTP behaviour for this request.
+        #
+        #   @return [Knockapi::RequestOptions, Hash{Symbol=>Object}]
 
         # @param mod [Module]
         def self.included(mod)
@@ -28,14 +28,8 @@ module Knockapi
             state = {can_retry: true}
             case (dumped = dump(params, state: state))
             in Hash
-              options = Knockapi::Internal::Util.coerce_hash(dumped[:request_options])
-              request_options =
-                case [options, state.fetch(:can_retry)]
-                in [Hash | nil, false]
-                  {**options.to_h, max_retries: 0}
-                else
-                  options
-                end
+              options = Knockapi::Internal::Util.coerce_hash!(dumped[:request_options]).to_h
+              request_options = state.fetch(:can_retry) ? options : {**options, max_retries: 0}
               [dumped.except(:request_options), request_options]
             else
               [dumped, nil]

data/lib/knockapi/internal/type/union.rb

@@ -6,17 +6,18 @@ module Knockapi
       # @api private
       #
       # @example
-      #   # `recipient` is a `Knockapi::Models::Recipient`
+      #   # `recipient` is a `Knockapi::Recipient`
       #   case recipient
-      #   when Knockapi::Models::User
+      #   when Knockapi::User
       #     puts(recipient.id)
-      #   when Knockapi::Models::Object
+      #   when Knockapi::Object
       #     puts(recipient._typename)
       #   else
       #     puts(recipient)
       #   end
       module Union
         include Knockapi::Internal::Type::Converter
+        include Knockapi::Internal::Util::SorbetRuntimeSupport
 
         # @api private
         #

data/lib/knockapi/internal/util.rb

@@ -128,6 +128,22 @@ module Knockapi
             input.respond_to?(:to_h) ? input.to_h : input
           end
         end
+
+        # @api private
+        #
+        # @param input [Object]
+        #
+        # @raise [ArgumentError]
+        # @return [Hash{Object=>Object}, nil]
+        def coerce_hash!(input)
+          case coerce_hash(input)
+          in Hash | nil => coerced
+            coerced
+          else
+            message = "Expected a #{Hash} or #{Knockapi::Internal::Type::BaseModel}, got #{data.inspect}"
+            raise ArgumentError.new(message)
+          end
+        end
       end
 
       class << self
@@ -454,7 +470,7 @@ module Knockapi
       # @type [Regexp]
       JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
       # @type [Regexp]
-      JSONL_CONTENT = %r{^application/(?:x-)?jsonl}
+      JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
         # @api private
@@ -519,7 +535,7 @@ module Knockapi
             filename = ERB::Util.url_encode(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(File.basename(val.to_path))
+            filename = ERB::Util.url_encode(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -785,6 +801,62 @@ module Knockapi
           end
         end
       end
+
+      # @api private
+      module SorbetRuntimeSupport
+        class MissingSorbetRuntimeError < ::RuntimeError
+        end
+
+        # @api private
+        #
+        # @return [Hash{Symbol=>Object}]
+        private def sorbet_runtime_constants = @sorbet_runtime_constants ||= {}
+
+        # @api private
+        #
+        # @param name [Symbol]
+        def const_missing(name)
+          super unless sorbet_runtime_constants.key?(name)
+
+          unless Object.const_defined?(:T)
+            message = "Trying to access a Sorbet constant #{name.inspect} without `sorbet-runtime`."
+            raise MissingSorbetRuntimeError.new(message)
+          end
+
+          sorbet_runtime_constants.fetch(name).call
+        end
+
+        # @api private
+        #
+        # @param name [Symbol]
+        # @param blk [Proc]
+        def define_sorbet_constant!(name, &blk) = sorbet_runtime_constants.store(name, blk)
+      end
+
+      extend Knockapi::Internal::Util::SorbetRuntimeSupport
+
+      define_sorbet_constant!(:ParsedUri) do
+        T.type_alias do
+          {
+            scheme: T.nilable(String),
+            host: T.nilable(String),
+            port: T.nilable(Integer),
+            path: T.nilable(String),
+            query: T::Hash[String, T::Array[String]]
+          }
+        end
+      end
+
+      define_sorbet_constant!(:ServerSentEvent) do
+        T.type_alias do
+          {
+            event: T.nilable(String),
+            data: T.nilable(String),
+            id: T.nilable(String),
+            retry: T.nilable(Integer)
+          }
+        end
+      end
     end
   end
 end

data/lib/knockapi/internal.rb

@@ -2,10 +2,16 @@
 
 module Knockapi
   module Internal
+    extend Knockapi::Internal::Util::SorbetRuntimeSupport
+
     OMIT =
       Object.new.tap do
         _1.define_singleton_method(:inspect) { "#<#{Knockapi::Internal}::OMIT>" }
       end
         .freeze
+
+    define_sorbet_constant!(:AnyHash) do
+      T.type_alias { T::Hash[Symbol, T.anything] }
+    end
   end
 end

data/lib/knockapi/models/activity.rb

@@ -19,8 +19,8 @@ module Knockapi
       # @!attribute actor
       #   A recipient of a notification, which is either a user or an object.
       #
-      #   @return [Knockapi::Models::User, Knockapi::Models::Object, nil]
-      optional :actor, union: -> { Knockapi::Models::Recipient }, nil?: true
+      #   @return [Knockapi::User, Knockapi::Object, nil]
+      optional :actor, union: -> { Knockapi::Recipient }, nil?: true
 
       # @!attribute data
       #   The workflow trigger `data` payload associated with the activity.
@@ -37,8 +37,8 @@ module Knockapi
       # @!attribute recipient
       #   A recipient of a notification, which is either a user or an object.
       #
-      #   @return [Knockapi::Models::User, Knockapi::Models::Object, nil]
-      optional :recipient, union: -> { Knockapi::Models::Recipient }
+      #   @return [Knockapi::User, Knockapi::Object, nil]
+      optional :recipient, union: -> { Knockapi::Recipient }
 
       # @!attribute updated_at
       #   Timestamp when the activity was last updated.
@@ -56,13 +56,13 @@ module Knockapi
       #
       #   @param _typename [String] The typename of the schema.
       #
-      #   @param actor [Knockapi::Models::User, Knockapi::Models::Object, nil] A recipient of a notification, which is either a user or an object.
+      #   @param actor [Knockapi::User, Knockapi::Object, nil] A recipient of a notification, which is either a user or an object.
       #
       #   @param data [Hash{Symbol=>Object}, nil] The workflow trigger `data` payload associated with the activity.
       #
       #   @param inserted_at [Time] Timestamp when the activity was created.
       #
-      #   @param recipient [Knockapi::Models::User, Knockapi::Models::Object] A recipient of a notification, which is either a user or an object.
+      #   @param recipient [Knockapi::User, Knockapi::Object] A recipient of a notification, which is either a user or an object.
       #
       #   @param updated_at [Time] Timestamp when the activity was last updated.
     end

data/lib/knockapi/models/audience_add_members_params.rb

@@ -10,20 +10,20 @@ module Knockapi
       # @!attribute members
       #   A list of audience members to add.
       #
-      #   @return [Array<Knockapi::Models::AudienceAddMembersParams::Member>]
-      required :members,
-               -> { Knockapi::Internal::Type::ArrayOf[Knockapi::Models::AudienceAddMembersParams::Member] }
+      #   @return [Array<Knockapi::AudienceAddMembersParams::Member>]
+      required :members, -> { Knockapi::Internal::Type::ArrayOf[Knockapi::AudienceAddMembersParams::Member] }
 
       # @!method initialize(members:, request_options: {})
-      #   @param members [Array<Knockapi::Models::AudienceAddMembersParams::Member>] A list of audience members to add.
+      #   @param members [Array<Knockapi::AudienceAddMembersParams::Member>] A list of audience members to add.
       #
       #   @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}]
 
       class Member < Knockapi::Internal::Type::BaseModel
         # @!attribute user
+        #   An object containing the user's ID.
         #
-        #   @return [Knockapi::Models::AudienceAddMembersParams::Member::User]
-        required :user, -> { Knockapi::Models::AudienceAddMembersParams::Member::User }
+        #   @return [Knockapi::AudienceAddMembersParams::Member::User]
+        required :user, -> { Knockapi::AudienceAddMembersParams::Member::User }
 
         # @!attribute tenant
         #   The unique identifier for the tenant.
@@ -34,11 +34,11 @@ module Knockapi
         # @!method initialize(user:, tenant: nil)
         #   An audience member.
         #
-        #   @param user [Knockapi::Models::AudienceAddMembersParams::Member::User]
+        #   @param user [Knockapi::AudienceAddMembersParams::Member::User] An object containing the user's ID.
         #
         #   @param tenant [String, nil] The unique identifier for the tenant.
 
-        # @see Knockapi::Models::AudienceAddMembersParams::Member#user
+        # @see Knockapi::AudienceAddMembersParams::Member#user
         class User < Knockapi::Internal::Type::BaseModel
           # @!attribute id
           #   The ID for the user that you set when identifying them in Knock.
@@ -47,6 +47,8 @@ module Knockapi
           optional :id, String
 
           # @!method initialize(id: nil)
+          #   An object containing the user's ID.
+          #
           #   @param id [String] The ID for the user that you set when identifying them in Knock.
         end
       end

data/lib/knockapi/models/audience_add_members_response.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Models
+    AudienceAddMembersResponse = String
+  end
+end

data/lib/knockapi/models/audience_list_members_response.rb

@@ -7,21 +7,21 @@ module Knockapi
       # @!attribute entries
       #   A list of audience members.
       #
-      #   @return [Array<Knockapi::Models::AudienceMember>]
-      required :entries, -> { Knockapi::Internal::Type::ArrayOf[Knockapi::Models::AudienceMember] }
+      #   @return [Array<Knockapi::AudienceMember>]
+      required :entries, -> { Knockapi::Internal::Type::ArrayOf[Knockapi::AudienceMember] }
 
       # @!attribute page_info
       #   Pagination information for a list of resources.
       #
-      #   @return [Knockapi::Models::PageInfo]
-      required :page_info, -> { Knockapi::Models::PageInfo }
+      #   @return [Knockapi::PageInfo]
+      required :page_info, -> { Knockapi::PageInfo }
 
       # @!method initialize(entries:, page_info:)
       #   A paginated list of audience members.
       #
-      #   @param entries [Array<Knockapi::Models::AudienceMember>] A list of audience members.
+      #   @param entries [Array<Knockapi::AudienceMember>] A list of audience members.
       #
-      #   @param page_info [Knockapi::Models::PageInfo] Pagination information for a list of resources.
+      #   @param page_info [Knockapi::PageInfo] Pagination information for a list of resources.
     end
   end
 end

data/lib/knockapi/models/audience_member.rb

@@ -20,8 +20,8 @@ module Knockapi
       #   receive notifications through Knock. Users are the most common recipients of
       #   notifications and are always referenced by your internal identifier.
       #
-      #   @return [Knockapi::Models::User]
-      required :user, -> { Knockapi::Models::User }
+      #   @return [Knockapi::User]
+      required :user, -> { Knockapi::User }
 
       # @!attribute user_id
       #   The ID for the user that you set when identifying them in Knock.
@@ -36,8 +36,8 @@ module Knockapi
       optional :tenant, String, nil?: true
 
       # @!method initialize(_typename:, added_at:, user:, user_id:, tenant: nil)
-      #   Some parameter documentations has been truncated, see
-      #   {Knockapi::Models::AudienceMember} for more details.
+      #   Some parameter documentations has been truncated, see {Knockapi::AudienceMember}
+      #   for more details.
       #
       #   An audience member.
       #
@@ -45,8 +45,7 @@ module Knockapi
       #
       #   @param added_at [Time] Timestamp when the resource was created.
       #
-      #   @param user [Knockapi::Models::User] A [User](/concepts/users) represents an individual in your system who can receiv
-      #   ...
+      #   @param user [Knockapi::User] A [User](/concepts/users) represents an individual in your system who can receiv
       #
       #   @param user_id [String] The ID for the user that you set when identifying them in Knock.
       #

data/lib/knockapi/models/audience_remove_members_params.rb

@@ -10,20 +10,23 @@ module Knockapi
       # @!attribute members
       #   A list of audience members to remove.
       #
-      #   @return [Array<Knockapi::Models::AudienceRemoveMembersParams::Member>]
+      #   @return [Array<Knockapi::AudienceRemoveMembersParams::Member>]
       required :members,
-               -> { Knockapi::Internal::Type::ArrayOf[Knockapi::Models::AudienceRemoveMembersParams::Member] }
+               -> {
+                 Knockapi::Internal::Type::ArrayOf[Knockapi::AudienceRemoveMembersParams::Member]
+               }
 
       # @!method initialize(members:, request_options: {})
-      #   @param members [Array<Knockapi::Models::AudienceRemoveMembersParams::Member>] A list of audience members to remove.
+      #   @param members [Array<Knockapi::AudienceRemoveMembersParams::Member>] A list of audience members to remove.
       #
       #   @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}]
 
       class Member < Knockapi::Internal::Type::BaseModel
         # @!attribute user
+        #   An object containing the user's ID.
         #
-        #   @return [Knockapi::Models::AudienceRemoveMembersParams::Member::User]
-        required :user, -> { Knockapi::Models::AudienceRemoveMembersParams::Member::User }
+        #   @return [Knockapi::AudienceRemoveMembersParams::Member::User]
+        required :user, -> { Knockapi::AudienceRemoveMembersParams::Member::User }
 
         # @!attribute tenant
         #   The unique identifier for the tenant.
@@ -34,11 +37,11 @@ module Knockapi
         # @!method initialize(user:, tenant: nil)
         #   An audience member.
         #
-        #   @param user [Knockapi::Models::AudienceRemoveMembersParams::Member::User]
+        #   @param user [Knockapi::AudienceRemoveMembersParams::Member::User] An object containing the user's ID.
         #
         #   @param tenant [String, nil] The unique identifier for the tenant.
 
-        # @see Knockapi::Models::AudienceRemoveMembersParams::Member#user
+        # @see Knockapi::AudienceRemoveMembersParams::Member#user
         class User < Knockapi::Internal::Type::BaseModel
           # @!attribute id
           #   The ID for the user that you set when identifying them in Knock.
@@ -47,6 +50,8 @@ module Knockapi
           optional :id, String
 
           # @!method initialize(id: nil)
+          #   An object containing the user's ID.
+          #
           #   @param id [String] The ID for the user that you set when identifying them in Knock.
         end
       end

data/lib/knockapi/models/audience_remove_members_response.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Models
+    AudienceRemoveMembersResponse = String
+  end
+end

data/lib/knockapi/models/bulk_operation.rb

@@ -43,8 +43,8 @@ module Knockapi
       # @!attribute status
       #   The status of the bulk operation.
       #
-      #   @return [Symbol, Knockapi::Models::BulkOperation::Status]
-      required :status, enum: -> { Knockapi::Models::BulkOperation::Status }
+      #   @return [Symbol, Knockapi::BulkOperation::Status]
+      required :status, enum: -> { Knockapi::BulkOperation::Status }
 
       # @!attribute success_count
       #   The number of successful operations.
@@ -73,9 +73,8 @@ module Knockapi
       # @!attribute error_items
       #   A list of items that failed to be processed.
       #
-      #   @return [Array<Knockapi::Models::BulkOperation::ErrorItem>, nil]
-      optional :error_items,
-               -> { Knockapi::Internal::Type::ArrayOf[Knockapi::Models::BulkOperation::ErrorItem] }
+      #   @return [Array<Knockapi::BulkOperation::ErrorItem>, nil]
+      optional :error_items, -> { Knockapi::Internal::Type::ArrayOf[Knockapi::BulkOperation::ErrorItem] }
 
       # @!attribute failed_at
       #   Timestamp when the bulk operation failed.
@@ -110,7 +109,7 @@ module Knockapi
       #
       #   @param processed_rows [Integer] The number of rows processed so far.
       #
-      #   @param status [Symbol, Knockapi::Models::BulkOperation::Status] The status of the bulk operation.
+      #   @param status [Symbol, Knockapi::BulkOperation::Status] The status of the bulk operation.
       #
       #   @param success_count [Integer] The number of successful operations.
       #
@@ -120,7 +119,7 @@ module Knockapi
       #
       #   @param error_count [Integer] The number of failed operations.
       #
-      #   @param error_items [Array<Knockapi::Models::BulkOperation::ErrorItem>] A list of items that failed to be processed.
+      #   @param error_items [Array<Knockapi::BulkOperation::ErrorItem>] A list of items that failed to be processed.
       #
       #   @param failed_at [Time, nil] Timestamp when the bulk operation failed.
       #
@@ -130,7 +129,7 @@ module Knockapi
 
       # The status of the bulk operation.
       #
-      # @see Knockapi::Models::BulkOperation#status
+      # @see Knockapi::BulkOperation#status
       module Status
         extend Knockapi::Internal::Type::Enum