feat: add region as forceFunctionRegion query parameter

- Updated FunctionsClient (both async and sync) to add region as both x-region header and forceFunctionRegion query param
- Used urllib.parse.urlencode to properly construct query parameters
- Added comprehensive tests to verify both header and query parameter functionality
- Updated existing tests to check for both region mechanisms
- Maintains backward compatibility with existing x-region header

Ported from supabase/functions-js#100

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

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

Author: grdsdev

src/functions/src/supabase_functions/_async/functions_client.py

@@ -1,4 +1,5 @@
 from typing import Any, Dict, Literal, Optional, Union
+from urllib.parse import urlencode
 from warnings import warn
 
 from httpx import AsyncClient, HTTPError, Response
@@ -123,6 +124,8 @@ async def invoke(
         headers = self.headers
         body = None
         response_type = "text/plain"
+        url = f"{self.url}/{function_name}"
+
         if invoke_options is not None:
             headers.update(invoke_options.get("headers", {}))
             response_type = invoke_options.get("responseType", "text/plain")
@@ -135,6 +138,8 @@ async def invoke(
 
                 if region.value != "any":
                     headers["x-region"] = region.value
+                    # Add region as query parameter
+                    url = f"{url}?{urlencode({'forceFunctionRegion': region.value})}"
 
             body = invoke_options.get("body")
             if isinstance(body, str):
@@ -143,7 +148,7 @@ async def invoke(
                 headers["Content-Type"] = "application/json"
 
         response = await self._request(
-            "POST", f"{self.url}/{function_name}", headers=headers, json=body
+            "POST", url, headers=headers, json=body
         )
         is_relay_error = response.headers.get("x-relay-header")
 

src/functions/src/supabase_functions/_sync/functions_client.py

@@ -1,4 +1,5 @@
 from typing import Any, Dict, Literal, Optional, Union
+from urllib.parse import urlencode
 from warnings import warn
 
 from httpx import Client, HTTPError, Response
@@ -123,6 +124,8 @@ def invoke(
         headers = self.headers
         body = None
         response_type = "text/plain"
+        url = f"{self.url}/{function_name}"
+
         if invoke_options is not None:
             headers.update(invoke_options.get("headers", {}))
             response_type = invoke_options.get("responseType", "text/plain")
@@ -135,6 +138,8 @@ def invoke(
 
                 if region.value != "any":
                     headers["x-region"] = region.value
+                    # Add region as query parameter
+                    url = f"{url}?{urlencode({'forceFunctionRegion': region.value})}"
 
             body = invoke_options.get("body")
             if isinstance(body, str):
@@ -143,7 +148,7 @@ def invoke(
                 headers["Content-Type"] = "application/json"
 
         response = self._request(
-            "POST", f"{self.url}/{function_name}", headers=headers, json=body
+            "POST", url, headers=headers, json=body
         )
         is_relay_error = response.headers.get("x-relay-header")
 

src/functions/tests/_async/test_function_client.py

@@ -100,8 +100,11 @@ async def test_invoke_with_region(client: AsyncFunctionsClient):
 
         await client.invoke("test-function", {"region": FunctionRegion("us-east-1")})
 
-        _, kwargs = mock_request.call_args
+        args, kwargs = mock_request.call_args
+        # Check that x-region header is present
         assert kwargs["headers"]["x-region"] == "us-east-1"
+        # Check that the URL contains the forceFunctionRegion query parameter
+        assert "forceFunctionRegion=us-east-1" in args[1]
 
 
 async def test_invoke_with_region_string(client: AsyncFunctionsClient):
@@ -118,8 +121,11 @@ async def test_invoke_with_region_string(client: AsyncFunctionsClient):
         with pytest.warns(UserWarning, match=r"Use FunctionRegion\(us-east-1\)"):
             await client.invoke("test-function", {"region": "us-east-1"})
 
-        _, kwargs = mock_request.call_args
+        args, kwargs = mock_request.call_args
+        # Check that x-region header is present
         assert kwargs["headers"]["x-region"] == "us-east-1"
+        # Check that the URL contains the forceFunctionRegion query parameter
+        assert "forceFunctionRegion=us-east-1" in args[1]
 
 
 async def test_invoke_with_http_error(client: AsyncFunctionsClient):

src/functions/tests/_sync/test_function_client.py

@@ -94,8 +94,11 @@ def test_invoke_with_region(client: SyncFunctionsClient):
 
         client.invoke("test-function", {"region": FunctionRegion("us-east-1")})
 
-        _, kwargs = mock_request.call_args
+        args, kwargs = mock_request.call_args
+        # Check that x-region header is present
         assert kwargs["headers"]["x-region"] == "us-east-1"
+        # Check that the URL contains the forceFunctionRegion query parameter
+        assert "forceFunctionRegion=us-east-1" in args[1]
 
 
 def test_invoke_with_region_string(client: SyncFunctionsClient):
@@ -110,8 +113,11 @@ def test_invoke_with_region_string(client: SyncFunctionsClient):
         with pytest.warns(UserWarning, match=r"Use FunctionRegion\(us-east-1\)"):
             client.invoke("test-function", {"region": "us-east-1"})
 
-        _, kwargs = mock_request.call_args
+        args, kwargs = mock_request.call_args
+        # Check that x-region header is present
         assert kwargs["headers"]["x-region"] == "us-east-1"
+        # Check that the URL contains the forceFunctionRegion query parameter
+        assert "forceFunctionRegion=us-east-1" in args[1]
 
 
 def test_invoke_with_http_error(client: SyncFunctionsClient):