@capacitor-firebase/functions 8.0.1 → 8.2.0

package/README.md

@@ -4,10 +4,14 @@ Unofficial Capacitor plugin for [Firebase Cloud Functions](https://firebase.goog
 
 <div class="capawesome-z29o10a">
   <a href="https://cloud.capawesome.io/" target="_blank">
-    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-deploy-real-time-app-updates.png?t=1" />
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
   </a>
 </div>
 
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
 ## Compatibility
 
 | Plugin Version | Capacitor Version | Status         |
@@ -17,6 +21,21 @@ Unofficial Capacitor plugin for [Firebase Cloud Functions](https://firebase.goog
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills
+```
+
+Then use the following prompt:
+
+```
+Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capacitor-firebase/functions` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capacitor-firebase/functions
 npx cap sync

package/android/build.gradle

@@ -31,7 +31,7 @@ android {
     buildTypes {
         release {
             minifyEnabled false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
     }
     lintOptions {

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

@@ -7,6 +7,7 @@ import io.capawesome.capacitorjs.plugins.firebase.functions.classes.options.Call
 import io.capawesome.capacitorjs.plugins.firebase.functions.classes.results.CallResult;
 import io.capawesome.capacitorjs.plugins.firebase.functions.interfaces.NonEmptyResultCallback;
 import java.net.URL;
+import java.util.concurrent.TimeUnit;
 
 public class FirebaseFunctions {
 
@@ -20,9 +21,15 @@ public class FirebaseFunctions {
         String name = options.getName();
         String region = options.getRegion();
         Object data = options.getData();
+        Long timeout = options.getTimeout();
 
-        getFirebaseFunctionsInstance(region)
-            .getHttpsCallable(name)
+        com.google.firebase.functions.HttpsCallableReference callable = getFirebaseFunctionsInstance(region).getHttpsCallable(name);
+
+        if (timeout != null) {
+            callable.setTimeout(timeout, TimeUnit.MILLISECONDS);
+        }
+
+        callable
             .call(data)
             .addOnSuccessListener(task -> {
                 CallResult result = new CallResult(task.getData());
@@ -36,9 +43,15 @@ public class FirebaseFunctions {
     public void callByUrl(@NonNull CallByUrlOptions options, @NonNull NonEmptyResultCallback callback) {
         URL url = options.getUrl();
         Object data = options.getData();
+        Long timeout = options.getTimeout();
+
+        com.google.firebase.functions.HttpsCallableReference callable = getFirebaseFunctionsInstance(null).getHttpsCallableFromUrl(url);
+
+        if (timeout != null) {
+            callable.setTimeout(timeout, TimeUnit.MILLISECONDS);
+        }
 
-        getFirebaseFunctionsInstance(null)
-            .getHttpsCallableFromUrl(url)
+        callable
             .call(data)
             .addOnSuccessListener(task -> {
                 CallResult result = new CallResult(task.getData());
@@ -49,8 +62,8 @@ public class FirebaseFunctions {
             });
     }
 
-    public void useEmulator(@NonNull String host, int port) {
-        getFirebaseFunctionsInstance(null).useEmulator(host, port);
+    public void useEmulator(@NonNull String host, int port, @Nullable String regionOrCustomDomain) {
+        getFirebaseFunctionsInstance(regionOrCustomDomain).useEmulator(host, port);
     }
 
     private com.google.firebase.functions.FirebaseFunctions getFirebaseFunctionsInstance(@Nullable String regionOrCustomDomain) {

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

@@ -36,8 +36,9 @@ public class FirebaseFunctionsPlugin extends Plugin {
             }
             String region = json.getString("region", null);
             Object data = json.opt("data");
+            Long timeout = json.has("timeout") ? json.getLong("timeout") : null;
 
-            CallByNameOptions options = new CallByNameOptions(name, region, data);
+            CallByNameOptions options = new CallByNameOptions(name, region, data, timeout);
             NonEmptyResultCallback callback = new NonEmptyResultCallback() {
                 @Override
                 public void success(Result result) {
@@ -68,8 +69,9 @@ public class FirebaseFunctionsPlugin extends Plugin {
                 return;
             }
             Object data = json.opt("data");
+            Long timeout = json.has("timeout") ? json.getLong("timeout") : null;
 
-            CallByUrlOptions options = new CallByUrlOptions(url, data);
+            CallByUrlOptions options = new CallByUrlOptions(url, data, timeout);
             NonEmptyResultCallback callback = new NonEmptyResultCallback() {
                 @Override
                 public void success(Result result) {
@@ -99,8 +101,9 @@ public class FirebaseFunctionsPlugin extends Plugin {
                 return;
             }
             int port = call.getInt("port", 5001);
+            String regionOrCustomDomain = call.getString("regionOrCustomDomain", null);
 
-            implementation.useEmulator(host, port);
+            implementation.useEmulator(host, port, regionOrCustomDomain);
             call.resolve();
         } catch (Exception exception) {
             Logger.error(TAG, exception.getMessage(), exception);

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

@@ -11,8 +11,8 @@ public class CallByNameOptions extends CallOptions {
     @Nullable
     private String region;
 
-    public CallByNameOptions(@NonNull String name, @Nullable String region, Object data) {
-        super(data);
+    public CallByNameOptions(@NonNull String name, @Nullable String region, Object data, @Nullable Long timeout) {
+        super(data, timeout);
         this.name = name;
         this.region = region;
     }

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

@@ -1,6 +1,7 @@
 package io.capawesome.capacitorjs.plugins.firebase.functions.classes.options;
 
 import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 import java.net.MalformedURLException;
 import java.net.URL;
 
@@ -9,8 +10,8 @@ public class CallByUrlOptions extends CallOptions {
     @NonNull
     private URL url;
 
-    public CallByUrlOptions(@NonNull String url, Object data) throws MalformedURLException {
-        super(data);
+    public CallByUrlOptions(@NonNull String url, Object data, @Nullable Long timeout) throws MalformedURLException {
+        super(data, timeout);
         this.url = new URL(url);
     }
 

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

@@ -7,12 +7,21 @@ public class CallOptions {
     @Nullable
     private Object data;
 
-    public CallOptions(@Nullable Object data) {
+    @Nullable
+    private Long timeout;
+
+    public CallOptions(@Nullable Object data, @Nullable Long timeout) {
         this.data = data;
+        this.timeout = timeout;
     }
 
     @Nullable
     public Object getData() {
         return data;
     }
+
+    @Nullable
+    public Long getTimeout() {
+        return timeout;
+    }
 }

package/dist/esm/definitions.d.ts

@@ -77,6 +77,12 @@ export interface CallOptions<RequestData = unknown> {
      * @since 6.1.0
      */
     data?: RequestData | null;
+    /**
+     * Time in milliseconds after which to cancel if there is no response.
+     *
+     * @since 8.1.0
+     */
+    timeout?: number;
 }
 /**
  * @since 6.1.0

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  /**\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   * The region the callable functions are located in or a custom domain hosting the callable functions.\n   *\n   * @example 'us-central1'\n   * @example 'https://mydomain.com'\n   */\n  regionOrCustomDomain?: string;\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   * Time in milliseconds after which to cancel if there is no response.\n   *\n   * @since 8.1.0\n   */\n  timeout?: number;\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   * The region the callable functions are located in or a custom domain hosting the callable functions.\n   *\n   * @example 'us-central1'\n   * @example 'https://mydomain.com'\n   */\n  regionOrCustomDomain?: string;\n}\n"]}

package/dist/esm/web.js

@@ -3,7 +3,9 @@ import { connectFunctionsEmulator, getFunctions, httpsCallable, httpsCallableFro
 export class FirebaseFunctionsWeb extends WebPlugin {
     async callByName(options) {
         const functions = getFunctions(undefined, options.region);
-        const callable = httpsCallable(functions, options.name);
+        const callable = httpsCallable(functions, options.name, {
+            timeout: options.timeout,
+        });
         const result = await callable(options.data);
         return {
             data: result.data,
@@ -11,7 +13,9 @@ export class FirebaseFunctionsWeb extends WebPlugin {
     }
     async callByUrl(options) {
         const functions = getFunctions();
-        const callable = httpsCallableFromURL(functions, options.url);
+        const callable = httpsCallableFromURL(functions, options.url, {
+            timeout: options.timeout,
+        });
         const result = await callable(options.data);
         return {
             data: result.data,

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,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,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACxE,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(undefined, options.regionOrCustomDomain);\n    const port = options.port || 5001;\n    connectFunctionsEmulator(functions, options.host, port);\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,EACZ;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CACF,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,EACX;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CACF,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,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACxE,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        timeout: options.timeout,\n      },\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        timeout: options.timeout,\n      },\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(undefined, options.regionOrCustomDomain);\n    const port = options.port || 5001;\n    connectFunctionsEmulator(functions, options.host, port);\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -10,7 +10,9 @@ const FirebaseFunctions = core.registerPlugin('FirebaseFunctions', {
 class FirebaseFunctionsWeb extends core.WebPlugin {
     async callByName(options) {
         const functions$1 = functions.getFunctions(undefined, options.region);
-        const callable = functions.httpsCallable(functions$1, options.name);
+        const callable = functions.httpsCallable(functions$1, options.name, {
+            timeout: options.timeout,
+        });
         const result = await callable(options.data);
         return {
             data: result.data,
@@ -18,7 +20,9 @@ class FirebaseFunctionsWeb extends core.WebPlugin {
     }
     async callByUrl(options) {
         const functions$1 = functions.getFunctions();
-        const callable = functions.httpsCallableFromURL(functions$1, options.url);
+        const callable = functions.httpsCallableFromURL(functions$1, options.url, {
+            timeout: options.timeout,
+        });
         const result = await callable(options.data);
         return {
             data: result.data,

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 { 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(undefined, options.regionOrCustomDomain);\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;AACjE,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,CAAC;AAC/D,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;AACnD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;AAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE;AACxC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,CAAC;AACrE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;AACnD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;AAC/B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC;AAC/E,QAAQ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;AACzC,QAAQG,kCAAwB,CAACJ,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;AAC/D,IAAI;AACJ;;;;;;;;;"}
+{"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            timeout: options.timeout,\n        });\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            timeout: options.timeout,\n        });\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async useEmulator(options) {\n        const functions = getFunctions(undefined, options.regionOrCustomDomain);\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;AACjE,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE;AAChE,YAAY,OAAO,EAAE,OAAO,CAAC,OAAO;AACpC,SAAS,CAAC;AACV,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;AACnD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;AAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE;AACxC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,EAAE;AACtE,YAAY,OAAO,EAAE,OAAO,CAAC,OAAO;AACpC,SAAS,CAAC;AACV,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;AACnD,QAAQ,OAAO;AACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;AAC7B,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;AAC/B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC;AAC/E,QAAQ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;AACzC,QAAQG,kCAAwB,CAACJ,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;AAC/D,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -8,7 +8,9 @@ var capacitorFirebaseFunctions = (function (exports, core, functions) {
     class FirebaseFunctionsWeb extends core.WebPlugin {
         async callByName(options) {
             const functions$1 = functions.getFunctions(undefined, options.region);
-            const callable = functions.httpsCallable(functions$1, options.name);
+            const callable = functions.httpsCallable(functions$1, options.name, {
+                timeout: options.timeout,
+            });
             const result = await callable(options.data);
             return {
                 data: result.data,
@@ -16,7 +18,9 @@ var capacitorFirebaseFunctions = (function (exports, core, functions) {
         }
         async callByUrl(options) {
             const functions$1 = functions.getFunctions();
-            const callable = functions.httpsCallableFromURL(functions$1, options.url);
+            const callable = functions.httpsCallableFromURL(functions$1, options.url, {
+                timeout: options.timeout,
+            });
             const result = await callable(options.data);
             return {
                 data: result.data,

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 { 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(undefined, options.regionOrCustomDomain);\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;IACjE,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,CAAC;IAC/D,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;IAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE;IACxC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,CAAC;IACrE,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;IAC/B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAC/E,QAAQ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;IACzC,QAAQG,kCAAwB,CAACJ,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IAC/D,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"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            timeout: options.timeout,\n        });\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            timeout: options.timeout,\n        });\n        const result = await callable(options.data);\n        return {\n            data: result.data,\n        };\n    }\n    async useEmulator(options) {\n        const functions = getFunctions(undefined, options.regionOrCustomDomain);\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;IACjE,QAAQ,MAAM,QAAQ,GAAGC,uBAAa,CAACF,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE;IAChE,YAAY,OAAO,EAAE,OAAO,CAAC,OAAO;IACpC,SAAS,CAAC;IACV,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,SAAS,CAAC,OAAO,EAAE;IAC7B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,EAAE;IACxC,QAAQ,MAAM,QAAQ,GAAGE,8BAAoB,CAACH,WAAS,EAAE,OAAO,CAAC,GAAG,EAAE;IACtE,YAAY,OAAO,EAAE,OAAO,CAAC,OAAO;IACpC,SAAS,CAAC;IACV,QAAQ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,OAAO;IACf,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI;IAC7B,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;IAC/B,QAAQ,MAAMA,WAAS,GAAGC,sBAAY,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAC/E,QAAQ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;IACzC,QAAQG,kCAAwB,CAACJ,WAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IAC/D,IAAI;IACJ;;;;;;;;;;;;;;;"}

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

@@ -4,10 +4,10 @@ import Foundation
     private var name: String
     private var region: String?
 
-    init(name: String, region: String?, data: Any?) {
+    init(name: String, region: String?, data: Any?, timeout: Int?) {
         self.name = name
         self.region = region
-        super.init(data: data)
+        super.init(data: data, timeout: timeout)
     }
 
     func getName() -> String {

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

@@ -3,9 +3,9 @@ import Foundation
 @objc public class CallByUrlOptions: CallOptions {
     private var url: URL
 
-    init(url: String, data: Any?) {
+    init(url: String, data: Any?, timeout: Int?) {
         self.url = URL(string: url)!
-        super.init(data: data)
+        super.init(data: data, timeout: timeout)
     }
 
     func getUrl() -> URL {

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

@@ -2,12 +2,18 @@ import Foundation
 
 @objc public class CallOptions: NSObject {
     private var data: Any?
+    private var timeout: Int?
 
-    init(data: Any?) {
+    init(data: Any?, timeout: Int?) {
         self.data = data
+        self.timeout = timeout
     }
 
     func getData() -> Any? {
         return data
     }
+
+    func getTimeout() -> Int? {
+        return timeout
+    }
 }

package/ios/Plugin/FirebaseFunctions.swift

@@ -15,16 +15,14 @@ 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 timeout = options.getTimeout()
 
-        let functions: Functions
-        if let region = region {
-            functions = Functions.functions(region: region)
-        } else {
-            functions = Functions.functions()
-        }
+        let functions = getFunctions(options.getRegion())
         let callable = functions.httpsCallable(name)
+        if let timeout = timeout {
+            callable.timeoutInterval = TimeInterval(timeout) / 1000.0
+        }
         callable.call(data) { (result, error) in
             if let error = error {
                 completion(nil, error)
@@ -38,9 +36,13 @@ import FirebaseFunctions
     @objc public func callByUrl(_ options: CallByUrlOptions, completion: @escaping (Result?, Error?) -> Void) {
         let url = options.getUrl()
         let data = options.getData()
+        let timeout = options.getTimeout()
 
-        let functions = Functions.functions()
+        let functions = getFunctions(nil)
         let callable = functions.httpsCallable(url)
+        if let timeout = timeout {
+            callable.timeoutInterval = TimeInterval(timeout) / 1000.0
+        }
         callable.call(data) { (result, error) in
             if let error = error {
                 completion(nil, error)
@@ -51,7 +53,18 @@ import FirebaseFunctions
         }
     }
 
-    @objc func useEmulator(_ host: String, _ port: Int) {
-        Functions.functions().useEmulator(withHost: host, port: port)
+    @objc func useEmulator(_ host: String, _ port: Int, _ regionOrCustomDomain: String?) {
+        let functions = getFunctions(regionOrCustomDomain)
+        functions.useEmulator(withHost: host, port: port)
+    }
+
+    private func getFunctions(_ regionOrCustomDomain: String?) -> Functions {
+        guard let value = regionOrCustomDomain else {
+            return Functions.functions()
+        }
+        if value.hasPrefix("http://") || value.hasPrefix("https://") {
+            return Functions.functions(customDomain: value)
+        }
+        return Functions.functions(region: value)
     }
 }

package/ios/Plugin/FirebaseFunctionsPlugin.swift

@@ -30,8 +30,9 @@ public class FirebaseFunctionsPlugin: CAPPlugin, CAPBridgedPlugin {
         }
         let region = call.getString("region")
         let data = call.getValue("data")
+        let timeout = call.getInt("timeout")
 
-        let options = CallByNameOptions(name: name, region: region, data: data)
+        let options = CallByNameOptions(name: name, region: region, data: data, timeout: timeout)
 
         implementation?.callByName(options, completion: { result, error in
             if let error = error {
@@ -51,8 +52,9 @@ public class FirebaseFunctionsPlugin: CAPPlugin, CAPBridgedPlugin {
             return
         }
         let data = call.getValue("data")
+        let timeout = call.getInt("timeout")
 
-        let options = CallByUrlOptions(url: url, data: data)
+        let options = CallByUrlOptions(url: url, data: data, timeout: timeout)
 
         implementation?.callByUrl(options, completion: { result, error in
             if let error = error {
@@ -72,8 +74,9 @@ public class FirebaseFunctionsPlugin: CAPPlugin, CAPBridgedPlugin {
             return
         }
         let port = call.getInt("port") ?? 5001
+        let regionOrCustomDomain = call.getString("regionOrCustomDomain") ?? nil
 
-        implementation?.useEmulator(host, port)
+        implementation?.useEmulator(host, port, regionOrCustomDomain)
         call.resolve()
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor-firebase/functions",
-  "version": "8.0.1",
+  "version": "8.2.0",
   "description": "Capacitor plugin for Firebase Cloud Functions.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -64,7 +64,6 @@
     "@capacitor/docgen": "0.3.1",
     "@capacitor/ios": "8.0.0",
     "@ionic/eslint-config": "0.4.0",
-    "@ionic/swiftlint-config": "2.0.0",
     "eslint": "8.57.0",
     "firebase": "11.2.0",
     "prettier": "3.4.2",
@@ -83,7 +82,6 @@
       "optional": true
     }
   },
-  "swiftlint": "@ionic/swiftlint-config",
   "eslintConfig": {
     "extends": "@ionic/eslint-config/recommended"
   },