feat: add regional calls in the functions library

Author: mansueli

src/FunctionsClient.ts

@@ -11,6 +11,7 @@ import {
 export class FunctionsClient {
   protected url: string
   protected headers: Record<string, string>
+  protected region: string
   protected fetch: Fetch
 
   constructor(
@@ -25,6 +26,7 @@ export class FunctionsClient {
   ) {
     this.url = url
     this.headers = headers
+    this.region = 'any'
     this.fetch = resolveFetch(customFetch)
   }
 
@@ -47,8 +49,10 @@ export class FunctionsClient {
   ): Promise<FunctionsResponse<T>> {
     try {
       const { headers, method, body: functionArgs } = options
-
       let _headers: Record<string, string> = {}
+      if (this.region !== 'any') {
+        _headers['x-region'] = this.region
+      }
       let body: any
       if (
         functionArgs &&

src/types.ts

@@ -50,6 +50,24 @@ export type FunctionInvokeOptions = {
    * The HTTP verb of the request
    */
   method?: 'POST' | 'GET' | 'PUT' | 'PATCH' | 'DELETE'
+  /**
+   * The Region to invoke the function in.
+   */
+  region?: 'any'
+  | 'ap-northeast-1'
+  | 'ap-northeast-2'
+  | 'ap-south-1'
+  | 'ap-southeast-1'
+  | 'ap-southeast-2'
+  | 'ca-central-1'
+  | 'eu-central-1'
+  | 'eu-west-1'
+  | 'eu-west-2'
+  | 'eu-west-3'
+  | 'sa-east-1'
+  | 'us-east-1'
+  | 'us-west-1'
+  | 'us-west-2'
   /**
    * The body of the request.
    */