Add region as forceFunctionRegion query parameter

- Updated FunctionsClient to add region as both x-region header and forceFunctionRegion query param
- Used URL API to properly construct query parameters
- Added comprehensive tests to verify both header and query parameter functionality
- Updated existing test to check for both region mechanisms
- Maintains backward compatibility with existing x-region header

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

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

Author: laktek

src/FunctionsClient.ts

@@ -57,8 +57,11 @@ export class FunctionsClient {
       if (!region) {
         region = this.region
       }
+      // Add region as query parameter using URL API
+      const url = new URL(`${this.url}/${functionName}`)
       if (region && region !== 'any') {
         _headers['x-region'] = region
+        url.searchParams.set('forceFunctionRegion', region)
       }
       let body: any
       if (
@@ -88,7 +91,7 @@ export class FunctionsClient {
         }
       }
 
-      const response = await this.fetch(`${this.url}/${functionName}`, {
+      const response = await this.fetch(url.toString(), {
         method: method || 'POST',
         // headers priority is (high to low):
         // 1. invoke-level headers

test/spec/params.spec.ts

@@ -166,25 +166,24 @@ describe('params reached to function', () => {
     })
 
     log('assert no error')
-    const expected = {
-      url: 'http://localhost:8000/mirror',
-      method: 'POST',
-      headers: data?.headers ?? [],
-      body: '',
-    }
-    expect(data).toEqual(expected)
+    expect(error).toBeNull()
+    
+    // Check that x-region header is present
+    expect(
+      (data?.headers as [Array<string>]).filter(([k, v]) => k === 'x-region' && v === validRegion)
+        .length > 0
+    ).toBe(true)
+    
+    // Check that the URL contains the forceFunctionRegion query parameter
+    expect(data?.url).toContain(`forceFunctionRegion=${validRegion}`)
+    
     attach(
       'check headers from function',
       `expected to include: ${['custom-header', customHeader]}\n actual: ${JSON.stringify(
         data?.headers
       )}`,
       ContentType.TEXT
     )
-    console.log(data?.headers)
-    expect(
-      (data?.headers as [Array<string>]).filter(([k, v]) => k === 'x-region' && v === validRegion)
-        .length > 0
-    ).toBe(true)
   })
 
   test('invoke with region overrides region in the client', async () => {
@@ -490,4 +489,42 @@ describe('params reached to function', () => {
     }
     expect(data).toMatchObject(expected)
   })
+
+  test('invoke mirror with region adds forceFunctionRegion query parameter', async () => {
+    /**
+     * @feature headers
+     */
+    log('create FunctionsClient')
+    const fclient = new FunctionsClient(`http://localhost:${relay.container.getMappedPort(8081)}`)
+
+    log('invoke mirror')
+    const customHeader = nanoid()
+    const validRegion = FunctionRegion.ApNortheast1
+
+    const { data, error } = await fclient.invoke<MirrorResponse>('mirror', {
+      headers: {
+        'custom-header': customHeader,
+        Authorization: `Bearer ${apiKey}`,
+      },
+      region: validRegion,
+    })
+
+    log('assert no error')
+    expect(error).toBeNull()
+
+    // Check that both x-region header and forceFunctionRegion query param are present
+    expect(
+      (data?.headers as [Array<string>]).filter(([k, v]) => k === 'x-region' && v === validRegion)
+        .length > 0
+    ).toBe(true)
+
+    // Check that the URL contains the forceFunctionRegion query parameter
+    expect(data?.url).toContain(`forceFunctionRegion=${validRegion}`)
+    
+    attach(
+      'check URL contains forceFunctionRegion query param',
+      `expected URL to contain: forceFunctionRegion=${validRegion}\n actual URL: ${data?.url}`,
+      ContentType.TEXT
+    )
+  })
 })