safetykit 0.57.0 → 0.59.0

data/lib/safety_kit/resources/content.rb

@@ -8,26 +8,26 @@ module SafetyKit
       # Some parameter documentations has been truncated, see
       # {SafetyKit::Models::ContentCreateParams} for more details.
       #
-      # Classify a piece of content synchronously. Send user-authored text, images, or
-      # both, and receive per-policy results in the response. Requests have a maximum
-      # size of 6MB.
+      # Classify a piece of content synchronously. Send text and image parts and receive
+      # per-label results in the response. Requests have a maximum size of 6MB. API
+      # version 2026-08-11; see the API versioning guide for superseded versions.
       #
       # Errors: 400 for an invalid body or images, with the failing field in the
       # message. 401 for a missing or invalid API key. 413 for requests over 6MB. 503
       # when classification is temporarily unavailable, in which case the request was
       # not processed and is safe to retry.
       #
-      # @overload create(user_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
+      # @overload create(content:, user_id:, content_id: nil, metadata: nil, safety_kit_version: nil, request_options: {})
       #
-      # @param user_id [String] Your stable identifier for the user this content belongs to.
+      # @param content [Array<SafetyKit::Models::ContentCreateParams::Content::UnionMember0, SafetyKit::Models::ContentCreateParams::Content::UnionMember1>] Body param: Content parts to classify together. At most 20 images.
       #
-      # @param content_id [String] Your content identifier.
+      # @param user_id [String] Body param: Your stable identifier for the user this content belongs to.
       #
-      # @param images [Array<String>] Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+      # @param content_id [String] Body param: Your content identifier.
       #
-      # @param metadata [Hash{Symbol=>Object, nil}] Additional product context for this content. At most 8KB when serialized.
+      # @param metadata [Hash{Symbol=>Object, nil}] Body param: Additional product context for this content. At most 8KB when serial
       #
-      # @param text [String] User-authored text to classify.
+      # @param safety_kit_version [Symbol, SafetyKit::Models::ContentCreateParams::SafetyKitVersion] Header param: The API version this operation is defined against.
       #
       # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -36,10 +36,12 @@ module SafetyKit
       # @see SafetyKit::Models::ContentCreateParams
       def create(params)
         parsed, options = SafetyKit::ContentCreateParams.dump_request(params)
+        header_params = {safety_kit_version: "safetykit-version"}
         @client.request(
           method: :post,
           path: "v1/content",
-          body: parsed,
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
           model: SafetyKit::Models::ContentCreateResponse,
           options: options
         )

data/lib/safety_kit/resources/data.rb

@@ -124,7 +124,7 @@ module SafetyKit
       #
       # @param namespace [String] The namespace to ingest data into
       #
-      # @param schema [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}] Schema mapping field names to their definitions. Use content_type to specify whi
+      # @param schema [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}] New schema to store for this namespace. Omit to leave the existing schema unchan
       #
       # @param settings [Hash{Symbol=>Object, nil}] Namespace settings to store, replacing existing settings. Omit to leave existing
       #

data/lib/safety_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SafetyKit
-  VERSION = "0.57.0"
+  VERSION = "0.59.0"
 end

data/rbi/safety_kit/models/content_create_params.rbi

@@ -11,6 +11,19 @@ module SafetyKit
           T.any(SafetyKit::ContentCreateParams, SafetyKit::Internal::AnyHash)
         end
 
+      # Content parts to classify together. At most 20 images.
+      sig do
+        returns(
+          T::Array[
+            T.any(
+              SafetyKit::ContentCreateParams::Content::UnionMember0,
+              SafetyKit::ContentCreateParams::Content::UnionMember1
+            )
+          ]
+        )
+      end
+      attr_accessor :content
+
       # Your stable identifier for the user this content belongs to.
       sig { returns(String) }
       attr_accessor :user_id
@@ -22,14 +35,6 @@ module SafetyKit
       sig { params(content_id: String).void }
       attr_writer :content_id
 
-      # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
-      # most 5MB each.
-      sig { returns(T.nilable(T::Array[String])) }
-      attr_reader :images
-
-      sig { params(images: T::Array[String]).void }
-      attr_writer :images
-
       # Additional product context for this content. At most 8KB when serialized.
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(T.anything)])) }
       attr_reader :metadata
@@ -37,35 +42,50 @@ module SafetyKit
       sig { params(metadata: T::Hash[Symbol, T.nilable(T.anything)]).void }
       attr_writer :metadata
 
-      # User-authored text to classify.
-      sig { returns(T.nilable(String)) }
-      attr_reader :text
+      # The API version this operation is defined against.
+      sig do
+        returns(
+          T.nilable(SafetyKit::ContentCreateParams::SafetyKitVersion::OrSymbol)
+        )
+      end
+      attr_reader :safety_kit_version
 
-      sig { params(text: String).void }
-      attr_writer :text
+      sig do
+        params(
+          safety_kit_version:
+            SafetyKit::ContentCreateParams::SafetyKitVersion::OrSymbol
+        ).void
+      end
+      attr_writer :safety_kit_version
 
       sig do
         params(
+          content:
+            T::Array[
+              T.any(
+                SafetyKit::ContentCreateParams::Content::UnionMember0::OrHash,
+                SafetyKit::ContentCreateParams::Content::UnionMember1::OrHash
+              )
+            ],
           user_id: String,
           content_id: String,
-          images: T::Array[String],
           metadata: T::Hash[Symbol, T.nilable(T.anything)],
-          text: String,
+          safety_kit_version:
+            SafetyKit::ContentCreateParams::SafetyKitVersion::OrSymbol,
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # Content parts to classify together. At most 20 images.
+        content:,
         # Your stable identifier for the user this content belongs to.
         user_id:,
         # Your content identifier.
         content_id: nil,
-        # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
-        # most 5MB each.
-        images: nil,
         # Additional product context for this content. At most 8KB when serialized.
         metadata: nil,
-        # User-authored text to classify.
-        text: nil,
+        # The API version this operation is defined against.
+        safety_kit_version: nil,
         request_options: {}
       )
       end
@@ -73,17 +93,334 @@ module SafetyKit
       sig do
         override.returns(
           {
+            content:
+              T::Array[
+                T.any(
+                  SafetyKit::ContentCreateParams::Content::UnionMember0,
+                  SafetyKit::ContentCreateParams::Content::UnionMember1
+                )
+              ],
             user_id: String,
             content_id: String,
-            images: T::Array[String],
             metadata: T::Hash[Symbol, T.nilable(T.anything)],
-            text: String,
+            safety_kit_version:
+              SafetyKit::ContentCreateParams::SafetyKitVersion::OrSymbol,
             request_options: SafetyKit::RequestOptions
           }
         )
       end
       def to_hash
       end
+
+      # One part of the submitted content.
+      module Content
+        extend SafetyKit::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              SafetyKit::ContentCreateParams::Content::UnionMember0,
+              SafetyKit::ContentCreateParams::Content::UnionMember1
+            )
+          end
+
+        class UnionMember0 < SafetyKit::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                SafetyKit::ContentCreateParams::Content::UnionMember0,
+                SafetyKit::Internal::AnyHash
+              )
+            end
+
+          # User-authored text to classify.
+          sig { returns(String) }
+          attr_accessor :text
+
+          sig do
+            returns(
+              SafetyKit::ContentCreateParams::Content::UnionMember0::Type::OrSymbol
+            )
+          end
+          attr_accessor :type
+
+          # Your name for where this part came from.
+          sig { returns(T.nilable(String)) }
+          attr_reader :key
+
+          sig { params(key: String).void }
+          attr_writer :key
+
+          sig do
+            params(
+              text: String,
+              type:
+                SafetyKit::ContentCreateParams::Content::UnionMember0::Type::OrSymbol,
+              key: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # User-authored text to classify.
+            text:,
+            type:,
+            # Your name for where this part came from.
+            key: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                text: String,
+                type:
+                  SafetyKit::ContentCreateParams::Content::UnionMember0::Type::OrSymbol,
+                key: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  SafetyKit::ContentCreateParams::Content::UnionMember0::Type
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TEXT =
+              T.let(
+                :text,
+                SafetyKit::ContentCreateParams::Content::UnionMember0::Type::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  SafetyKit::ContentCreateParams::Content::UnionMember0::Type::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        class UnionMember1 < SafetyKit::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                SafetyKit::ContentCreateParams::Content::UnionMember1,
+                SafetyKit::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              SafetyKit::ContentCreateParams::Content::UnionMember1::Source
+            )
+          end
+          attr_reader :source
+
+          sig do
+            params(
+              source:
+                SafetyKit::ContentCreateParams::Content::UnionMember1::Source::OrHash
+            ).void
+          end
+          attr_writer :source
+
+          sig do
+            returns(
+              SafetyKit::ContentCreateParams::Content::UnionMember1::Type::OrSymbol
+            )
+          end
+          attr_accessor :type
+
+          # Your name for where this part came from.
+          sig { returns(T.nilable(String)) }
+          attr_reader :key
+
+          sig { params(key: String).void }
+          attr_writer :key
+
+          sig do
+            params(
+              source:
+                SafetyKit::ContentCreateParams::Content::UnionMember1::Source::OrHash,
+              type:
+                SafetyKit::ContentCreateParams::Content::UnionMember1::Type::OrSymbol,
+              key: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            source:,
+            type:,
+            # Your name for where this part came from.
+            key: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                source:
+                  SafetyKit::ContentCreateParams::Content::UnionMember1::Source,
+                type:
+                  SafetyKit::ContentCreateParams::Content::UnionMember1::Type::OrSymbol,
+                key: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Source < SafetyKit::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  SafetyKit::ContentCreateParams::Content::UnionMember1::Source,
+                  SafetyKit::Internal::AnyHash
+                )
+              end
+
+            # Base64-encoded image bytes, raw or as a data URI. At most 5MB.
+            sig { returns(String) }
+            attr_accessor :data
+
+            sig do
+              returns(
+                SafetyKit::ContentCreateParams::Content::UnionMember1::Source::Type::OrSymbol
+              )
+            end
+            attr_accessor :type
+
+            sig do
+              params(
+                data: String,
+                type:
+                  SafetyKit::ContentCreateParams::Content::UnionMember1::Source::Type::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Base64-encoded image bytes, raw or as a data URI. At most 5MB.
+              data:,
+              type:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  data: String,
+                  type:
+                    SafetyKit::ContentCreateParams::Content::UnionMember1::Source::Type::OrSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module Type
+              extend SafetyKit::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    SafetyKit::ContentCreateParams::Content::UnionMember1::Source::Type
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              BASE64 =
+                T.let(
+                  :base64,
+                  SafetyKit::ContentCreateParams::Content::UnionMember1::Source::Type::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    SafetyKit::ContentCreateParams::Content::UnionMember1::Source::Type::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  SafetyKit::ContentCreateParams::Content::UnionMember1::Type
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            IMAGE =
+              T.let(
+                :image,
+                SafetyKit::ContentCreateParams::Content::UnionMember1::Type::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  SafetyKit::ContentCreateParams::Content::UnionMember1::Type::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[SafetyKit::ContentCreateParams::Content::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
+
+      # The API version this operation is defined against.
+      module SafetyKitVersion
+        extend SafetyKit::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, SafetyKit::ContentCreateParams::SafetyKitVersion)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SAFETY_KIT_VERSION_2026_08_11 =
+          T.let(
+            :"2026-08-11",
+            SafetyKit::ContentCreateParams::SafetyKitVersion::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              SafetyKit::ContentCreateParams::SafetyKitVersion::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end