safetykit 0.29.0 → 0.30.0

data/rbi/safety_kit/models/beta/event_create_async_response.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    module Beta
+      class EventCreateAsyncResponse < SafetyKit::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SafetyKit::Models::Beta::EventCreateAsyncResponse,
+              SafetyKit::Internal::AnyHash
+            )
+          end
+
+        # Number of events queued from the request.
+        sig { returns(Integer) }
+        attr_accessor :queued_events
+
+        # Events were queued for asynchronous ingestion.
+        sig do
+          returns(
+            SafetyKit::Models::Beta::EventCreateAsyncResponse::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Response returned after SafetyKit queues one event or an ordered event batch.
+        sig do
+          params(
+            queued_events: Integer,
+            status:
+              SafetyKit::Models::Beta::EventCreateAsyncResponse::Status::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Number of events queued from the request.
+          queued_events:,
+          # Events were queued for asynchronous ingestion.
+          status:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              queued_events: Integer,
+              status:
+                SafetyKit::Models::Beta::EventCreateAsyncResponse::Status::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Events were queued for asynchronous ingestion.
+        module Status
+          extend SafetyKit::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                SafetyKit::Models::Beta::EventCreateAsyncResponse::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          QUEUED =
+            T.let(
+              :queued,
+              SafetyKit::Models::Beta::EventCreateAsyncResponse::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                SafetyKit::Models::Beta::EventCreateAsyncResponse::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/safety_kit/resources/beta/events.rbi

@@ -46,6 +46,45 @@ module SafetyKit
         )
         end
 
+        # Beta. Queue backend events for asynchronous ingestion. This endpoint accepts the
+        # same request body as POST /v1/events, writes one SQS message per event, and
+        # returns after the events are queued. SafetyKit later processes the queued events
+        # through the standard event ingestion path.
+        sig do
+          params(
+            body:
+              T.any(
+                SafetyKit::Beta::EventCreateAsyncParams::Body::UserContactEventRequest::OrHash,
+                SafetyKit::Beta::EventCreateAsyncParams::Body::ContentUploadedEventRequest::OrHash,
+                SafetyKit::Beta::EventCreateAsyncParams::Body::ProductChangedEventRequest::OrHash,
+                SafetyKit::Beta::EventCreateAsyncParams::Body::CreateAccountEventRequest::OrHash,
+                SafetyKit::Beta::EventCreateAsyncParams::Body::UpdateAccountEventRequest::OrHash,
+                SafetyKit::Beta::EventCreateAsyncParams::Body::UserReportEventRequest::OrHash,
+                SafetyKit::Beta::EventCreateAsyncParams::Body::ModerationDecisionEventRequest::OrHash,
+                T::Array[
+                  T.any(
+                    SafetyKit::Beta::EventCreateAsyncParams::Body::UnionMember7::UserContact::OrHash,
+                    SafetyKit::Beta::EventCreateAsyncParams::Body::UnionMember7::ContentUploaded::OrHash,
+                    SafetyKit::Beta::EventCreateAsyncParams::Body::UnionMember7::ProductChanged::OrHash,
+                    SafetyKit::Beta::EventCreateAsyncParams::Body::UnionMember7::CreateAccount::OrHash,
+                    SafetyKit::Beta::EventCreateAsyncParams::Body::UnionMember7::UpdateAccount::OrHash,
+                    SafetyKit::Beta::EventCreateAsyncParams::Body::UnionMember7::UserReport::OrHash,
+                    SafetyKit::Beta::EventCreateAsyncParams::Body::UnionMember7::ModerationDecision::OrHash
+                  )
+                ]
+              ),
+            request_options: SafetyKit::RequestOptions::OrHash
+          ).returns(SafetyKit::Models::Beta::EventCreateAsyncResponse)
+        end
+        def create_async(
+          # Backend event or ordered batch of events to send to SafetyKit. Send events from
+          # your server after an action has happened in your product. Do not send these
+          # events directly from a browser or mobile client.
+          body:,
+          request_options: {}
+        )
+        end
+
         # @api private
         sig { params(client: SafetyKit::Client).returns(T.attached_class) }
         def self.new(client:)