Restructure omni services and add Chatwoot research snapshot

research/chatwoot/app/mailers/conversation_reply_mailer_helper.rb

@@ -0,0 +1,113 @@
+module ConversationReplyMailerHelper
+  include ConversationReplyMailerAttachmentHelper
+
+  def prepare_mail(cc_bcc_enabled)
+    @options = {
+      to: to_emails,
+      from: email_from,
+      reply_to: email_reply_to,
+      subject: mail_subject,
+      message_id: custom_message_id,
+      in_reply_to: in_reply_to_email,
+      references: references_header
+    }
+
+    if cc_bcc_enabled
+      @options[:cc] = cc_bcc_emails[0]
+      @options[:bcc] = cc_bcc_emails[1]
+    end
+    oauth_smtp_settings
+    set_delivery_method
+
+    # Email type detection logic:
+    # - email_reply: Sets @message with a single message
+    # - Other actions: Set @messages with a collection of messages
+    #
+    # So this check implicitly determines we're handling an email_reply
+    # and not one of the other email types (summary, transcript, etc.)
+    process_attachments_as_files_for_email_reply if @message&.attachments.present?
+    mail(@options)
+  end
+
+  private
+
+  def oauth_smtp_settings
+    return unless @inbox.email? && @channel.imap_enabled
+    return unless oauth_provider_domain
+
+    @options[:delivery_method] = :smtp
+    @options[:delivery_method_options] = base_smtp_settings(oauth_provider_domain)
+  end
+
+  def oauth_provider_domain
+    return 'smtp.gmail.com' if @inbox.channel.google?
+    return 'smtp.office365.com' if @inbox.channel.microsoft?
+  end
+
+  def base_smtp_settings(domain)
+    {
+      address: domain,
+      port: 587,
+      user_name: @channel.imap_login,
+      password: @channel.provider_config['access_token'],
+      domain: domain,
+      tls: false,
+      enable_starttls_auto: true,
+      openssl_verify_mode: 'none',
+      open_timeout: 15,
+      read_timeout: 15,
+      authentication: 'xoauth2'
+    }
+  end
+
+  def set_delivery_method
+    return unless @inbox.inbox_type == 'Email' && @channel.smtp_enabled
+
+    smtp_settings = {
+      address: @channel.smtp_address,
+      port: @channel.smtp_port,
+      user_name: @channel.smtp_login,
+      password: @channel.smtp_password,
+      domain: @channel.smtp_domain,
+      tls: @channel.smtp_enable_ssl_tls,
+      enable_starttls_auto: @channel.smtp_enable_starttls_auto,
+      openssl_verify_mode: @channel.smtp_openssl_verify_mode,
+      authentication: @channel.smtp_authentication
+    }
+
+    @options[:delivery_method] = :smtp
+    @options[:delivery_method_options] = smtp_settings
+  end
+
+  def email_smtp_enabled
+    @inbox.inbox_type == 'Email' && @channel.smtp_enabled
+  end
+
+  def email_imap_enabled
+    @inbox.inbox_type == 'Email' && @channel.imap_enabled
+  end
+
+  def email_oauth_enabled
+    @inbox.inbox_type == 'Email' && (@channel.microsoft? || @channel.google?)
+  end
+
+  def email_from
+    return Email::FromBuilder.new(inbox: @inbox, message: current_message).build if @account.feature_enabled?(:reply_mailer_migration)
+
+    email_oauth_enabled || email_smtp_enabled ? channel_email_with_name : from_email_with_name
+  end
+
+  def email_reply_to
+    return Email::ReplyToBuilder.new(inbox: @inbox, message: current_message).build if @account.feature_enabled?(:reply_mailer_migration)
+
+    email_imap_enabled ? @channel.email : reply_email
+  end
+
+  # Use channel email domain in case of account email domain is not set for custom message_id and in_reply_to
+  def channel_email_domain
+    return @account.inbound_email_domain if @account.inbound_email_domain.present?
+
+    email = @inbox.channel.try(:email)
+    email.present? ? email.split('@').last : raise(StandardError, 'Channel email domain not present.')
+  end
+end