@capacitor-firebase/functions 6.0.0-dev.b96fa6c.1718781196 → 6.2.0

package/CapacitorFirebaseFunctions.podspec

@@ -13,7 +13,7 @@ Pod::Spec.new do |s|
   s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
   s.ios.deployment_target  = '13.0'
   s.dependency 'Capacitor'
-  s.dependency 'FirebaseFunctions', '~> 10.25'
+  s.dependency 'FirebaseFunctions', '~> 11.0'
   s.swift_version = '5.1'
   s.static_framework = true
 end

package/README.md

@@ -32,7 +32,43 @@ A working example can be found here: [robingenz/capacitor-firebase-plugin-demo](
 ```typescript
 import { FirebaseFunctions } from '@capacitor-firebase/functions';
 
-const echo = async () => {
+const callByName = async () => {
+    const { data } = await FirebaseFunctions.callByName({
+        name: 'helloWorld',
+        data: {
+            string: 'Hello World!',
+            number: 123,
+            boolean: true,
+            array: [1, 2, 3],
+            object: {
+                key: 'value'
+            }
+        }
+    });
+    return data;
+};
+
+const callByUrl = async () => {
+    const { data } = await FirebaseFunctions.callByUrl({
+        url: 'https://us-central1-YOUR_PROJECT_ID.cloudfunctions.net/helloWorld',
+        data: {
+            string: 'Hello World!',
+            number: 123,
+            boolean: true,
+            array: [1, 2, 3],
+            object: {
+                key: 'value'
+            }
+        }
+    });
+    return data;
+};
+
+const useEmulator = async () => {
+  await FirebaseFunctions.useEmulator({
+    host: '10.0.2.2',
+    port: 9001,
+  });
 };
 ```
 
@@ -42,6 +78,7 @@ const echo = async () => {
 
 * [`callByName(...)`](#callbyname)
 * [`callByUrl(...)`](#callbyurl)
+* [`useEmulator(...)`](#useemulator)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 
@@ -53,14 +90,18 @@ const echo = async () => {
 ### callByName(...)
 
 ```typescript
-callByName(options: CallByNameOptions) => Promise<CallByNameResult>
+callByName<RequestData = unknown, ResponseData = unknown>(options: CallByNameOptions<RequestData>) => Promise<CallByNameResult<ResponseData>>
 ```
 
-| Param         | Type                                                            |
-| ------------- | --------------------------------------------------------------- |
-| **`options`** | <code><a href="#callbynameoptions">CallByNameOptions</a></code> |
+Call a callable function by name.
+
+| Param         | Type                                                                               |
+| ------------- | ---------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#callbynameoptions">CallByNameOptions</a>&lt;RequestData&gt;</code> |
+
+**Returns:** <code>Promise&lt;<a href="#callbynameresult">CallByNameResult</a>&lt;ResponseData&gt;&gt;</code>
 
-**Returns:** <code>Promise&lt;<a href="#callresult">CallResult</a>&gt;</code>
+**Since:** 6.1.0
 
 --------------------
 
@@ -68,14 +109,45 @@ callByName(options: CallByNameOptions) => Promise<CallByNameResult>
 ### callByUrl(...)
 
 ```typescript
-callByUrl(options: CallByUrlOptions) => Promise<CallByUrlResult>
+callByUrl<RequestData = unknown, ResponseData = unknown>(options: CallByUrlOptions<RequestData>) => Promise<CallByUrlResult<ResponseData>>
+```
+
+Call a callable function by URL.
+
+| Param         | Type                                                                             |
+| ------------- | -------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#callbyurloptions">CallByUrlOptions</a>&lt;RequestData&gt;</code> |
+
+**Returns:** <code>Promise&lt;<a href="#callbyurlresult">CallByUrlResult</a>&lt;ResponseData&gt;&gt;</code>
+
+**Since:** 6.1.0
+
+--------------------
+
+
+### useEmulator(...)
+
+```typescript
+useEmulator(options: UseEmulatorOptions) => Promise<void>
+```
+
+Instrument your app to talk to the Cloud Functions emulator.
+
+On Android, the cleartext traffic must be allowed. On the Capacitor configuration:
+```
+{
+  server: {
+    cleartext: true
+  }
+}
 ```
+**The cleartext traffic is not intended for use in production.**
 
-| Param         | Type                                                          |
-| ------------- | ------------------------------------------------------------- |
-| **`options`** | <code><a href="#callbyurloptions">CallByUrlOptions</a></code> |
+| Param         | Type                                                              |
+| ------------- | ----------------------------------------------------------------- |
+| **`options`** | <code><a href="#useemulatoroptions">UseEmulatorOptions</a></code> |
 
-**Returns:** <code>Promise&lt;<a href="#callresult">CallResult</a>&gt;</code>
+**Since:** 6.1.0
 
 --------------------
 
@@ -85,23 +157,32 @@ callByUrl(options: CallByUrlOptions) => Promise<CallByUrlResult>
 
 #### CallResult
 
-| Prop       | Type             |
-| ---------- | ---------------- |
-| **`data`** | <code>any</code> |
+| Prop       | Type                      | Description                          | Since |
+| ---------- | ------------------------- | ------------------------------------ | ----- |
+| **`data`** | <code>ResponseData</code> | The result of the callable function. | 6.1.0 |
 
 
 #### CallByNameOptions
 
-| Prop       | Type                |
-| ---------- | ------------------- |
-| **`name`** | <code>string</code> |
+| Prop         | Type                | Description                          | Since |
+| ------------ | ------------------- | ------------------------------------ | ----- |
+| **`name`**   | <code>string</code> | The name of the callable function.   | 6.1.0 |
+| **`region`** | <code>string</code> | The region of the callable function. | 6.1.0 |
 
 
 #### CallByUrlOptions
 
-| Prop      | Type                |
-| --------- | ------------------- |
-| **`url`** | <code>string</code> |
+| Prop      | Type                | Description                       | Since |
+| --------- | ------------------- | --------------------------------- | ----- |
+| **`url`** | <code>string</code> | The URL of the callable function. | 6.1.0 |
+
+
+#### UseEmulatorOptions
+
+| Prop       | Type                | Description                                                                                                                                                                     | Default           | Since |
+| ---------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ----- |
+| **`host`** | <code>string</code> | The emulator host without any port or scheme. Note when using a Android Emulator device: 10.0.2.2 is the special IP address to connect to the 'localhost' of the host computer. |                   | 6.1.0 |
+| **`port`** | <code>number</code> | The emulator port.                                                                                                                                                              | <code>5001</code> | 6.1.0 |
 
 
 ### Type Aliases
@@ -109,12 +190,12 @@ callByUrl(options: CallByUrlOptions) => Promise<CallByUrlResult>
 
 #### CallByNameResult
 
-<code><a href="#callresult">CallResult</a></code>
+<code><a href="#callresult">CallResult</a>&lt;ResponseData&gt;</code>
 
 
 #### CallByUrlResult
 
-<code><a href="#callresult">CallResult</a></code>
+<code><a href="#callresult">CallResult</a>&lt;ResponseData&gt;</code>
 
 </docgen-api>
 

package/android/src/main/java/io/capawesome/capacitorjs/plugins/firebase/functions/FirebaseFunctions.java

@@ -1,10 +1,12 @@
 package io.capawesome.capacitorjs.plugins.firebase.functions;
 
 import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 import io.capawesome.capacitorjs.plugins.firebase.functions.classes.options.CallByNameOptions;
 import io.capawesome.capacitorjs.plugins.firebase.functions.classes.options.CallByUrlOptions;
 import io.capawesome.capacitorjs.plugins.firebase.functions.classes.results.CallResult;
 import io.capawesome.capacitorjs.plugins.firebase.functions.interfaces.NonEmptyResultCallback;
+import java.net.URL;
 
 public class FirebaseFunctions {
 
@@ -16,9 +18,10 @@ public class FirebaseFunctions {
 
     public void callByName(@NonNull CallByNameOptions options, @NonNull NonEmptyResultCallback callback) {
         String name = options.getName();
+        String region = options.getRegion();
         Object data = options.getData();
 
-        getFirebaseFunctionsInstance()
+        getFirebaseFunctionsInstance(region)
             .getHttpsCallable(name)
             .call(data)
             .addOnSuccessListener(
@@ -35,11 +38,11 @@ public class FirebaseFunctions {
     }
 
     public void callByUrl(@NonNull CallByUrlOptions options, @NonNull NonEmptyResultCallback callback) {
-        String url = options.getUrl();
+        URL url = options.getUrl();
         Object data = options.getData();
 
-        getFirebaseFunctionsInstance()
-            .getHttpsCallable(url)
+        getFirebaseFunctionsInstance(null)
+            .getHttpsCallableFromUrl(url)
             .call(data)
             .addOnSuccessListener(
                 task -> {
@@ -54,7 +57,15 @@ public class FirebaseFunctions {
             );
     }
 
-    private com.google.firebase.functions.FirebaseFunctions getFirebaseFunctionsInstance() {
-        return com.google.firebase.functions.FirebaseFunctions.getInstance();
+    public void useEmulator(@NonNull String host, int port) {
+        getFirebaseFunctionsInstance(null).useEmulator(host, port);
+    }
+
+    private com.google.firebase.functions.FirebaseFunctions getFirebaseFunctionsInstance(@Nullable String regionOrCustomDomain) {
+        if (regionOrCustomDomain == null) {
+            return com.google.firebase.functions.FirebaseFunctions.getInstance();
+        } else {
+            return com.google.firebase.functions.FirebaseFunctions.getInstance(regionOrCustomDomain);
+        }
     }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/firebase/functions/FirebaseFunctionsPlugin.java

@@ -17,6 +17,7 @@ public class FirebaseFunctionsPlugin extends Plugin {
     public static final String TAG = "FirebaseFunctions";
     public static final String ERROR_NAME_MISSING = "name must be provided.";
     public static final String ERROR_URL_MISSING = "url must be provided.";
+    public static final String ERROR_HOST_MISSING = "host must be provided.";
 
     private FirebaseFunctions implementation;
 
@@ -28,14 +29,15 @@ public class FirebaseFunctionsPlugin extends Plugin {
     public void callByName(PluginCall call) {
         try {
             JSObject json = call.getData();
-            String name = json.getString("name");
+            String name = json.getString("name", null);
             if (name == null) {
                 call.reject(ERROR_NAME_MISSING);
                 return;
             }
+            String region = json.getString("region", null);
             Object data = json.opt("data");
 
-            CallByNameOptions options = new CallByNameOptions(name, data);
+            CallByNameOptions options = new CallByNameOptions(name, region, data);
             NonEmptyResultCallback callback = new NonEmptyResultCallback() {
                 @Override
                 public void success(Result result) {
@@ -87,4 +89,22 @@ public class FirebaseFunctionsPlugin extends Plugin {
             call.reject(exception.getMessage());
         }
     }
+
+    @PluginMethod
+    public void useEmulator(PluginCall call) {
+        try {
+            String host = call.getString("host");
+            if (host == null) {
+                call.reject(ERROR_HOST_MISSING);
+                return;
+            }
+            int port = call.getInt("port", 5001);
+
+            implementation.useEmulator(host, port);
+            call.resolve();
+        } catch (Exception exception) {
+            Logger.error(TAG, exception.getMessage(), exception);
+            call.reject(exception.getMessage());
+        }
+    }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/firebase/functions/classes/options/CallByNameOptions.java

@@ -1,19 +1,29 @@
 package io.capawesome.capacitorjs.plugins.firebase.functions.classes.options;
 
 import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 
 public class CallByNameOptions extends CallOptions {
 
     @NonNull
     private String name;
 
-    public CallByNameOptions(@NonNull String name, Object data) {
+    @Nullable
+    private String region;
+
+    public CallByNameOptions(@NonNull String name, @Nullable String region, Object data) {
         super(data);
         this.name = name;
+        this.region = region;
     }
 
     @NonNull
     public String getName() {
         return name;
     }
+
+    @Nullable
+    public String getRegion() {
+        return region;
+    }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/firebase/functions/classes/options/CallByUrlOptions.java

@@ -1,19 +1,21 @@
 package io.capawesome.capacitorjs.plugins.firebase.functions.classes.options;
 
 import androidx.annotation.NonNull;
+import java.net.MalformedURLException;
+import java.net.URL;
 
 public class CallByUrlOptions extends CallOptions {
 
     @NonNull
-    private String url;
+    private URL url;
 
-    public CallByUrlOptions(@NonNull String url, Object data) {
+    public CallByUrlOptions(@NonNull String url, Object data) throws MalformedURLException {
         super(data);
-        this.url = url;
+        this.url = new URL(url);
     }
 
     @NonNull
-    public String getUrl() {
+    public URL getUrl() {
         return url;
     }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/firebase/functions/classes/results/CallResult.java

@@ -2,8 +2,11 @@ package io.capawesome.capacitorjs.plugins.firebase.functions.classes.results;
 
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
+import com.getcapacitor.JSArray;
 import com.getcapacitor.JSObject;
 import io.capawesome.capacitorjs.plugins.firebase.functions.interfaces.Result;
+import java.util.ArrayList;
+import java.util.Map;
 
 public class CallResult implements Result {
 
@@ -16,10 +19,49 @@ public class CallResult implements Result {
 
     @NonNull
     public JSObject toJSObject() {
-        Object dataResult = this.data;
+        Object dataResult = CallResult.createJSValue(data);
 
         JSObject result = new JSObject();
         result.put("data", dataResult);
         return result;
     }
+
+    @Nullable
+    private static Object createJSValue(@Nullable Object object) {
+        if (object instanceof Map) {
+            return createJSObjectFromMap((Map<String, Object>) object);
+        } else if (object instanceof ArrayList) {
+            return createJSArrayFromArrayList((ArrayList) object);
+        }
+        return object;
+    }
+
+    @Nullable
+    private static JSObject createJSObjectFromMap(@Nullable Map<String, Object> map) {
+        if (map == null) {
+            return null;
+        }
+        JSObject object = new JSObject();
+        for (String key : map.keySet()) {
+            Object value = map.get(key);
+            if (value instanceof ArrayList) {
+                value = createJSArrayFromArrayList((ArrayList) value);
+            } else if (value instanceof Map) {
+                value = createJSObjectFromMap((Map<String, Object>) value);
+            }
+            object.put(key, value);
+        }
+        return object;
+    }
+
+    private static JSArray createJSArrayFromArrayList(ArrayList arrayList) {
+        JSArray array = new JSArray();
+        for (Object value : arrayList) {
+            if (value instanceof Map) {
+                value = createJSObjectFromMap((Map<String, Object>) value);
+            }
+            array.put(value);
+        }
+        return array;
+    }
 }

package/dist/docs.json

@@ -7,43 +7,78 @@
     "methods": [
       {
         "name": "callByName",
-        "signature": "(options: CallByNameOptions) => Promise<CallByNameResult>",
+        "signature": "<RequestData = unknown, ResponseData = unknown>(options: CallByNameOptions<RequestData>) => Promise<CallByNameResult<ResponseData>>",
         "parameters": [
           {
             "name": "options",
             "docs": "",
-            "type": "CallByNameOptions"
+            "type": "CallByNameOptions<RequestData>"
           }
         ],
-        "returns": "Promise<CallResult>",
-        "tags": [],
-        "docs": "",
+        "returns": "Promise<CallByNameResult<ResponseData>>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "6.1.0"
+          }
+        ],
+        "docs": "Call a callable function by name.",
         "complexTypes": [
-          "CallResult",
+          "CallByNameResult",
+          "ResponseData",
           "CallByNameOptions",
-          "CallByNameResult"
+          "RequestData"
         ],
         "slug": "callbyname"
       },
       {
         "name": "callByUrl",
-        "signature": "(options: CallByUrlOptions) => Promise<CallByUrlResult>",
+        "signature": "<RequestData = unknown, ResponseData = unknown>(options: CallByUrlOptions<RequestData>) => Promise<CallByUrlResult<ResponseData>>",
         "parameters": [
           {
             "name": "options",
             "docs": "",
-            "type": "CallByUrlOptions"
+            "type": "CallByUrlOptions<RequestData>"
+          }
+        ],
+        "returns": "Promise<CallByUrlResult<ResponseData>>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "6.1.0"
           }
         ],
-        "returns": "Promise<CallResult>",
-        "tags": [],
-        "docs": "",
+        "docs": "Call a callable function by URL.",
         "complexTypes": [
-          "CallResult",
+          "CallByUrlResult",
+          "ResponseData",
           "CallByUrlOptions",
-          "CallByUrlResult"
+          "RequestData"
         ],
         "slug": "callbyurl"
+      },
+      {
+        "name": "useEmulator",
+        "signature": "(options: UseEmulatorOptions) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "UseEmulatorOptions"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "6.1.0"
+          }
+        ],
+        "docs": "Instrument your app to talk to the Cloud Functions emulator.\n\nOn Android, the cleartext traffic must be allowed. On the Capacitor configuration:\n```\n{\n  server: {\n    cleartext: true\n  }\n}\n```\n**The cleartext traffic is not intended for use in production.**",
+        "complexTypes": [
+          "UseEmulatorOptions"
+        ],
+        "slug": "useemulator"
       }
     ],
     "properties": []
@@ -53,15 +88,27 @@
       "name": "CallResult",
       "slug": "callresult",
       "docs": "",
-      "tags": [],
+      "tags": [
+        {
+          "text": "6.1.0",
+          "name": "since"
+        }
+      ],
       "methods": [],
       "properties": [
         {
           "name": "data",
-          "tags": [],
-          "docs": "",
-          "complexTypes": [],
-          "type": "any"
+          "tags": [
+            {
+              "text": "6.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The result of the callable function.",
+          "complexTypes": [
+            "ResponseData"
+          ],
+          "type": "ResponseData"
         }
       ]
     },
@@ -69,15 +116,45 @@
       "name": "CallByNameOptions",
       "slug": "callbynameoptions",
       "docs": "",
-      "tags": [],
+      "tags": [
+        {
+          "text": "6.1.0",
+          "name": "since"
+        }
+      ],
       "methods": [],
       "properties": [
         {
           "name": "name",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "'myFunction'",
+              "name": "example"
+            },
+            {
+              "text": "6.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The name of the callable function.",
           "complexTypes": [],
           "type": "string"
+        },
+        {
+          "name": "region",
+          "tags": [
+            {
+              "text": "'us-central1'",
+              "name": "example"
+            },
+            {
+              "text": "6.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The region of the callable function.",
+          "complexTypes": [],
+          "type": "string | undefined"
         }
       ]
     },
@@ -85,17 +162,81 @@
       "name": "CallByUrlOptions",
       "slug": "callbyurloptions",
       "docs": "",
-      "tags": [],
+      "tags": [
+        {
+          "text": "6.1.0",
+          "name": "since"
+        }
+      ],
       "methods": [],
       "properties": [
         {
           "name": "url",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "'https://us-central1-my-project.cloudfunctions.net/myFunction'",
+              "name": "example"
+            },
+            {
+              "text": "6.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The URL of the callable function.",
           "complexTypes": [],
           "type": "string"
         }
       ]
+    },
+    {
+      "name": "UseEmulatorOptions",
+      "slug": "useemulatoroptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "6.1.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "host",
+          "tags": [
+            {
+              "text": "6.1.0",
+              "name": "since"
+            },
+            {
+              "text": "\"127.0.0.1\"",
+              "name": "example"
+            }
+          ],
+          "docs": "The emulator host without any port or scheme.\n\nNote when using a Android Emulator device: 10.0.2.2 is the special IP address to connect to the 'localhost' of the host computer.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "port",
+          "tags": [
+            {
+              "text": "6.1.0",
+              "name": "since"
+            },
+            {
+              "text": "5001",
+              "name": "default"
+            },
+            {
+              "text": "5001",
+              "name": "example"
+            }
+          ],
+          "docs": "The emulator port.",
+          "complexTypes": [],
+          "type": "number | undefined"
+        }
+      ]
     }
   ],
   "enums": [],
@@ -106,9 +247,10 @@
       "docs": "",
       "types": [
         {
-          "text": "CallResult",
+          "text": "CallResult<ResponseData>",
           "complexTypes": [
-            "CallResult"
+            "CallResult",
+            "ResponseData"
           ]
         }
       ]
@@ -119,9 +261,10 @@
       "docs": "",
       "types": [
         {
-          "text": "CallResult",
+          "text": "CallResult<ResponseData>",
           "complexTypes": [
-            "CallResult"
+            "CallResult",
+            "ResponseData"
           ]
         }
       ]

package/dist/esm/definitions.d.ts

@@ -1,18 +1,113 @@
 export interface FirebaseFunctionsPlugin {
-    callByName(options: CallByNameOptions): Promise<CallByNameResult>;
-    callByUrl(options: CallByUrlOptions): Promise<CallByUrlResult>;
+    /**
+     * Call a callable function by name.
+     *
+     * @since 6.1.0
+     */
+    callByName<RequestData = unknown, ResponseData = unknown>(options: CallByNameOptions<RequestData>): Promise<CallByNameResult<ResponseData>>;
+    /**
+     * Call a callable function by URL.
+     *
+     * @since 6.1.0
+     */
+    callByUrl<RequestData = unknown, ResponseData = unknown>(options: CallByUrlOptions<RequestData>): Promise<CallByUrlResult<ResponseData>>;
+    /**
+     * Instrument your app to talk to the Cloud Functions emulator.
+     *
+     * On Android, the cleartext traffic must be allowed. On the Capacitor configuration:
+     * ```
+     * {
+     *   server: {
+     *     cleartext: true
+     *   }
+     * }
+     * ```
+     * **The cleartext traffic is not intended for use in production.**
+     *
+     * @since 6.1.0
+     */
+    useEmulator(options: UseEmulatorOptions): Promise<void>;
 }
-export interface CallByNameOptions extends CallOptions {
+/**
+ * @since 6.1.0
+ */
+export interface CallByNameOptions<RequestData = unknown> extends CallOptions<RequestData> {
+    /**
+     * The name of the callable function.
+     *
+     * @example 'myFunction'
+     * @since 6.1.0
+     */
     name: string;
+    /**
+     * The region of the callable function.
+     *
+     * @example 'us-central1'
+     * @since 6.1.0
+     */
+    region?: string;
 }
-export declare type CallByNameResult = CallResult;
-export interface CallByUrlOptions extends CallOptions {
+/**
+ * @since 6.1.0
+ */
+export declare type CallByNameResult<ResponseData = unknown> = CallResult<ResponseData>;
+/**
+ * @since 6.1.0
+ */
+export interface CallByUrlOptions<RequestData = unknown> extends CallOptions<RequestData> {
+    /**
+     * The URL of the callable function.
+     *
+     * @example 'https://us-central1-my-project.cloudfunctions.net/myFunction'
+     * @since 6.1.0
+     */
     url: string;
 }
-export declare type CallByUrlResult = CallResult;
-export interface CallOptions {
-    data?: any;
+/**
+ * @since 6.1.0
+ */
+export declare type CallByUrlResult<ResponseData = unknown> = CallResult<ResponseData>;
+/**
+ * @since 6.1.0
+ */
+export interface CallOptions<RequestData = unknown> {
+    /**
+     * The data to pass to the callable function.
+     *
+     * @since 6.1.0
+     */
+    data?: RequestData | null;
 }
-export interface CallResult {
-    data?: any;
+/**
+ * @since 6.1.0
+ */
+export interface CallResult<ResponseData = unknown> {
+    /**
+     * The result of the callable function.
+     *
+     * @since 6.1.0
+     */
+    data: ResponseData;
+}
+/**
+ * @since 6.1.0
+ */
+export interface UseEmulatorOptions {
+    /**
+     * The emulator host without any port or scheme.
+     *
+     * Note when using a Android Emulator device: 10.0.2.2 is the special IP address to connect to the 'localhost' of the host computer.
+     *
+     * @since 6.1.0
+     * @example "127.0.0.1"
+     */
+    host: string;
+    /**
+     * The emulator port.
+     *
+     * @since 6.1.0
+     * @default 5001
+     * @example 5001
+     */
+    port?: number;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface FirebaseFunctionsPlugin {\n  callByName(options: CallByNameOptions): Promise<CallByNameResult>;\n  callByUrl(options: CallByUrlOptions): Promise<CallByUrlResult>;\n}\n\nexport interface CallByNameOptions extends CallOptions {\n  name: string;\n}\n\nexport type CallByNameResult = CallResult;\n\nexport interface CallByUrlOptions extends CallOptions {\n  url: string;\n}\n\nexport type CallByUrlResult = CallResult;\n\nexport interface CallOptions {\n  data?: any;\n}\n\nexport interface CallResult {\n  data?: any;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface FirebaseFunctionsPlugin {\n  /**\n   * Call a callable function by name.\n   *\n   * @since 6.1.0\n   */\n  callByName<RequestData = unknown, ResponseData = unknown>(\n    options: CallByNameOptions<RequestData>,\n  ): Promise<CallByNameResult<ResponseData>>;\n  /**\n   * Call a callable function by URL.\n   *\n   * @since 6.1.0\n   */\n  callByUrl<RequestData = unknown, ResponseData = unknown>(\n    options: CallByUrlOptions<RequestData>,\n  ): Promise<CallByUrlResult<ResponseData>>;\n  /**\n   * Instrument your app to talk to the Cloud Functions emulator.\n   *\n   * On Android, the cleartext traffic must be allowed. On the Capacitor configuration:\n   * ```\n   * {\n   *   server: {\n   *     cleartext: true\n   *   }\n   * }\n   * ```\n   * **The cleartext traffic is not intended for use in production.**\n   *\n   * @since 6.1.0\n   */\n  useEmulator(options: UseEmulatorOptions): Promise<void>;\n}\n\n/**\n * @since 6.1.0\n */\nexport interface CallByNameOptions<RequestData = unknown>\n  extends CallOptions<RequestData> {\n  /**\n   * The name of the callable function.\n   *\n   * @example 'myFunction'\n   * @since 6.1.0\n   */\n  name: string;\n  /**\n   * The region of the callable function.\n   *\n   * @example 'us-central1'\n   * @since 6.1.0\n   */\n  region?: string;\n}\n\n/**\n * @since 6.1.0\n */\nexport type CallByNameResult<ResponseData = unknown> = CallResult<ResponseData>;\n\n/**\n * @since 6.1.0\n */\nexport interface CallByUrlOptions<RequestData = unknown>\n  extends CallOptions<RequestData> {\n  /**\n   * The URL of the callable function.\n   *\n   * @example 'https://us-central1-my-project.cloudfunctions.net/myFunction'\n   * @since 6.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 6.1.0\n */\nexport type CallByUrlResult<ResponseData = unknown> = CallResult<ResponseData>;\n\n/**\n * @since 6.1.0\n */\nexport interface CallOptions<RequestData = unknown> {\n  /**\n   * The data to pass to the callable function.\n   *\n   * @since 6.1.0\n   */\n  data?: RequestData | null;\n}\n\n/**\n * @since 6.1.0\n */\nexport interface CallResult<ResponseData = unknown> {\n  /**\n   * The result of the callable function.\n   *\n   * @since 6.1.0\n   */\n  data: ResponseData;\n}\n\n/**\n * @since 6.1.0\n */\nexport interface UseEmulatorOptions {\n  /**\n   * The emulator host without any port or scheme.\n   *\n   * Note when using a Android Emulator device: 10.0.2.2 is the special IP address to connect to the 'localhost' of the host computer.\n   *\n   * @since 6.1.0\n   * @example \"127.0.0.1\"\n   */\n  host: string;\n  /**\n   * The emulator port.\n   *\n   * @since 6.1.0\n   * @default 5001\n   * @example 5001\n   */\n  port?: number;\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,6 +1,7 @@
 import { WebPlugin } from '@capacitor/core';
-import type { CallByNameOptions, CallByNameResult, CallByUrlOptions, CallResult, FirebaseFunctionsPlugin } from './definitions';
+import type { CallByNameOptions, CallByNameResult, CallByUrlOptions, CallResult, FirebaseFunctionsPlugin, UseEmulatorOptions } from './definitions';
 export declare class FirebaseFunctionsWeb extends WebPlugin implements FirebaseFunctionsPlugin {
-    callByName(options: CallByNameOptions): Promise<CallByNameResult>;
-    callByUrl(options: CallByUrlOptions): Promise<CallResult>;
+    callByName<RequestData = unknown, ResponseData = unknown>(options: CallByNameOptions<RequestData>): Promise<CallByNameResult<ResponseData>>;
+    callByUrl<RequestData = unknown, ResponseData = unknown>(options: CallByUrlOptions<RequestData>): Promise<CallResult<ResponseData>>;
+    useEmulator(options: UseEmulatorOptions): Promise<void>;
 }

package/dist/esm/web.js

@@ -1,8 +1,8 @@
 import { WebPlugin } from '@capacitor/core';
-import { getFunctions, httpsCallable, httpsCallableFromURL, } from 'firebase/functions';
+import { connectFunctionsEmulator, getFunctions, httpsCallable, httpsCallableFromURL, } from 'firebase/functions';
 export class FirebaseFunctionsWeb extends WebPlugin {
     async callByName(options) {
-        const functions = getFunctions();
+        const functions = getFunctions(undefined, options.region);
         const callable = httpsCallable(functions, options.name);
         const result = await callable(options.data);
         return {
@@ -17,5 +17,10 @@ export class FirebaseFunctionsWeb extends WebPlugin {
             data: result.data,
         };
     }
+    async useEmulator(options) {
+        const functions = getFunctions();
+        const port = options.port || 5001;
+        connectFunctionsEmulator(functions, options.host, port);
+    }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAU5B,MAAM,OAAO,oBACX,SAAQ,SAAS;IAGV,KAAK,CAAC,UAAU,CACrB,OAA0B;QAE1B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,OAAyB;QAC9C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport {\n  getFunctions,\n  httpsCallable,\n  httpsCallableFromURL,\n} from 'firebase/functions';\n\nimport type {\n  CallByNameOptions,\n  CallByNameResult,\n  CallByUrlOptions,\n  CallResult,\n  FirebaseFunctionsPlugin,\n} from './definitions';\n\nexport class FirebaseFunctionsWeb\n  extends WebPlugin\n  implements FirebaseFunctionsPlugin\n{\n  public async callByName(\n    options: CallByNameOptions,\n  ): Promise<CallByNameResult> {\n    const functions = getFunctions();\n    const callable = httpsCallable(functions, options.name);\n    const result = await callable(options.data);\n    return {\n      data: result.data,\n    };\n  }\n\n  public async callByUrl(options: CallByUrlOptions): Promise<CallResult> {\n    const functions = getFunctions();\n    const callable = httpsCallableFromURL(functions, options.url);\n    const result = await callable(options.data);\n    return {\n      data: result.data,\n    };\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAW5B,MAAM,OAAO,oBACX,SAAQ,SAAS;IAGV,KAAK,CAAC,UAAU,CACrB,OAAuC;QAEvC,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,aAAa,CAC5B,SAAS,EACT,OAAO,CAAC,IAAI,CACb,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,OAAsC;QAEtC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,oBAAoB,CACnC,SAAS,EACT,OAAO,CAAC,GAAG,CACZ,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,OAA2B;QAClD,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;QAClC,wBAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\nimport {\n  connectFunctionsEmulator,\n  getFunctions,\n  httpsCallable,\n  httpsCallableFromURL,\n} from 'firebase/functions';\n\nimport type {\n  CallByNameOptions,\n  CallByNameResult,\n  CallByUrlOptions,\n  CallResult,\n  FirebaseFunctionsPlugin,\n  UseEmulatorOptions,\n} from './definitions';\n\nexport class FirebaseFunctionsWeb\n  extends WebPlugin\n  implements FirebaseFunctionsPlugin\n{\n  public async callByName<RequestData = unknown, ResponseData = unknown>(\n    options: CallByNameOptions<RequestData>,\n  ): Promise<CallByNameResult<ResponseData>> {\n    const functions = getFunctions(undefined, options.region);\n    const callable = httpsCallable<RequestData, ResponseData>(\n      functions,\n      options.name,\n    );\n    const result = await callable(options.data);\n    return {\n      data: result.data,\n    };\n  }\n\n  public async callByUrl<RequestData = unknown, ResponseData = unknown>(\n    options: CallByUrlOptions<RequestData>,\n  ): Promise<CallResult<ResponseData>> {\n    const functions = getFunctions();\n    const callable = httpsCallableFromURL<RequestData, ResponseData>(\n      functions,\n      options.url,\n    );\n    const result = await callable(options.data);\n    return {\n      data: result.data,\n    };\n  }\n\n  public async useEmulator(options: UseEmulatorOptions): Promise<void> {\n    const functions = getFunctions();\n    const port = options.port || 5001;\n    connectFunctionsEmulator(functions, options.host, port);\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -11,7 +11,7 @@ const FirebaseFunctions = core.registerPlugin('FirebaseFunctions', {
 
 class FirebaseFunctionsWeb extends core.WebPlugin {
     async callByName(options) {
-        const functions$1 = functions.getFunctions();
+        const functions$1 = functions.getFunctions(undefined, options.region);
         const callable = functions.httpsCallable(functions$1, options.name);
         const result = await callable(options.data);
         return {
@@ -26,6 +26,11 @@ class FirebaseFunctionsWeb extends core.WebPlugin {
             data: result.data,
         };
     }
+    async useEmulator(options) {
+        const functions$1 = functions.getFunctions();
+        const port = options.port || 5001;
+        functions.connectFunctionsEmulator(functions$1, options.host, port);
+    }
 }
 
 var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst FirebaseFunctions = registerPlugin('FirebaseFunctions', {\n    web: () => import('./web').then(m => new m.FirebaseFunctionsWeb()),\n});\nexport * from './definitions';\nexport { FirebaseFunctions };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nimport { getFunctions, httpsCallable, httpsCallableFromURL, } from 'firebase/functions';\nexport class FirebaseFunctionsWeb extends WebPlugin {\n    async callByName(options) {\n        const functions = getFunctions();\n        const callable = httpsCallable(functions, options.name);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async callByUrl(options) {\n        const functions = getFunctions();\n        const callable = httpsCallableFromURL(functions, options.url);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin","functions","getFunctions","httpsCallable","httpsCallableFromURL"],"mappings":";;;;;;;AACK,MAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;AAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACtE,CAAC;;ACDM,MAAM,oBAAoB,SAASC,cAAS,CAAC;AACpD,IAAI,MAAM,UAAU,CAAC,OAAO,EAAE;AAC9B,QAAQ,MAAMC,WAAS,GAAGC,sBAAY,EAAE,CAAC;AACzC,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAChE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS,CAAC;AACV,KAAK;AACL,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;AAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE,CAAC;AACzC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AACtE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS,CAAC;AACV,KAAK;AACL;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst FirebaseFunctions = registerPlugin('FirebaseFunctions', {\n    web: () => import('./web').then(m => new m.FirebaseFunctionsWeb()),\n});\nexport * from './definitions';\nexport { FirebaseFunctions };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nimport { connectFunctionsEmulator, getFunctions, httpsCallable, httpsCallableFromURL, } from 'firebase/functions';\nexport class FirebaseFunctionsWeb extends WebPlugin {\n    async callByName(options) {\n        const functions = getFunctions(undefined, options.region);\n        const callable = httpsCallable(functions, options.name);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async callByUrl(options) {\n        const functions = getFunctions();\n        const callable = httpsCallableFromURL(functions, options.url);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async useEmulator(options) {\n        const functions = getFunctions();\n        const port = options.port || 5001;\n        connectFunctionsEmulator(functions, options.host, port);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin","functions","getFunctions","httpsCallable","httpsCallableFromURL","connectFunctionsEmulator"],"mappings":";;;;;;;AACK,MAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;AAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACtE,CAAC;;ACDM,MAAM,oBAAoB,SAASC,cAAS,CAAC;AACpD,IAAI,MAAM,UAAU,CAAC,OAAO,EAAE;AAC9B,QAAQ,MAAMC,WAAS,GAAGC,sBAAY,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAClE,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAChE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS,CAAC;AACV,KAAK;AACL,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;AAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE,CAAC;AACzC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AACtE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS,CAAC;AACV,KAAK;AACL,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;AAC/B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE,CAAC;AACzC,QAAQ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;AAC1C,QAAQG,kCAAwB,CAACJ,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChE,KAAK;AACL;;;;;;;;;"}

package/dist/plugin.js

@@ -7,7 +7,7 @@ var capacitorFirebaseFunctions = (function (exports, core, functions) {
 
     class FirebaseFunctionsWeb extends core.WebPlugin {
         async callByName(options) {
-            const functions$1 = functions.getFunctions();
+            const functions$1 = functions.getFunctions(undefined, options.region);
             const callable = functions.httpsCallable(functions$1, options.name);
             const result = await callable(options.data);
             return {
@@ -22,6 +22,11 @@ var capacitorFirebaseFunctions = (function (exports, core, functions) {
                 data: result.data,
             };
         }
+        async useEmulator(options) {
+            const functions$1 = functions.getFunctions();
+            const port = options.port || 5001;
+            functions.connectFunctionsEmulator(functions$1, options.host, port);
+        }
     }
 
     var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst FirebaseFunctions = registerPlugin('FirebaseFunctions', {\n    web: () => import('./web').then(m => new m.FirebaseFunctionsWeb()),\n});\nexport * from './definitions';\nexport { FirebaseFunctions };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nimport { getFunctions, httpsCallable, httpsCallableFromURL, } from 'firebase/functions';\nexport class FirebaseFunctionsWeb extends WebPlugin {\n    async callByName(options) {\n        const functions = getFunctions();\n        const callable = httpsCallable(functions, options.name);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async callByUrl(options) {\n        const functions = getFunctions();\n        const callable = httpsCallableFromURL(functions, options.url);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin","functions","getFunctions","httpsCallable","httpsCallableFromURL"],"mappings":";;;AACK,UAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;IAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACtE,CAAC;;ICDM,MAAM,oBAAoB,SAASC,cAAS,CAAC;IACpD,IAAI,MAAM,UAAU,CAAC,OAAO,EAAE;IAC9B,QAAQ,MAAMC,WAAS,GAAGC,sBAAY,EAAE,CAAC;IACzC,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS,CAAC;IACV,KAAK;IACL,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;IAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE,CAAC;IACzC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS,CAAC;IACV,KAAK;IACL;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst FirebaseFunctions = registerPlugin('FirebaseFunctions', {\n    web: () => import('./web').then(m => new m.FirebaseFunctionsWeb()),\n});\nexport * from './definitions';\nexport { FirebaseFunctions };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nimport { connectFunctionsEmulator, getFunctions, httpsCallable, httpsCallableFromURL, } from 'firebase/functions';\nexport class FirebaseFunctionsWeb extends WebPlugin {\n    async callByName(options) {\n        const functions = getFunctions(undefined, options.region);\n        const callable = httpsCallable(functions, options.name);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async callByUrl(options) {\n        const functions = getFunctions();\n        const callable = httpsCallableFromURL(functions, options.url);\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async useEmulator(options) {\n        const functions = getFunctions();\n        const port = options.port || 5001;\n        connectFunctionsEmulator(functions, options.host, port);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin","functions","getFunctions","httpsCallable","httpsCallableFromURL","connectFunctionsEmulator"],"mappings":";;;AACK,UAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;IAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACtE,CAAC;;ICDM,MAAM,oBAAoB,SAASC,cAAS,CAAC;IACpD,IAAI,MAAM,UAAU,CAAC,OAAO,EAAE;IAC9B,QAAQ,MAAMC,WAAS,GAAGC,sBAAY,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS,CAAC;IACV,KAAK;IACL,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;IAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE,CAAC;IACzC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS,CAAC;IACV,KAAK;IACL,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;IAC/B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE,CAAC;IACzC,QAAQ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAC1C,QAAQG,kCAAwB,CAACJ,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChE,KAAK;IACL;;;;;;;;;;;;;;;;;"}

package/ios/Plugin/Classes/Options/CallByNameOptions.swift

@@ -2,13 +2,19 @@ import Foundation
 
 @objc public class CallByNameOptions: CallOptions {
     private var name: String
+    private var region: String?
 
-    init(name: String, data: Any?) {
+    init(name: String, region: String?, data: Any?) {
         self.name = name
+        self.region = region
         super.init(data: data)
     }
 
     func getName() -> String {
         return name
     }
+
+    func getRegion() -> String? {
+        return region
+    }
 }

package/ios/Plugin/Classes/Results/CallResult.swift

@@ -10,7 +10,17 @@ import Capacitor
 
     public func toJSObject() -> AnyObject {
         var result = JSObject()
-        result["data"] = data as! any JSValue
+        result["data"] = CallResult.createJSValue(value: data)
         return result as AnyObject
     }
+
+    private static func createJSValue(value: Any?) -> JSValue? {
+        guard let value = value else {
+            return nil
+        }
+        guard let value = JSTypes.coerceDictionaryToJSObject(["key": value]) as JSObject? else {
+            return nil
+        }
+        return value["key"]
+    }
 }

package/ios/Plugin/FirebaseFunctions.swift

@@ -15,9 +15,15 @@ import FirebaseFunctions
 
     @objc public func callByName(_ options: CallByNameOptions, completion: @escaping (Result?, Error?) -> Void) {
         let name = options.getName()
+        let region = options.getRegion()
         let data = options.getData()
 
-        let functions = Functions.functions()
+        let functions: Functions
+        if let region = region {
+            functions = Functions.functions(region: region)
+        } else {
+            functions = Functions.functions()
+        }
         let callable = functions.httpsCallable(name)
         callable.call(data) { (result, error) in
             if let error = error {
@@ -44,4 +50,8 @@ import FirebaseFunctions
             }
         }
     }
+
+    @objc func useEmulator(_ host: String, _ port: Int) {
+        Functions.functions().useEmulator(withHost: host, port: port)
+    }
 }

package/ios/Plugin/FirebaseFunctionsPlugin.m

@@ -6,4 +6,5 @@
 CAP_PLUGIN(FirebaseFunctionsPlugin, "FirebaseFunctions",
            CAP_PLUGIN_METHOD(callByName, CAPPluginReturnPromise);
            CAP_PLUGIN_METHOD(callByUrl, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(useEmulator, CAPPluginReturnPromise);
 )

package/ios/Plugin/FirebaseFunctionsPlugin.swift

@@ -9,6 +9,7 @@ import Capacitor
 public class FirebaseFunctionsPlugin: CAPPlugin {
     public let tag = "FirebaseFunctions"
     public let errorNameMissing = "name must be provided."
+    public let errorHostMissing = "host must be provided."
     private var implementation: FirebaseFunctions?
 
     override public func load() {
@@ -20,9 +21,10 @@ public class FirebaseFunctionsPlugin: CAPPlugin {
             call.reject(errorNameMissing)
             return
         }
+        let region = call.getString("region")
         let data = call.getValue("data")
 
-        let options = CallByNameOptions(name: name, data: data)
+        let options = CallByNameOptions(name: name, region: region, data: data)
 
         implementation?.callByName(options, completion: { result, error in
             if let error = error {
@@ -56,4 +58,15 @@ public class FirebaseFunctionsPlugin: CAPPlugin {
             }
         })
     }
+
+    @objc func useEmulator(_ call: CAPPluginCall) {
+        guard let host = call.getString("host") else {
+            call.reject(errorHostMissing)
+            return
+        }
+        let port = call.getInt("port") ?? 5001
+
+        implementation?.useEmulator(host, port)
+        call.resolve()
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor-firebase/functions",
-  "version": "6.0.0-dev.b96fa6c.1718781196",
+  "version": "6.2.0",
   "description": "Capacitor plugin for Firebase Cloud Functions.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",