feat(postgrest): add missing operators match, imatch, and isDistinct

Implements missing PostgREST v12 operators to bring the Swift SDK up to date with the official PostgREST API specification.

New operators:
- match(): Regex pattern matching (case-sensitive) using ~ operator
- imatch(): Regex pattern matching (case-insensitive) using ~* operator
- isDistinct(): IS DISTINCT FROM operator for NULL-aware comparison

Also fixes semantic helper methods plainToFullTextSearch(), phraseToFullTextSearch(), and webFullTextSearch() to call textSearch() directly with the appropriate type parameter.

Includes comprehensive tests for all new operators.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: grdsdev

Sources/PostgREST/PostgrestFilterBuilder.swift

@@ -2,8 +2,8 @@ import Foundation
 
 public class PostgrestFilterBuilder: PostgrestTransformBuilder, @unchecked Sendable {
   public enum Operator: String, CaseIterable, Sendable {
-    case eq, neq, gt, gte, lt, lte, like, ilike, `is`, `in`, cs, cd, sl, sr, nxl, nxr, adj, ov, fts,
-      plfts, phfts, wfts
+    case eq, neq, gt, gte, lt, lte, like, ilike, match, imatch, `is`, isdistinct, `in`, cs, cd, sl,
+      sr, nxl, nxr, adj, ov, fts, plfts, phfts, wfts
   }
 
   // MARK: - Filters
@@ -228,6 +228,38 @@ public class PostgrestFilterBuilder: PostgrestTransformBuilder, @unchecked Senda
     return self
   }
 
+  /// Match only rows where `column` matches the regex `pattern` case-sensitively.
+  ///
+  /// - Parameters:
+  ///   - column: The column to filter on
+  ///   - pattern: The regex pattern to match with
+  public func match(
+    _ column: String,
+    pattern: any PostgrestFilterValue
+  ) -> PostgrestFilterBuilder {
+    let queryValue = pattern.rawValue
+    mutableState.withValue {
+      $0.request.query.append(URLQueryItem(name: column, value: "match.\(queryValue)"))
+    }
+    return self
+  }
+
+  /// Match only rows where `column` matches the regex `pattern` case-insensitively.
+  ///
+  /// - Parameters:
+  ///   - column: The column to filter on
+  ///   - pattern: The regex pattern to match with
+  public func imatch(
+    _ column: String,
+    pattern: any PostgrestFilterValue
+  ) -> PostgrestFilterBuilder {
+    let queryValue = pattern.rawValue
+    mutableState.withValue {
+      $0.request.query.append(URLQueryItem(name: column, value: "imatch.\(queryValue)"))
+    }
+    return self
+  }
+
   /// Match only rows where `column` IS `value`.
   ///
   /// For non-boolean columns, this is only relevant for checking if the value of `column` is NULL by setting `value` to `null`.
@@ -247,6 +279,24 @@ public class PostgrestFilterBuilder: PostgrestTransformBuilder, @unchecked Senda
     return self
   }
 
+  /// Match only rows where `column` IS DISTINCT FROM `value`.
+  ///
+  /// Unlike `.neq()`, this treats NULL as a comparable value. NULL IS DISTINCT FROM NULL is false, while NULL != NULL is true.
+  ///
+  /// - Parameters:
+  ///   - column: The column to filter on
+  ///   - value: The value to filter with
+  public func isDistinct(
+    _ column: String,
+    value: any PostgrestFilterValue
+  ) -> PostgrestFilterBuilder {
+    let queryValue = value.rawValue
+    mutableState.withValue {
+      $0.request.query.append(URLQueryItem(name: column, value: "isdistinct.\(queryValue)"))
+    }
+    return self
+  }
+
   /// Match only rows where `column` is included in the `values` array.
   ///
   /// - Parameters:
@@ -575,22 +625,22 @@ public class PostgrestFilterBuilder: PostgrestTransformBuilder, @unchecked Senda
     query: String,
     config: String? = nil
   ) -> PostgrestFilterBuilder {
-    plfts(column, query: query, config: config)
+    textSearch(column, query: query, config: config, type: .plain)
   }
 
   public func phraseToFullTextSearch(
     _ column: String,
     query: String,
     config: String? = nil
   ) -> PostgrestFilterBuilder {
-    phfts(column, query: query, config: config)
+    textSearch(column, query: query, config: config, type: .phrase)
   }
 
   public func webFullTextSearch(
     _ column: String,
     query: String,
     config: String? = nil
   ) -> PostgrestFilterBuilder {
-    wfts(column, query: query, config: config)
+    textSearch(column, query: query, config: config, type: .websearch)
   }
 }

Tests/PostgRESTTests/PostgrestFilterBuilderTests.swift

@@ -669,4 +669,85 @@ final class PostgrestFilterBuilderTests: PostgrestQueryTests {
       .fts("description", query: "programmer")
       .execute()
   }
+
+  func testRegexMatchFilter() async throws {
+    Mock(
+      url: url.appendingPathComponent("users"),
+      ignoreQuery: true,
+      statusCode: 200,
+      data: [.get: Data("[]".utf8)]
+    )
+    .snapshotRequest {
+      #"""
+      curl \
+      	--header "Accept: application/json" \
+      	--header "Content-Type: application/json" \
+      	--header "X-Client-Info: postgrest-swift/0.0.0" \
+      	--header "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24iLCJleHAiOjE5ODM4MTI5OTZ9.CRXP1A7WOeoJeXxjNni43kdQwgnWNReilDMblYTn_I0" \
+      	"http://localhost:54321/rest/v1/users?email=match.%5E.+@.+%5C..+$&select=*"
+      """#
+    }
+    .register()
+
+    _ =
+      try await sut
+      .from("users")
+      .select()
+      .match("email", pattern: "^.+@.+\\..+$")
+      .execute()
+  }
+
+  func testRegexImatchFilter() async throws {
+    Mock(
+      url: url.appendingPathComponent("users"),
+      ignoreQuery: true,
+      statusCode: 200,
+      data: [.get: Data("[]".utf8)]
+    )
+    .snapshotRequest {
+      #"""
+      curl \
+      	--header "Accept: application/json" \
+      	--header "Content-Type: application/json" \
+      	--header "X-Client-Info: postgrest-swift/0.0.0" \
+      	--header "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24iLCJleHAiOjE5ODM4MTI5OTZ9.CRXP1A7WOeoJeXxjNni43kdQwgnWNReilDMblYTn_I0" \
+      	"http://localhost:54321/rest/v1/users?name=imatch.%5Ejohn&select=*"
+      """#
+    }
+    .register()
+
+    _ =
+      try await sut
+      .from("users")
+      .select()
+      .imatch("name", pattern: "^john")
+      .execute()
+  }
+
+  func testIsDistinctFilter() async throws {
+    Mock(
+      url: url.appendingPathComponent("users"),
+      ignoreQuery: true,
+      statusCode: 200,
+      data: [.get: Data("[]".utf8)]
+    )
+    .snapshotRequest {
+      #"""
+      curl \
+      	--header "Accept: application/json" \
+      	--header "Content-Type: application/json" \
+      	--header "X-Client-Info: postgrest-swift/0.0.0" \
+      	--header "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24iLCJleHAiOjE5ODM4MTI5OTZ9.CRXP1A7WOeoJeXxjNni43kdQwgnWNReilDMblYTn_I0" \
+      	"http://localhost:54321/rest/v1/users?select=*&status=isdistinct.null"
+      """#
+    }
+    .register()
+
+    _ =
+      try await sut
+      .from("users")
+      .select()
+      .isDistinct("status", value: "null")
+      .execute()
+  }
 }