moderation_api 1.2.2 → 2.0.0

data/lib/moderation_api/internal.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Internal
+    extend ModerationAPI::Internal::Util::SorbetRuntimeSupport
+
+    OMIT =
+      Object.new.tap do
+        _1.define_singleton_method(:inspect) { "#<#{ModerationAPI::Internal}::OMIT>" }
+      end
+        .freeze
+
+    define_sorbet_constant!(:AnyHash) do
+      T.type_alias { T::Hash[Symbol, T.anything] }
+    end
+    define_sorbet_constant!(:FileInput) do
+      T.type_alias { T.any(Pathname, StringIO, IO, String, ModerationAPI::FilePart) }
+    end
+  end
+end

data/lib/moderation_api/models/account_list_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Models
+    # @see ModerationAPI::Resources::Account#list
+    class AccountListParams < ModerationAPI::Internal::Type::BaseModel
+      extend ModerationAPI::Internal::Type::RequestParameters::Converter
+      include ModerationAPI::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [ModerationAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/moderation_api/models/account_list_response.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Models
+    # @see ModerationAPI::Resources::Account#list
+    class AccountListResponse < ModerationAPI::Internal::Type::BaseModel
+      # @!attribute id
+      #   ID of the account
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute paid_plan_name
+      #   Name of the paid plan
+      #
+      #   @return [String]
+      required :paid_plan_name, String
+
+      # @!attribute remaining_quota
+      #   Remaining quota
+      #
+      #   @return [Float]
+      required :remaining_quota, Float
+
+      # @!attribute text_api_quota
+      #   Text API quota
+      #
+      #   @return [Float]
+      required :text_api_quota, Float
+
+      # @!attribute current_project
+      #
+      #   @return [ModerationAPI::Models::AccountListResponse::CurrentProject, nil]
+      optional :current_project, -> { ModerationAPI::Models::AccountListResponse::CurrentProject }
+
+      # @!method initialize(id:, paid_plan_name:, remaining_quota:, text_api_quota:, current_project: nil)
+      #   @param id [String] ID of the account
+      #
+      #   @param paid_plan_name [String] Name of the paid plan
+      #
+      #   @param remaining_quota [Float] Remaining quota
+      #
+      #   @param text_api_quota [Float] Text API quota
+      #
+      #   @param current_project [ModerationAPI::Models::AccountListResponse::CurrentProject]
+
+      # @see ModerationAPI::Models::AccountListResponse#current_project
+      class CurrentProject < ModerationAPI::Internal::Type::BaseModel
+        # @!attribute id
+        #   ID of the current project
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute name
+        #   Name of the current project
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(id:, name:)
+        #   @param id [String] ID of the current project
+        #
+        #   @param name [String] Name of the current project
+      end
+    end
+  end
+end

data/lib/moderation_api/models/action_create_params.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Models
+    # @see ModerationAPI::Resources::Actions#create
+    class ActionCreateParams < ModerationAPI::Internal::Type::BaseModel
+      extend ModerationAPI::Internal::Type::RequestParameters::Converter
+      include ModerationAPI::Internal::Type::RequestParameters
+
+      # @!attribute name
+      #   The name of the action.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute built_in
+      #   Whether the action is a built-in action or a custom one.
+      #
+      #   @return [Boolean, nil]
+      optional :built_in, ModerationAPI::Internal::Type::Boolean, api_name: :builtIn, nil?: true
+
+      # @!attribute description
+      #   The description of the action.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute filter_in_queue_ids
+      #   The IDs of the queues the action is available in.
+      #
+      #   @return [Array<String>, nil]
+      optional :filter_in_queue_ids,
+               ModerationAPI::Internal::Type::ArrayOf[String],
+               api_name: :filterInQueueIds
+
+      # @!attribute free_text
+      #   Whether the action allows any text to be entered as a value or if it must be one
+      #   of the possible values.
+      #
+      #   @return [Boolean, nil]
+      optional :free_text, ModerationAPI::Internal::Type::Boolean, api_name: :freeText
+
+      # @!attribute key
+      #   User defined key of the action.
+      #
+      #   @return [String, nil]
+      optional :key, String, nil?: true
+
+      # @!attribute position
+      #   Show the action in all queues, selected queues or no queues (to use via API
+      #   only).
+      #
+      #   @return [Symbol, ModerationAPI::Models::ActionCreateParams::Position, nil]
+      optional :position, enum: -> { ModerationAPI::ActionCreateParams::Position }
+
+      # @!attribute possible_values
+      #   The possible values of the action. The user will be prompted to select one of
+      #   these values when executing the action.
+      #
+      #   @return [Array<ModerationAPI::Models::ActionCreateParams::PossibleValue>, nil]
+      optional :possible_values,
+               -> {
+                 ModerationAPI::Internal::Type::ArrayOf[ModerationAPI::ActionCreateParams::PossibleValue]
+               },
+               api_name: :possibleValues
+
+      # @!attribute queue_behaviour
+      #   Whether the action resolves and removes the item, unresolves and re-add it to
+      #   the queue, or does not change the resolve status.
+      #
+      #   @return [Symbol, ModerationAPI::Models::ActionCreateParams::QueueBehaviour, nil]
+      optional :queue_behaviour,
+               enum: -> { ModerationAPI::ActionCreateParams::QueueBehaviour },
+               api_name: :queueBehaviour
+
+      # @!attribute type
+      #   The type of the action.
+      #
+      #   @return [Symbol, ModerationAPI::Models::ActionCreateParams::Type, nil]
+      optional :type, enum: -> { ModerationAPI::ActionCreateParams::Type }, nil?: true
+
+      # @!attribute value_required
+      #   Whether the action requires a value to be executed.
+      #
+      #   @return [Boolean, nil]
+      optional :value_required, ModerationAPI::Internal::Type::Boolean, api_name: :valueRequired
+
+      # @!attribute webhooks
+      #   The action's webhooks.
+      #
+      #   @return [Array<ModerationAPI::Models::ActionCreateParams::Webhook>, nil]
+      optional :webhooks,
+               -> { ModerationAPI::Internal::Type::ArrayOf[ModerationAPI::ActionCreateParams::Webhook] }
+
+      # @!method initialize(name:, built_in: nil, description: nil, filter_in_queue_ids: nil, free_text: nil, key: nil, position: nil, possible_values: nil, queue_behaviour: nil, type: nil, value_required: nil, webhooks: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ModerationAPI::Models::ActionCreateParams} for more details.
+      #
+      #   @param name [String] The name of the action.
+      #
+      #   @param built_in [Boolean, nil] Whether the action is a built-in action or a custom one.
+      #
+      #   @param description [String, nil] The description of the action.
+      #
+      #   @param filter_in_queue_ids [Array<String>] The IDs of the queues the action is available in.
+      #
+      #   @param free_text [Boolean] Whether the action allows any text to be entered as a value or if it must be one
+      #
+      #   @param key [String, nil] User defined key of the action.
+      #
+      #   @param position [Symbol, ModerationAPI::Models::ActionCreateParams::Position] Show the action in all queues, selected queues or no queues (to use via API only
+      #
+      #   @param possible_values [Array<ModerationAPI::Models::ActionCreateParams::PossibleValue>] The possible values of the action. The user will be prompted to select one of th
+      #
+      #   @param queue_behaviour [Symbol, ModerationAPI::Models::ActionCreateParams::QueueBehaviour] Whether the action resolves and removes the item, unresolves and re-add it to th
+      #
+      #   @param type [Symbol, ModerationAPI::Models::ActionCreateParams::Type, nil] The type of the action.
+      #
+      #   @param value_required [Boolean] Whether the action requires a value to be executed.
+      #
+      #   @param webhooks [Array<ModerationAPI::Models::ActionCreateParams::Webhook>] The action's webhooks.
+      #
+      #   @param request_options [ModerationAPI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Show the action in all queues, selected queues or no queues (to use via API
+      # only).
+      module Position
+        extend ModerationAPI::Internal::Type::Enum
+
+        ALL_QUEUES = :ALL_QUEUES
+        SOME_QUEUES = :SOME_QUEUES
+        HIDDEN = :HIDDEN
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class PossibleValue < ModerationAPI::Internal::Type::BaseModel
+        # @!attribute value
+        #   The value of the action.
+        #
+        #   @return [String]
+        required :value, String
+
+        # @!method initialize(value:)
+        #   @param value [String] The value of the action.
+      end
+
+      # Whether the action resolves and removes the item, unresolves and re-add it to
+      # the queue, or does not change the resolve status.
+      module QueueBehaviour
+        extend ModerationAPI::Internal::Type::Enum
+
+        REMOVE = :REMOVE
+        ADD = :ADD
+        NO_CHANGE = :NO_CHANGE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The type of the action.
+      module Type
+        extend ModerationAPI::Internal::Type::Enum
+
+        AUTHOR_BLOCK = :AUTHOR_BLOCK
+        AUTHOR_BLOCK_TEMP = :AUTHOR_BLOCK_TEMP
+        AUTHOR_UNBLOCK = :AUTHOR_UNBLOCK
+        AUTHOR_DELETE = :AUTHOR_DELETE
+        AUTHOR_REPORT = :AUTHOR_REPORT
+        AUTHOR_WARN = :AUTHOR_WARN
+        AUTHOR_CUSTOM = :AUTHOR_CUSTOM
+        ITEM_REJECT = :ITEM_REJECT
+        ITEM_ALLOW = :ITEM_ALLOW
+        ITEM_CUSTOM = :ITEM_CUSTOM
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class Webhook < ModerationAPI::Internal::Type::BaseModel
+        # @!attribute name
+        #   The webhook's name, used to identify it in the dashboard
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute url
+        #   The webhook's URL. We'll call this URL when the event occurs.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!attribute id
+        #   ID of an existing webhook or undefined if this is a new webhook.
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute description
+        #   The webhook's description
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!method initialize(name:, url:, id: nil, description: nil)
+        #   @param name [String] The webhook's name, used to identify it in the dashboard
+        #
+        #   @param url [String] The webhook's URL. We'll call this URL when the event occurs.
+        #
+        #   @param id [String] ID of an existing webhook or undefined if this is a new webhook.
+        #
+        #   @param description [String, nil] The webhook's description
+      end
+    end
+  end
+end

data/lib/moderation_api/models/action_create_response.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Models
+    # @see ModerationAPI::Resources::Actions#create
+    class ActionCreateResponse < ModerationAPI::Internal::Type::BaseModel
+      # @!attribute id
+      #   The ID of the action.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute built_in
+      #   Whether the action is a built-in action or a custom one.
+      #
+      #   @return [Boolean, nil]
+      required :built_in, ModerationAPI::Internal::Type::Boolean, api_name: :builtIn, nil?: true
+
+      # @!attribute created_at
+      #   The date the action was created.
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute filter_in_queue_ids
+      #   The IDs of the queues the action is available in.
+      #
+      #   @return [Array<String>]
+      required :filter_in_queue_ids,
+               ModerationAPI::Internal::Type::ArrayOf[String],
+               api_name: :filterInQueueIds
+
+      # @!attribute free_text
+      #   Whether the action allows any text to be entered as a value or if it must be one
+      #   of the possible values.
+      #
+      #   @return [Boolean]
+      required :free_text, ModerationAPI::Internal::Type::Boolean, api_name: :freeText
+
+      # @!attribute name
+      #   The name of the action.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute position
+      #   Show the action in all queues, selected queues or no queues (to use via API
+      #   only).
+      #
+      #   @return [Symbol, ModerationAPI::Models::ActionCreateResponse::Position]
+      required :position, enum: -> { ModerationAPI::Models::ActionCreateResponse::Position }
+
+      # @!attribute possible_values
+      #   The possible values of the action. The user will be prompted to select one of
+      #   these values when executing the action.
+      #
+      #   @return [Array<ModerationAPI::Models::ActionCreateResponse::PossibleValue>]
+      required :possible_values,
+               -> { ModerationAPI::Internal::Type::ArrayOf[ModerationAPI::Models::ActionCreateResponse::PossibleValue] },
+               api_name: :possibleValues
+
+      # @!attribute queue_behaviour
+      #   Whether the action resolves and removes the item, unresolves and re-add it to
+      #   the queue, or does not change the resolve status.
+      #
+      #   @return [Symbol, ModerationAPI::Models::ActionCreateResponse::QueueBehaviour]
+      required :queue_behaviour,
+               enum: -> { ModerationAPI::Models::ActionCreateResponse::QueueBehaviour },
+               api_name: :queueBehaviour
+
+      # @!attribute value_required
+      #   Whether the action requires a value to be executed.
+      #
+      #   @return [Boolean]
+      required :value_required, ModerationAPI::Internal::Type::Boolean, api_name: :valueRequired
+
+      # @!attribute description
+      #   The description of the action.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute key
+      #   User defined key of the action.
+      #
+      #   @return [String, nil]
+      optional :key, String, nil?: true
+
+      # @!attribute type
+      #   The type of the action.
+      #
+      #   @return [Symbol, ModerationAPI::Models::ActionCreateResponse::Type, nil]
+      optional :type, enum: -> { ModerationAPI::Models::ActionCreateResponse::Type }, nil?: true
+
+      # @!method initialize(id:, built_in:, created_at:, filter_in_queue_ids:, free_text:, name:, position:, possible_values:, queue_behaviour:, value_required:, description: nil, key: nil, type: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ModerationAPI::Models::ActionCreateResponse} for more details.
+      #
+      #   @param id [String] The ID of the action.
+      #
+      #   @param built_in [Boolean, nil] Whether the action is a built-in action or a custom one.
+      #
+      #   @param created_at [String] The date the action was created.
+      #
+      #   @param filter_in_queue_ids [Array<String>] The IDs of the queues the action is available in.
+      #
+      #   @param free_text [Boolean] Whether the action allows any text to be entered as a value or if it must be one
+      #
+      #   @param name [String] The name of the action.
+      #
+      #   @param position [Symbol, ModerationAPI::Models::ActionCreateResponse::Position] Show the action in all queues, selected queues or no queues (to use via API only
+      #
+      #   @param possible_values [Array<ModerationAPI::Models::ActionCreateResponse::PossibleValue>] The possible values of the action. The user will be prompted to select one of th
+      #
+      #   @param queue_behaviour [Symbol, ModerationAPI::Models::ActionCreateResponse::QueueBehaviour] Whether the action resolves and removes the item, unresolves and re-add it to th
+      #
+      #   @param value_required [Boolean] Whether the action requires a value to be executed.
+      #
+      #   @param description [String, nil] The description of the action.
+      #
+      #   @param key [String, nil] User defined key of the action.
+      #
+      #   @param type [Symbol, ModerationAPI::Models::ActionCreateResponse::Type, nil] The type of the action.
+
+      # Show the action in all queues, selected queues or no queues (to use via API
+      # only).
+      #
+      # @see ModerationAPI::Models::ActionCreateResponse#position
+      module Position
+        extend ModerationAPI::Internal::Type::Enum
+
+        ALL_QUEUES = :ALL_QUEUES
+        SOME_QUEUES = :SOME_QUEUES
+        HIDDEN = :HIDDEN
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class PossibleValue < ModerationAPI::Internal::Type::BaseModel
+        # @!attribute value
+        #   The value of the action.
+        #
+        #   @return [String]
+        required :value, String
+
+        # @!method initialize(value:)
+        #   @param value [String] The value of the action.
+      end
+
+      # Whether the action resolves and removes the item, unresolves and re-add it to
+      # the queue, or does not change the resolve status.
+      #
+      # @see ModerationAPI::Models::ActionCreateResponse#queue_behaviour
+      module QueueBehaviour
+        extend ModerationAPI::Internal::Type::Enum
+
+        REMOVE = :REMOVE
+        ADD = :ADD
+        NO_CHANGE = :NO_CHANGE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The type of the action.
+      #
+      # @see ModerationAPI::Models::ActionCreateResponse#type
+      module Type
+        extend ModerationAPI::Internal::Type::Enum
+
+        AUTHOR_BLOCK = :AUTHOR_BLOCK
+        AUTHOR_BLOCK_TEMP = :AUTHOR_BLOCK_TEMP
+        AUTHOR_UNBLOCK = :AUTHOR_UNBLOCK
+        AUTHOR_DELETE = :AUTHOR_DELETE
+        AUTHOR_REPORT = :AUTHOR_REPORT
+        AUTHOR_WARN = :AUTHOR_WARN
+        AUTHOR_CUSTOM = :AUTHOR_CUSTOM
+        ITEM_REJECT = :ITEM_REJECT
+        ITEM_ALLOW = :ITEM_ALLOW
+        ITEM_CUSTOM = :ITEM_CUSTOM
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/moderation_api/models/action_delete_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Models
+    # @see ModerationAPI::Resources::Actions#delete
+    class ActionDeleteParams < ModerationAPI::Internal::Type::BaseModel
+      extend ModerationAPI::Internal::Type::RequestParameters::Converter
+      include ModerationAPI::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [ModerationAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/moderation_api/models/action_delete_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Models
+    # @see ModerationAPI::Resources::Actions#delete
+    class ActionDeleteResponse < ModerationAPI::Internal::Type::BaseModel
+      # @!attribute id
+      #   The ID of the action.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute deleted
+      #   Whether the action was deleted.
+      #
+      #   @return [Boolean]
+      required :deleted, ModerationAPI::Internal::Type::Boolean
+
+      # @!method initialize(id:, deleted:)
+      #   @param id [String] The ID of the action.
+      #
+      #   @param deleted [Boolean] Whether the action was deleted.
+    end
+  end
+end

data/lib/moderation_api/models/action_list_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module ModerationAPI
+  module Models
+    # @see ModerationAPI::Resources::Actions#list
+    class ActionListParams < ModerationAPI::Internal::Type::BaseModel
+      extend ModerationAPI::Internal::Type::RequestParameters::Converter
+      include ModerationAPI::Internal::Type::RequestParameters
+
+      # @!attribute queue_id
+      #
+      #   @return [String, nil]
+      optional :queue_id, String
+
+      # @!method initialize(queue_id: nil, request_options: {})
+      #   @param queue_id [String]
+      #   @param request_options [ModerationAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end