moonbase-sdk 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.3

data/rbi/moonbase/models/email_message.rbi

@@ -12,25 +12,49 @@ module Moonbase
       sig { returns(String) }
       attr_accessor :id
 
-      sig { returns(Moonbase::EmailMessage::Links) }
-      attr_reader :links
+      # Structured content that can be rendered in multiple formats, currently
+      # supporting Markdown.
+      sig { returns(Moonbase::FormattedText) }
+      attr_reader :body
 
-      sig { params(links: Moonbase::EmailMessage::Links::OrHash).void }
-      attr_writer :links
+      sig { params(body: Moonbase::FormattedText::OrHash).void }
+      attr_writer :body
 
-      # The globally unique `Message-ID` header of the email.
-      sig { returns(String) }
-      attr_accessor :rfc822_message_id
+      # `true` if the message appears to be part of a bulk mailing.
+      sig { returns(T::Boolean) }
+      attr_accessor :bulk
+
+      # The time the message was received, as an ISO 8601 timestamp in UTC.
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      # `true` if the message is a draft that has not been sent.
+      sig { returns(T::Boolean) }
+      attr_accessor :draft
+
+      # `true` if the message is classified as spam.
+      sig { returns(T::Boolean) }
+      attr_accessor :spam
 
       # The subject line of the email.
       sig { returns(String) }
       attr_accessor :subject
 
+      # `true` if the message is in the trash.
+      sig { returns(T::Boolean) }
+      attr_accessor :trash
+
       # String representing the object’s type. Always `email_message` for this object.
       sig { returns(Symbol) }
       attr_accessor :type
 
+      # `true` if the message has not been read.
+      sig { returns(T::Boolean) }
+      attr_accessor :unread
+
       # A list of `Address` objects associated with the message (sender and recipients).
+      #
+      # **Note:** Only present when requested using the `include` query parameter.
       sig { returns(T.nilable(T::Array[Moonbase::Address])) }
       attr_reader :addresses
 
@@ -38,6 +62,8 @@ module Moonbase
       attr_writer :addresses
 
       # A list of `Attachment` objects on the message.
+      #
+      # **Note:** Only present when requested using the `include` query parameter.
       sig { returns(T.nilable(T::Array[Moonbase::EmailMessage::Attachment])) }
       attr_reader :attachments
 
@@ -48,62 +74,15 @@ module Moonbase
       end
       attr_writer :attachments
 
-      # The HTML content of the email body.
-      sig { returns(T.nilable(String)) }
-      attr_reader :body_html
-
-      sig { params(body_html: String).void }
-      attr_writer :body_html
-
-      # The plain text content of the email body.
-      sig { returns(T.nilable(String)) }
-      attr_reader :body_plain
-
-      sig { params(body_plain: String).void }
-      attr_writer :body_plain
-
-      # `true` if the message appears to be part of a bulk mailing.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_reader :bulk
-
-      sig { params(bulk: T::Boolean).void }
-      attr_writer :bulk
-
       # The `Conversation` thread this message is part of.
+      #
+      # **Note:** Only present when requested using the `include` query parameter.
       sig { returns(T.nilable(Moonbase::InboxConversation)) }
       attr_reader :conversation
 
-      sig { params(conversation: Moonbase::InboxConversation::OrHash).void }
+      sig { params(conversation: Moonbase::InboxConversation).void }
       attr_writer :conversation
 
-      # The time the message was received, as an RFC 3339 timestamp.
-      sig { returns(T.nilable(Time)) }
-      attr_reader :created_at
-
-      sig { params(created_at: Time).void }
-      attr_writer :created_at
-
-      # `true` if the message is a draft that has not been sent.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_reader :draft
-
-      sig { params(draft: T::Boolean).void }
-      attr_writer :draft
-
-      # The `Message-ID` of the email this message is a reply to.
-      sig { returns(T.nilable(String)) }
-      attr_reader :in_reply_to_rfc822_message_id
-
-      sig { params(in_reply_to_rfc822_message_id: String).void }
-      attr_writer :in_reply_to_rfc822_message_id
-
-      # `true` if the message is classified as spam.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_reader :spam
-
-      sig { params(spam: T::Boolean).void }
-      attr_writer :spam
-
       # A concise, system-generated summary of the email content.
       sig { returns(T.nilable(String)) }
       attr_reader :summary
@@ -111,77 +90,59 @@ module Moonbase
       sig { params(summary: String).void }
       attr_writer :summary
 
-      # `true` if the message is in the trash.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_reader :trash
-
-      sig { params(trash: T::Boolean).void }
-      attr_writer :trash
-
-      # `true` if the message has not been read.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_reader :unread
-
-      sig { params(unread: T::Boolean).void }
-      attr_writer :unread
-
       # The Email Message object represents a single email within a `Conversation`.
       sig do
         params(
           id: String,
-          links: Moonbase::EmailMessage::Links::OrHash,
-          rfc822_message_id: String,
-          subject: String,
-          addresses: T::Array[Moonbase::Address::OrHash],
-          attachments: T::Array[Moonbase::EmailMessage::Attachment::OrHash],
-          body_html: String,
-          body_plain: String,
+          body: Moonbase::FormattedText::OrHash,
           bulk: T::Boolean,
-          conversation: Moonbase::InboxConversation::OrHash,
           created_at: Time,
           draft: T::Boolean,
-          in_reply_to_rfc822_message_id: String,
           spam: T::Boolean,
-          summary: String,
+          subject: String,
           trash: T::Boolean,
           unread: T::Boolean,
+          addresses: T::Array[Moonbase::Address::OrHash],
+          attachments: T::Array[Moonbase::EmailMessage::Attachment::OrHash],
+          conversation: Moonbase::InboxConversation,
+          summary: String,
           type: Symbol
         ).returns(T.attached_class)
       end
       def self.new(
         # Unique identifier for the object.
         id:,
-        links:,
-        # The globally unique `Message-ID` header of the email.
-        rfc822_message_id:,
+        # Structured content that can be rendered in multiple formats, currently
+        # supporting Markdown.
+        body:,
+        # `true` if the message appears to be part of a bulk mailing.
+        bulk:,
+        # The time the message was received, as an ISO 8601 timestamp in UTC.
+        created_at:,
+        # `true` if the message is a draft that has not been sent.
+        draft:,
+        # `true` if the message is classified as spam.
+        spam:,
         # The subject line of the email.
         subject:,
+        # `true` if the message is in the trash.
+        trash:,
+        # `true` if the message has not been read.
+        unread:,
         # A list of `Address` objects associated with the message (sender and recipients).
+        #
+        # **Note:** Only present when requested using the `include` query parameter.
         addresses: nil,
         # A list of `Attachment` objects on the message.
+        #
+        # **Note:** Only present when requested using the `include` query parameter.
         attachments: nil,
-        # The HTML content of the email body.
-        body_html: nil,
-        # The plain text content of the email body.
-        body_plain: nil,
-        # `true` if the message appears to be part of a bulk mailing.
-        bulk: nil,
         # The `Conversation` thread this message is part of.
+        #
+        # **Note:** Only present when requested using the `include` query parameter.
         conversation: nil,
-        # The time the message was received, as an RFC 3339 timestamp.
-        created_at: nil,
-        # `true` if the message is a draft that has not been sent.
-        draft: nil,
-        # The `Message-ID` of the email this message is a reply to.
-        in_reply_to_rfc822_message_id: nil,
-        # `true` if the message is classified as spam.
-        spam: nil,
         # A concise, system-generated summary of the email content.
         summary: nil,
-        # `true` if the message is in the trash.
-        trash: nil,
-        # `true` if the message has not been read.
-        unread: nil,
         # String representing the object’s type. Always `email_message` for this object.
         type: :email_message
       )
@@ -191,59 +152,25 @@ module Moonbase
         override.returns(
           {
             id: String,
-            links: Moonbase::EmailMessage::Links,
-            rfc822_message_id: String,
-            subject: String,
-            type: Symbol,
-            addresses: T::Array[Moonbase::Address],
-            attachments: T::Array[Moonbase::EmailMessage::Attachment],
-            body_html: String,
-            body_plain: String,
+            body: Moonbase::FormattedText,
             bulk: T::Boolean,
-            conversation: Moonbase::InboxConversation,
             created_at: Time,
             draft: T::Boolean,
-            in_reply_to_rfc822_message_id: String,
             spam: T::Boolean,
-            summary: String,
+            subject: String,
             trash: T::Boolean,
-            unread: T::Boolean
+            type: Symbol,
+            unread: T::Boolean,
+            addresses: T::Array[Moonbase::Address],
+            attachments: T::Array[Moonbase::EmailMessage::Attachment],
+            conversation: Moonbase::InboxConversation,
+            summary: String
           }
         )
       end
       def to_hash
       end
 
-      class Links < Moonbase::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(Moonbase::EmailMessage::Links, Moonbase::Internal::AnyHash)
-          end
-
-        # A link to the `Conversation` this message belongs to.
-        sig { returns(String) }
-        attr_accessor :conversation
-
-        # The canonical URL for this object.
-        sig { returns(String) }
-        attr_accessor :self_
-
-        sig do
-          params(conversation: String, self_: String).returns(T.attached_class)
-        end
-        def self.new(
-          # A link to the `Conversation` this message belongs to.
-          conversation:,
-          # The canonical URL for this object.
-          self_:
-        )
-        end
-
-        sig { override.returns({ conversation: String, self_: String }) }
-        def to_hash
-        end
-      end
-
       class Attachment < Moonbase::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -257,69 +184,55 @@ module Moonbase
         sig { returns(String) }
         attr_accessor :id
 
+        # Time at which the object was created, as an ISO 8601 timestamp in UTC.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # A temporary, signed URL to download the file content. The URL expires after one
+        # hour.
+        sig { returns(String) }
+        attr_accessor :download_url
+
         # The original name of the uploaded file, including its extension.
         sig { returns(String) }
         attr_accessor :filename
 
-        # A hash of related links.
-        sig { returns(Moonbase::EmailMessage::Attachment::Links) }
-        attr_reader :links
-
-        sig do
-          params(links: Moonbase::EmailMessage::Attachment::Links::OrHash).void
-        end
-        attr_writer :links
-
         # The size of the file in bytes.
         sig { returns(Integer) }
         attr_accessor :size
 
-        # String representing the object’s type. Always `attachment` for this object.
+        # String representing the object’s type. Always `message_attachment` for this
+        # object.
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # Time at which the object was created, as an RFC 3339 timestamp.
-        sig { returns(T.nilable(Time)) }
-        attr_reader :created_at
-
-        sig { params(created_at: Time).void }
-        attr_writer :created_at
-
-        # Time at which the object was last updated, as an RFC 3339 timestamp.
-        sig { returns(T.nilable(String)) }
-        attr_reader :updated_at
-
-        sig { params(updated_at: String).void }
-        attr_writer :updated_at
-
         # The Attachment object represents a file attached to a message. You can download
         # the file content via the `download_url`.
         sig do
           params(
             id: String,
+            created_at: Time,
+            download_url: String,
             filename: String,
-            links: Moonbase::EmailMessage::Attachment::Links::OrHash,
             size: Integer,
-            created_at: Time,
-            updated_at: String,
             type: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
           # Unique identifier for the object.
           id:,
+          # Time at which the object was created, as an ISO 8601 timestamp in UTC.
+          created_at:,
+          # A temporary, signed URL to download the file content. The URL expires after one
+          # hour.
+          download_url:,
           # The original name of the uploaded file, including its extension.
           filename:,
-          # A hash of related links.
-          links:,
           # The size of the file in bytes.
           size:,
-          # Time at which the object was created, as an RFC 3339 timestamp.
-          created_at: nil,
-          # Time at which the object was last updated, as an RFC 3339 timestamp.
-          updated_at: nil,
-          # String representing the object’s type. Always `attachment` for this object.
-          type: :attachment
+          # String representing the object’s type. Always `message_attachment` for this
+          # object.
+          type: :message_attachment
         )
         end
 
@@ -327,67 +240,16 @@ module Moonbase
           override.returns(
             {
               id: String,
+              created_at: Time,
+              download_url: String,
               filename: String,
-              links: Moonbase::EmailMessage::Attachment::Links,
               size: Integer,
-              type: Symbol,
-              created_at: Time,
-              updated_at: String
+              type: Symbol
             }
           )
         end
         def to_hash
         end
-
-        class Links < Moonbase::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                Moonbase::EmailMessage::Attachment::Links,
-                Moonbase::Internal::AnyHash
-              )
-            end
-
-          # A link to the `Conversation` this attachment belongs to.
-          sig { returns(String) }
-          attr_accessor :conversation
-
-          # A temporary, signed URL to download the file content. The URL expires after one
-          # hour.
-          sig { returns(String) }
-          attr_accessor :download_url
-
-          # A link to the `Message` this attachment belongs to.
-          sig { returns(String) }
-          attr_accessor :message
-
-          # A hash of related links.
-          sig do
-            params(
-              conversation: String,
-              download_url: String,
-              message: String
-            ).returns(T.attached_class)
-          end
-          def self.new(
-            # A link to the `Conversation` this attachment belongs to.
-            conversation:,
-            # A temporary, signed URL to download the file content. The URL expires after one
-            # hour.
-            download_url:,
-            # A link to the `Message` this attachment belongs to.
-            message:
-          )
-          end
-
-          sig do
-            override.returns(
-              { conversation: String, download_url: String, message: String }
-            )
-          end
-          def to_hash
-          end
-        end
       end
     end
   end

data/rbi/moonbase/models/email_value.rbi

@@ -8,18 +8,23 @@ module Moonbase
           T.any(Moonbase::EmailValue, Moonbase::Internal::AnyHash)
         end
 
+      # A valid email address.
       sig { returns(String) }
-      attr_accessor :email
+      attr_accessor :data
 
       sig { returns(Symbol) }
       attr_accessor :type
 
       # Email address value
-      sig { params(email: String, type: Symbol).returns(T.attached_class) }
-      def self.new(email:, type: :"value/email")
+      sig { params(data: String, type: Symbol).returns(T.attached_class) }
+      def self.new(
+        # A valid email address.
+        data:,
+        type: :"value/email"
+      )
       end
 
-      sig { override.returns({ email: String, type: Symbol }) }
+      sig { override.returns({ data: String, type: Symbol }) }
       def to_hash
       end
     end

data/rbi/moonbase/models/endpoint.rbi

@@ -0,0 +1,121 @@
+# typed: strong
+
+module Moonbase
+  module Models
+    class Endpoint < Moonbase::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Moonbase::Endpoint, Moonbase::Internal::AnyHash) }
+
+      # Unique identifier for the object.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      # Indicates whether the endpoint is enabled.
+      sig { returns(Moonbase::Endpoint::Status::TaggedSymbol) }
+      attr_accessor :status
+
+      # An array of `WebhookSubscription` objects representing the events this endpoint
+      # will receive.
+      sig { returns(T::Array[Moonbase::Subscription]) }
+      attr_accessor :subscriptions
+
+      # String representing the object’s type. Always `webhook_endpoint` for this
+      # object.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      # Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      sig { returns(Time) }
+      attr_accessor :updated_at
+
+      # The HTTPS URL where webhook events will be sent.
+      sig { returns(String) }
+      attr_accessor :url
+
+      # The signing secret used to verify webhook authenticity. This value is only shown
+      # when creating the endpoint and starts with `whsec_`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :secret
+
+      sig { params(secret: String).void }
+      attr_writer :secret
+
+      # A Webhook Endpoint is an HTTP endpoint that receives webhooks. You can configure
+      # which events are sent to each endpoint by creating `WebhookSubscription`
+      # objects.
+      sig do
+        params(
+          id: String,
+          created_at: Time,
+          status: Moonbase::Endpoint::Status::OrSymbol,
+          subscriptions: T::Array[Moonbase::Subscription::OrHash],
+          updated_at: Time,
+          url: String,
+          secret: String,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique identifier for the object.
+        id:,
+        # Time at which the object was created, as an ISO 8601 timestamp in UTC.
+        created_at:,
+        # Indicates whether the endpoint is enabled.
+        status:,
+        # An array of `WebhookSubscription` objects representing the events this endpoint
+        # will receive.
+        subscriptions:,
+        # Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+        updated_at:,
+        # The HTTPS URL where webhook events will be sent.
+        url:,
+        # The signing secret used to verify webhook authenticity. This value is only shown
+        # when creating the endpoint and starts with `whsec_`.
+        secret: nil,
+        # String representing the object’s type. Always `webhook_endpoint` for this
+        # object.
+        type: :webhook_endpoint
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: Time,
+            status: Moonbase::Endpoint::Status::TaggedSymbol,
+            subscriptions: T::Array[Moonbase::Subscription],
+            type: Symbol,
+            updated_at: Time,
+            url: String,
+            secret: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Indicates whether the endpoint is enabled.
+      module Status
+        extend Moonbase::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Moonbase::Endpoint::Status) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DISABLED = T.let(:disabled, Moonbase::Endpoint::Status::TaggedSymbol)
+        ENABLED = T.let(:enabled, Moonbase::Endpoint::Status::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[Moonbase::Endpoint::Status::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/moonbase/models/error.rbi

@@ -52,6 +52,10 @@ module Moonbase
       sig { params(title: String).void }
       attr_writer :title
 
+      # The Error object represents a single error that occurred during API request
+      # processing. It provides detailed information about what went wrong, including a
+      # unique identifier, status code, and human-readable descriptions to help
+      # developers understand and resolve the issue.
       sig do
         params(
           id: String,