Added select with foreign table

Sources/PostgREST/PostgrestQueryBuilder.swift

@@ -1,4 +1,67 @@
 public final class PostgrestQueryBuilder: PostgrestBuilder {
+  /// Performs a vertical filtering with SELECT.
+  /// - Parameters:
+  ///   - columns: The columns to retrieve, separated by commas.
+  ///   - head: When set to true, select will void data.
+  ///   - count: Count algorithm to use to count rows in a table.
+  ///   - foreignTable: The foreign table or view name to query.
+  ///   - foreignTableColum: The columns associated with to retrieve, separated by commas
+  public func select(
+    columns: String = "*",
+    foreignTable: String? = nil,
+    foreignTableColum: String = "*",
+    head: Bool = false,
+    count: CountOption? = nil
+  ) -> PostgrestFilterBuilder {
+    method = "GET"
+    // remove whitespaces except when quoted.
+    var quoted = false
+    var selectQueryValue = ""
+    let cleanedColumns = columns.compactMap { char -> String? in
+      if char.isWhitespace, !quoted {
+        return nil
+      }
+      if char == "\"" {
+        quoted = !quoted
+      }
+      return String(char)
+    }
+      .joined(separator: "")
+    selectQueryValue += cleanedColumns
+    if let foreignTable = foreignTable {
+      let cleanedForeignTable = foreignTable.compactMap { char -> String? in
+        if char.isWhitespace, !quoted {
+          return nil
+        }
+        if char == "\"" {
+          quoted = !quoted
+        }
+        return String(char)
+      }
+        .joined(separator: "")
+
+      let cleanedForeignTableColum = foreignTableColum.compactMap { char -> String? in
+        if char.isWhitespace, !quoted {
+          return nil
+        }
+        if char == "\"" {
+          quoted = !quoted
+        }
+        return String(char)
+      }
+        .joined(separator: "")
+      selectQueryValue += ",\(cleanedForeignTable)(\(cleanedForeignTableColum))"
+    }
+    appendSearchParams(name: "select", value: selectQueryValue)
+    if let count = count {
+      headers["Prefer"] = "count=\(count.rawValue)"
+    }
+    if head {
+      method = "HEAD"
+    }
+    return PostgrestFilterBuilder(self)
+  }
+
   /// Performs a vertical filtering with SELECT.
   /// - Parameters:
   ///   - columns: The columns to retrieve, separated by commas.

Tests/PostgRESTTests/BuildURLRequestTests.swift

@@ -96,6 +96,11 @@
             .select()
             .gt(column: "received_at", value: "2023-03-23T15:50:30.511743+00:00")
             .order(column: "received_at")
+        },
+        TestCase(name: "query with foreign table") { client in
+          client.from("user")
+            .select(foreignTable: "tasks")
+            .eq(column: "id", value: "Cigányka-ér (0+400 cskm) vízrajzi állomás")
         }
       ]
 

Tests/PostgRESTTests/__Snapshots__/BuildURLRequestTests/testBuildRequest.query-with-foreign-table.txt

@@ -0,0 +1,4 @@
+curl \
+	--header "Accept: application/json" \
+	--header "Content-Type: application/json" \
+	"https://example.supabase.co/user?id=eq.Cig%C3%A1nyka-%C3%A9r%20(0+400%20cskm)%20v%C3%ADzrajzi%20%C3%A1llom%C3%A1s&select=tasks%5C(*%5C)"