feat: add Subject search and wildcard support

Adds support for searching by subject and using % as wildcard in
to, from, and subject search fields.

Cherry-picked from postalserver/postal PR postalserver#3399

Co-authored-by: matige <matige@users.noreply.github.com>
Co-authored-by: openhands <openhands@all-hands.dev>

Author: openhands-agent

app/controllers/messages_controller.rb

@@ -170,8 +170,6 @@ def get_messages(scope)
             options[:direction] = "asc"
           end
 
-          options[:where][:rcpt_to] = qs[:to] if qs[:to]
-          options[:where][:mail_from] = qs[:from] if qs[:from]
           options[:where][:status] = qs[:status] if qs[:status]
           options[:where][:token] = qs[:token] if qs[:token]
 
@@ -180,6 +178,15 @@ def get_messages(scope)
             options[:where].delete(:spam)
             options[:where].delete(:scope)
           end
+          [[:subject, :subject], [:to, :rcpt_to], [:from, :mail_from]].each do |qs_key, where_key|
+            if qs[qs_key]
+              if qs[qs_key].include?('%')
+                options[:where][where_key] = { like: qs[qs_key] }
+              else
+                options[:where][where_key] = qs[qs_key]
+              end
+            end
+          end
           options[:where][:tag] = qs[:tag] if qs[:tag]
           options[:where][:id] = qs[:id] if qs[:id]
           options[:where][:spam] = true if qs[:spam] == "yes" || qs[:spam] == "y"

app/views/messages/_search.html.haml

@@ -13,11 +13,14 @@
         as shown opposite into the box above and press enter.
     .messageSearch__right
       %dl.messageSearch__definition
-        %dt to: rachel@example.com
-        %dd Returns all mail addressed to the address provided.
+        %dt to: rachel@example.com or to: %rachel%
+        %dd Returns all mail addressed to the address provided. Use % as wildcard anywhere.
       %dl.messageSearch__definition
-        %dt from: tom@example.com
-        %dd Returns all mail sent from to the address provided.
+        %dt from: tom@example.com or from: %@example.com
+        %dd Returns all mail sent from to the address provided. Use % as wildcard anywhere.
+      %dl.messageSearch__definition
+        %dt subject: "any string" or subject: "%any string%"
+        %dd Returns all mail which subject contains the substring provided. Use % as wildcard anywhere.
       %dl.messageSearch__definition
         %dt status: pending
         %dd Returns all messages with the status provided. The suitable statuses are: <code>pending</code>, <code>sent</code>, <code>held</code>, <code>softfail</code>, <code>hardfail</code> and <code>bounced</code>.

lib/postal/message_db/database.rb

@@ -368,6 +368,8 @@ def hash_to_sql(hash, joiner = ", ")
                 sql << "`#{key}` <= #{escape(inner_value)}"
               when :greater_than_or_equal_to
                 sql << "`#{key}` >= #{escape(inner_value)}"
+              when :like
+                sql << "`#{key}` LIKE #{escape(inner_value)}"
               end
             end
             sql.empty? ? "1=1" : sql.join(joiner)