sentdm 0.28.0 → 0.30.0

data/rbi/sentdm/models/contact_message_summary.rbi

@@ -0,0 +1,144 @@
+# typed: strong
+
+module Sentdm
+  module Models
+    class ContactMessageSummary < Sentdm::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Sentdm::ContactMessageSummary, Sentdm::Internal::AnyHash)
+        end
+
+      sig do
+        returns(
+          T.nilable(T::Array[Sentdm::ContactMessageSummary::ChannelScore])
+        )
+      end
+      attr_reader :channel_scores
+
+      sig do
+        params(
+          channel_scores:
+            T::Array[Sentdm::ContactMessageSummary::ChannelScore::OrHash]
+        ).void
+      end
+      attr_writer :channel_scores
+
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :channels_used
+
+      sig { params(channels_used: T::Array[String]).void }
+      attr_writer :channels_used
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :contact_id
+
+      sig { params(contact_id: String).void }
+      attr_writer :contact_id
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :first_message_at
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :last_message_at
+
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :message_count
+
+      sig { params(message_count: Integer).void }
+      attr_writer :message_count
+
+      sig do
+        params(
+          channel_scores:
+            T::Array[Sentdm::ContactMessageSummary::ChannelScore::OrHash],
+          channels_used: T::Array[String],
+          contact_id: String,
+          first_message_at: T.nilable(Time),
+          last_message_at: T.nilable(Time),
+          message_count: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        channel_scores: nil,
+        channels_used: nil,
+        contact_id: nil,
+        first_message_at: nil,
+        last_message_at: nil,
+        message_count: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            channel_scores:
+              T::Array[Sentdm::ContactMessageSummary::ChannelScore],
+            channels_used: T::Array[String],
+            contact_id: String,
+            first_message_at: T.nilable(Time),
+            last_message_at: T.nilable(Time),
+            message_count: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class ChannelScore < Sentdm::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Sentdm::ContactMessageSummary::ChannelScore,
+              Sentdm::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :channel
+
+        sig { params(channel: String).void }
+        attr_writer :channel
+
+        # Percentage (0-100) of messages on this channel that ended in FAILED.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :fail_score
+
+        sig { params(fail_score: Integer).void }
+        attr_writer :fail_score
+
+        # Percentage (0-100) of messages on this channel that reached a successful
+        # terminal state: SENT/DELIVERED/READ for outbound, RECEIVED for inbound.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :success_score
+
+        sig { params(success_score: Integer).void }
+        attr_writer :success_score
+
+        sig do
+          params(
+            channel: String,
+            fail_score: Integer,
+            success_score: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          channel: nil,
+          # Percentage (0-100) of messages on this channel that ended in FAILED.
+          fail_score: nil,
+          # Percentage (0-100) of messages on this channel that reached a successful
+          # terminal state: SENT/DELIVERED/READ for outbound, RECEIVED for inbound.
+          success_score: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            { channel: String, fail_score: Integer, success_score: Integer }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/sentdm/models/contact_response.rbi

@@ -0,0 +1,200 @@
+# typed: strong
+
+module Sentdm
+  module Models
+    class ContactResponse < Sentdm::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Sentdm::ContactResponse, Sentdm::Internal::AnyHash)
+        end
+
+      # Unique identifier for the contact
+      sig { returns(T.nilable(String)) }
+      attr_reader :id
+
+      sig { params(id: String).void }
+      attr_writer :id
+
+      # Comma-separated list of available messaging channels (e.g., "sms,whatsapp")
+      sig { returns(T.nilable(String)) }
+      attr_reader :available_channels
+
+      sig { params(available_channels: String).void }
+      attr_writer :available_channels
+
+      # Country calling code (e.g., 1 for US/Canada)
+      sig { returns(T.nilable(String)) }
+      attr_reader :country_code
+
+      sig { params(country_code: String).void }
+      attr_writer :country_code
+
+      # When the contact was created
+      sig { returns(T.nilable(Time)) }
+      attr_reader :created_at
+
+      sig { params(created_at: Time).void }
+      attr_writer :created_at
+
+      # Which customer owns this — the key's own, or the profile named in x-profile-id.
+      # Says whose resource this is, which the resource's own id does not.
+      sig { returns(T.nilable(String)) }
+      attr_reader :customer_id
+
+      sig { params(customer_id: String).void }
+      attr_writer :customer_id
+
+      # Default messaging channel to use (e.g., "sms" or "whatsapp")
+      sig { returns(T.nilable(String)) }
+      attr_reader :default_channel
+
+      sig { params(default_channel: String).void }
+      attr_writer :default_channel
+
+      # Phone number in E.164 format (e.g., +1234567890)
+      sig { returns(T.nilable(String)) }
+      attr_reader :format_e164
+
+      sig { params(format_e164: String).void }
+      attr_writer :format_e164
+
+      # Phone number in international format (e.g., +1 234-567-890)
+      sig { returns(T.nilable(String)) }
+      attr_reader :format_international
+
+      sig { params(format_international: String).void }
+      attr_writer :format_international
+
+      # Phone number in national format (e.g., (234) 567-890)
+      sig { returns(T.nilable(String)) }
+      attr_reader :format_national
+
+      sig { params(format_national: String).void }
+      attr_writer :format_national
+
+      # Phone number in RFC 3966 format (e.g., tel:+1-234-567-890)
+      sig { returns(T.nilable(String)) }
+      attr_reader :format_rfc
+
+      sig { params(format_rfc: String).void }
+      attr_writer :format_rfc
+
+      # Always false. Contacts are no longer shared or inherited between sender profiles
+      # — a profile sees only the contacts it owns. Retained so existing v3 clients
+      # reading is_inherited keep deserializing; it carries no information.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_inherited
+
+      sig { params(is_inherited: T::Boolean).void }
+      attr_writer :is_inherited
+
+      # Whether the contact has opted out of messaging. Single source of truth — opt-out
+      # is per-contact, not per-channel.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :opt_out
+
+      sig { params(opt_out: T::Boolean).void }
+      attr_writer :opt_out
+
+      # Phone number in original format
+      sig { returns(T.nilable(String)) }
+      attr_reader :phone_number
+
+      sig { params(phone_number: String).void }
+      attr_writer :phone_number
+
+      # ISO 3166-1 alpha-2 country code (e.g., US, CA, GB)
+      sig { returns(T.nilable(String)) }
+      attr_reader :region_code
+
+      sig { params(region_code: String).void }
+      attr_writer :region_code
+
+      # When the contact was last updated
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :updated_at
+
+      # Contact response for v3 API Uses snake_case for JSON property names
+      sig do
+        params(
+          id: String,
+          available_channels: String,
+          country_code: String,
+          created_at: Time,
+          customer_id: String,
+          default_channel: String,
+          format_e164: String,
+          format_international: String,
+          format_national: String,
+          format_rfc: String,
+          is_inherited: T::Boolean,
+          opt_out: T::Boolean,
+          phone_number: String,
+          region_code: String,
+          updated_at: T.nilable(Time)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique identifier for the contact
+        id: nil,
+        # Comma-separated list of available messaging channels (e.g., "sms,whatsapp")
+        available_channels: nil,
+        # Country calling code (e.g., 1 for US/Canada)
+        country_code: nil,
+        # When the contact was created
+        created_at: nil,
+        # Which customer owns this — the key's own, or the profile named in x-profile-id.
+        # Says whose resource this is, which the resource's own id does not.
+        customer_id: nil,
+        # Default messaging channel to use (e.g., "sms" or "whatsapp")
+        default_channel: nil,
+        # Phone number in E.164 format (e.g., +1234567890)
+        format_e164: nil,
+        # Phone number in international format (e.g., +1 234-567-890)
+        format_international: nil,
+        # Phone number in national format (e.g., (234) 567-890)
+        format_national: nil,
+        # Phone number in RFC 3966 format (e.g., tel:+1-234-567-890)
+        format_rfc: nil,
+        # Always false. Contacts are no longer shared or inherited between sender profiles
+        # — a profile sees only the contacts it owns. Retained so existing v3 clients
+        # reading is_inherited keep deserializing; it carries no information.
+        is_inherited: nil,
+        # Whether the contact has opted out of messaging. Single source of truth — opt-out
+        # is per-contact, not per-channel.
+        opt_out: nil,
+        # Phone number in original format
+        phone_number: nil,
+        # ISO 3166-1 alpha-2 country code (e.g., US, CA, GB)
+        region_code: nil,
+        # When the contact was last updated
+        updated_at: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            available_channels: String,
+            country_code: String,
+            created_at: Time,
+            customer_id: String,
+            default_channel: String,
+            format_e164: String,
+            format_international: String,
+            format_national: String,
+            format_rfc: String,
+            is_inherited: T::Boolean,
+            opt_out: T::Boolean,
+            phone_number: String,
+            region_code: String,
+            updated_at: T.nilable(Time)
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end