@react-native-firebase/analytics 20.3.0 → 20.4.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [20.4.0](https://github.com/invertase/react-native-firebase/compare/v20.3.0...v20.4.0) (2024-08-13)
+
+### Bug Fixes
+
+- **analytics:** update the typing for Item ([#7919](https://github.com/invertase/react-native-firebase/issues/7919)) ([c2c4576](https://github.com/invertase/react-native-firebase/commit/c2c457608c865f6d25e4b9b6689cbc00721de194))
+
 ## [20.3.0](https://github.com/invertase/react-native-firebase/compare/v20.2.1...v20.3.0) (2024-07-19)
 
 ### Bug Fixes

package/__tests__/analytics.test.ts

@@ -1,6 +1,60 @@
 import { describe, expect, it, xit } from '@jest/globals';
 
-import { firebase } from '../lib';
+import {
+  firebase,
+  getAnalytics,
+  initializeAnalytics,
+  logEvent,
+  setAnalyticsCollectionEnabled,
+  setSessionTimeoutDuration,
+  getAppInstanceId,
+  getSessionId,
+  setUserId,
+  setUserProperty,
+  setUserProperties,
+  resetAnalyticsData,
+  logAddPaymentInfo,
+  logScreenView,
+  logAddShippingInfo,
+  logAddToCart,
+  logAddToWishlist,
+  logAppOpen,
+  logBeginCheckout,
+  logCampaignDetails,
+  logEarnVirtualCurrency,
+  logGenerateLead,
+  logJoinGroup,
+  logLevelEnd,
+  logLevelStart,
+  logLevelUp,
+  logLogin,
+  logPostScore,
+  logSelectContent,
+  logPurchase,
+  logRefund,
+  logRemoveFromCart,
+  logSearch,
+  logSelectItem,
+  logSetCheckoutOption,
+  logSelectPromotion,
+  logShare,
+  logSignUp,
+  logSpendVirtualCurrency,
+  logTutorialBegin,
+  logTutorialComplete,
+  logUnlockAchievement,
+  logViewCart,
+  logViewItem,
+  logViewItemList,
+  logViewPromotion,
+  logViewSearchResults,
+  setDefaultEventParameters,
+  initiateOnDeviceConversionMeasurementWithEmailAddress,
+  initiateOnDeviceConversionMeasurementWithPhoneNumber,
+  isSupported,
+  setConsent,
+  settings,
+} from '../lib';
 
 describe('Analytics', function () {
   describe('namespace', function () {
@@ -595,4 +649,214 @@ describe('Analytics', function () {
       );
     });
   });
+
+  describe('modular', function () {
+    it('`getAnalytics` function is properly exposed to end user', function () {
+      expect(getAnalytics).toBeDefined();
+    });
+
+    it('`initializeAnalytics` function is properly exposed to end user', function () {
+      expect(initializeAnalytics).toBeDefined();
+    });
+
+    it('`logEvent` function is properly exposed to end user', function () {
+      expect(logEvent).toBeDefined();
+    });
+
+    it('`setAnalyticsCollectionEnabled` function is properly exposed to end user', function () {
+      expect(setAnalyticsCollectionEnabled).toBeDefined();
+    });
+
+    it('`setSessionTimeoutDuration` function is properly exposed to end user', function () {
+      expect(setSessionTimeoutDuration).toBeDefined();
+    });
+
+    it('`getAppInstanceId` function is properly exposed to end user', function () {
+      expect(getAppInstanceId).toBeDefined();
+    });
+
+    it('`getSessionId` function is properly exposed to end user', function () {
+      expect(getSessionId).toBeDefined();
+    });
+
+    it('`setUserId` function is properly exposed to end user', function () {
+      expect(setUserId).toBeDefined();
+    });
+
+    it('`setUserProperty` function is properly exposed to end user', function () {
+      expect(setUserProperty).toBeDefined();
+    });
+
+    it('`setUserProperties` function is properly exposed to end user', function () {
+      expect(setUserProperties).toBeDefined();
+    });
+
+    it('`resetAnalyticsData` function is properly exposed to end user', function () {
+      expect(resetAnalyticsData).toBeDefined();
+    });
+
+    it('`logAddPaymentInfo` function is properly exposed to end user', function () {
+      expect(logAddPaymentInfo).toBeDefined();
+    });
+
+    it('`logScreenView` function is properly exposed to end user', function () {
+      expect(logScreenView).toBeDefined();
+    });
+
+    it('`logAddShippingInfo` function is properly exposed to end user', function () {
+      expect(logAddShippingInfo).toBeDefined();
+    });
+
+    it('`logAddToCart` function is properly exposed to end user', function () {
+      expect(logAddToCart).toBeDefined();
+    });
+
+    it('`logAddToWishlist` function is properly exposed to end user', function () {
+      expect(logAddToWishlist).toBeDefined();
+    });
+
+    it('`logAppOpen` function is properly exposed to end user', function () {
+      expect(logAppOpen).toBeDefined();
+    });
+
+    it('`logBeginCheckout` function is properly exposed to end user', function () {
+      expect(logBeginCheckout).toBeDefined();
+    });
+
+    it('`logCampaignDetails` function is properly exposed to end user', function () {
+      expect(logCampaignDetails).toBeDefined();
+    });
+
+    it('`logEarnVirtualCurrency` function is properly exposed to end user', function () {
+      expect(logEarnVirtualCurrency).toBeDefined();
+    });
+
+    it('`logGenerateLead` function is properly exposed to end user', function () {
+      expect(logGenerateLead).toBeDefined();
+    });
+
+    it('`logJoinGroup` function is properly exposed to end user', function () {
+      expect(logJoinGroup).toBeDefined();
+    });
+
+    it('`logLevelEnd` function is properly exposed to end user', function () {
+      expect(logLevelEnd).toBeDefined();
+    });
+
+    it('`logLevelStart` function is properly exposed to end user', function () {
+      expect(logLevelStart).toBeDefined();
+    });
+
+    it('`logLevelUp` function is properly exposed to end user', function () {
+      expect(logLevelUp).toBeDefined();
+    });
+
+    it('`logLogin` function is properly exposed to end user', function () {
+      expect(logLogin).toBeDefined();
+    });
+
+    it('`logPostScore` function is properly exposed to end user', function () {
+      expect(logPostScore).toBeDefined();
+    });
+
+    it('`logSelectContent` function is properly exposed to end user', function () {
+      expect(logSelectContent).toBeDefined();
+    });
+
+    it('`logPurchase` function is properly exposed to end user', function () {
+      expect(logPurchase).toBeDefined();
+    });
+
+    it('`logRefund` function is properly exposed to end user', function () {
+      expect(logRefund).toBeDefined();
+    });
+
+    it('`logRemoveFromCart` function is properly exposed to end user', function () {
+      expect(logRemoveFromCart).toBeDefined();
+    });
+
+    it('`logSearch` function is properly exposed to end user', function () {
+      expect(logSearch).toBeDefined();
+    });
+
+    it('`logSelectItem` function is properly exposed to end user', function () {
+      expect(logSelectItem).toBeDefined();
+    });
+
+    it('`logSetCheckoutOption` function is properly exposed to end user', function () {
+      expect(logSetCheckoutOption).toBeDefined();
+    });
+
+    it('`logSelectPromotion` function is properly exposed to end user', function () {
+      expect(logSelectPromotion).toBeDefined();
+    });
+
+    it('`logShare` function is properly exposed to end user', function () {
+      expect(logShare).toBeDefined();
+    });
+
+    it('`logSignUp` function is properly exposed to end user', function () {
+      expect(logSignUp).toBeDefined();
+    });
+
+    it('`logSpendVirtualCurrency` function is properly exposed to end user', function () {
+      expect(logSpendVirtualCurrency).toBeDefined();
+    });
+
+    it('`logTutorialBegin` function is properly exposed to end user', function () {
+      expect(logTutorialBegin).toBeDefined();
+    });
+
+    it('`logTutorialComplete` function is properly exposed to end user', function () {
+      expect(logTutorialComplete).toBeDefined();
+    });
+
+    it('`logUnlockAchievement` function is properly exposed to end user', function () {
+      expect(logUnlockAchievement).toBeDefined();
+    });
+
+    it('`logViewCart` function is properly exposed to end user', function () {
+      expect(logViewCart).toBeDefined();
+    });
+
+    it('`logViewItem` function is properly exposed to end user', function () {
+      expect(logViewItem).toBeDefined();
+    });
+
+    it('`logViewItemList` function is properly exposed to end user', function () {
+      expect(logViewItemList).toBeDefined();
+    });
+
+    it('`logViewPromotion` function is properly exposed to end user', function () {
+      expect(logViewPromotion).toBeDefined();
+    });
+
+    it('`logViewSearchResults` function is properly exposed to end user', function () {
+      expect(logViewSearchResults).toBeDefined();
+    });
+
+    it('`setDefaultEventParameters` function is properly exposed to end user', function () {
+      expect(setDefaultEventParameters).toBeDefined();
+    });
+
+    it('`initiateOnDeviceConversionMeasurementWithEmailAddress` function is properly exposed to end user', function () {
+      expect(initiateOnDeviceConversionMeasurementWithEmailAddress).toBeDefined();
+    });
+
+    it('`initiateOnDeviceConversionMeasurementWithPhoneNumber` function is properly exposed to end user', function () {
+      expect(initiateOnDeviceConversionMeasurementWithPhoneNumber).toBeDefined();
+    });
+
+    it('`isSupported` function is properly exposed to end user', function () {
+      expect(isSupported).toBeDefined();
+    });
+
+    it('`setConsent` function is properly exposed to end user', function () {
+      expect(setConsent).toBeDefined();
+    });
+
+    it('`settings` function is properly exposed to end user', function () {
+      expect(settings).toBeDefined();
+    });
+  });
 });

package/lib/index.d.ts

@@ -94,7 +94,7 @@ export namespace FirebaseAnalyticsTypes {
     /**
      * The Google [Place ID](https://developers.google.com/places/place-id) that corresponds to the associated item (String). Alternatively, you can supply your own custom Location ID.
      */
-    item_location_id?: string;
+    location_id?: string;
     /**
      * The Item variant.
      */
@@ -109,6 +109,38 @@ export namespace FirebaseAnalyticsTypes {
      * See https://github.com/invertase/react-native-firebase/issues/4578#issuecomment-771703420 for more information
      */
     price?: number;
+    /**
+     * The affiliation of the item.
+     */
+    affiliation?: string;
+    /**
+     * The coupon associated with the item.
+     */
+    coupon?: string;
+    /**
+     * The creative name associated with the item.
+     */
+    creative_name?: string;
+    /**
+     * The creative slot associated with the item.
+     */
+    creative_slot?: string;
+    /**
+     * The discount applied to the item.
+     */
+    discount?: Currency;
+    /**
+     * The index of the item.
+     */
+    index?: number;
+    /**
+     * The promotion ID associated with the item.
+     */
+    promotion_id?: string;
+    /**
+     * The promotion name associated with the item.
+     */
+    promotion_name?: string;
   }
 
   export interface AddPaymentInfoEventParameters {

package/lib/index.js

@@ -40,58 +40,6 @@ import fallBackModule from './web/RNFBAnalyticsModule';
 import version from './version';
 import * as structs from './structs';
 
-export {
-  getAnalytics,
-  logEvent,
-  setAnalyticsCollectionEnabled,
-  setSessionTimeoutDuration,
-  getAppInstanceId,
-  getSessionId,
-  setUserId,
-  setUserProperty,
-  setUserProperties,
-  resetAnalyticsData,
-  logAddPaymentInfo,
-  logScreenView,
-  logAddShippingInfo,
-  logAddToCart,
-  logAddToWishlist,
-  logAppOpen,
-  logBeginCheckout,
-  logCampaignDetails,
-  logEarnVirtualCurrency,
-  logGenerateLead,
-  logJoinGroup,
-  logLevelEnd,
-  logLevelStart,
-  logLevelUp,
-  logLogin,
-  logPostScore,
-  logSelectContent,
-  logPurchase,
-  logRefund,
-  logRemoveFromCart,
-  logSearch,
-  logSelectItem,
-  logSetCheckoutOption,
-  logSelectPromotion,
-  logShare,
-  logSignUp,
-  logSpendVirtualCurrency,
-  logTutorialBegin,
-  logTutorialComplete,
-  logUnlockAchievement,
-  logViewCart,
-  logViewItem,
-  logViewItemList,
-  logViewPromotion,
-  logViewSearchResults,
-  setDefaultEventParameters,
-  initiateOnDeviceConversionMeasurementWithEmailAddress,
-  initiateOnDeviceConversionMeasurementWithPhoneNumber,
-  setConsent,
-} from './modular/index';
-
 const ReservedEventNames = [
   'ad_activeview',
   'ad_click',
@@ -826,6 +774,8 @@ export default createModuleNamespace({
   ModuleClass: FirebaseAnalyticsModule,
 });
 
+export * from './modular/index';
+
 // import analytics, { firebase } from '@react-native-firebase/analytics';
 // analytics().logEvent(...);
 // firebase.analytics().logEvent(...);

package/lib/modular/index.d.ts

@@ -1210,3 +1210,13 @@ export function setConsent(
  * @returns {void}
  */
 export function settings(options: FirebaseAnalyticsTypes.SettingsOptions): void;
+
+/**
+ * Retrieves the session id from the client.
+ * On iOS, Firebase SDK may return an error that is handled internally and may take many minutes to return a valid value. Check native debug logs for more details.
+ *
+ * Returns the session id or null if session is expired, null on android if FirebaseAnalytics.ConsentType.ANALYTICS_STORAGE has been set to FirebaseAnalytics.ConsentStatus.DENIED and null on iOS if ConsentType.analyticsStorage has been set to ConsentStatus.denied.
+ * @param {Analytics} instance.
+ * @returns {Promise<number | null>}
+ */
+export function getSessionId(analytics: Analytics): Promise<number | null>;