@appmetrica/react-native-analytics 3.0.0 → 3.2.0

package/lib/typescript/src/userProfile.d.ts

@@ -0,0 +1,84 @@
+export declare class UserProfile {
+    private attributes;
+    constructor();
+    apply(attribute: UserProfileUpdate): UserProfile;
+}
+type UserProfileUpdateType = 'BirthDateWithAge' | 'BirthDateWithYear' | 'BirthDateWithMonth' | 'BirthDateWithDay' | 'BirthDateValueReset' | 'BooleanValue' | 'BooleanValueReset' | 'Counter' | 'GenderValue' | 'GenderValueReset' | 'NameValue' | 'NameValueReset' | 'NotificationsEnabledValue' | 'NotificationsEnabledValueReset' | 'NumberValue' | 'NumberValueReset' | 'StringValue' | 'StringValueReset';
+export interface UserProfileUpdate {
+    type: UserProfileUpdateType;
+    key?: string;
+    value?: any;
+    ifUndefined?: boolean;
+    age?: number;
+    year?: number;
+    month?: number;
+    day?: number;
+    delta?: number;
+}
+export type UserProfileGender = 'male' | 'female' | 'other';
+export declare class Attributes {
+    static birthDate(): BirthDateAttribute;
+    static customBoolean(key: string): BooleanAttribute;
+    static customCounter(key: string): CounterAttribute;
+    static customNumber(key: string): NumberAttribute;
+    static customString(key: string): StringAttribute;
+    static gender(): GenderAttribute;
+    static userName(): NameAttribute;
+    static notificationsEnabled(): NotificationsEnabledAttribute;
+}
+export declare class BirthDateAttribute {
+    withAge(age: number): UserProfileUpdate;
+    withAgeIfUndefined(age: number): UserProfileUpdate;
+    withYear(year: number): UserProfileUpdate;
+    withYearIfUndefined(year: number): UserProfileUpdate;
+    withMonth(year: number, month: number): UserProfileUpdate;
+    withMonthIfUndefined(year: number, month: number): UserProfileUpdate;
+    withDay(year: number, month: number, day: number): UserProfileUpdate;
+    withDayIfUndefined(year: number, month: number, day: number): UserProfileUpdate;
+    withDate(date: Date): UserProfileUpdate;
+    withDateIfUndefined(date: Date): UserProfileUpdate;
+    withValueReset(): UserProfileUpdate;
+}
+export declare class BooleanAttribute {
+    private readonly key;
+    constructor(key: string);
+    withValue(value: boolean): UserProfileUpdate;
+    withValueIfUndefined(value: boolean): UserProfileUpdate;
+    withValueReset(): UserProfileUpdate;
+}
+export declare class CounterAttribute {
+    private readonly key;
+    constructor(key: string);
+    withDelta(delta: number): UserProfileUpdate;
+}
+export declare class GenderAttribute {
+    withValue(gender: UserProfileGender): UserProfileUpdate;
+    withValueIfUndefined(gender: UserProfileGender): UserProfileUpdate;
+    withValueReset(): UserProfileUpdate;
+}
+export declare class NameAttribute {
+    withValue(value: string): UserProfileUpdate;
+    withValueIfUndefined(value: string): UserProfileUpdate;
+    withValueReset(): UserProfileUpdate;
+}
+export declare class NotificationsEnabledAttribute {
+    withValue(value: boolean): UserProfileUpdate;
+    withValueIfUndefined(value: boolean): UserProfileUpdate;
+    withValueReset(): UserProfileUpdate;
+}
+export declare class NumberAttribute {
+    private readonly key;
+    constructor(key: string);
+    withValue(value: number): UserProfileUpdate;
+    withValueIfUndefined(value: number): UserProfileUpdate;
+    withValueReset(): UserProfileUpdate;
+}
+export declare class StringAttribute {
+    private readonly key;
+    constructor(key: string);
+    withValue(value: string): UserProfileUpdate;
+    withValueIfUndefined(value: string): UserProfileUpdate;
+    withValueReset(): UserProfileUpdate;
+}
+export {};
+//# sourceMappingURL=userProfile.d.ts.map

package/lib/typescript/src/userProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userProfile.d.ts","sourceRoot":"","sources":["../../../src/userProfile.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/utils.d.ts

@@ -0,0 +1,9 @@
+import type { ECommerceCartItem, ECommerceOrder, ECommerceProduct, ECommerceReferrer, ECommerceScreen } from './ecommerce';
+import type { AdRevenue } from './revenue';
+export declare function normalizeECommerceOrder(order: ECommerceOrder): ECommerceOrder;
+export declare function normalizeECommerceCartItem(item: ECommerceCartItem): ECommerceCartItem;
+export declare function normalizeECommerceProduct(product: ECommerceProduct): ECommerceProduct;
+export declare function normalizeECommerceReferrer(referrer?: ECommerceReferrer): ECommerceReferrer | undefined;
+export declare function normalizeECommerceScreen(screen: ECommerceScreen): ECommerceScreen;
+export declare function normalizeAdRevenue(adRevenue: AdRevenue): AdRevenue;
+//# sourceMappingURL=utils.d.ts.map

package/lib/typescript/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAQ3C,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAO7E;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,iBAAiB,GACtB,iBAAiB,CAKnB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,GACxB,gBAAgB,CAMlB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,iBAAiB,GAAG,SAAS,CAS/B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAMjF;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAMlE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appmetrica/react-native-analytics",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "React Native plugin for AppMetrica analytics tool",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/ecommerce.ts

@@ -1,7 +1,15 @@
+import {
+  normalizeECommerceCartItem,
+  normalizeECommerceOrder,
+  normalizeECommerceProduct,
+  normalizeECommerceReferrer,
+  normalizeECommerceScreen,
+} from './utils';
+
 export type ECommerceScreen = {
   name: string;
   searchQuery?: string;
-  payload?: Map<string, string>;
+  payload?: Map<string, string> | Record<string, string>;
   categoriesPath?: Array<string>;
 };
 
@@ -22,7 +30,7 @@ export type ECommerceProduct = {
   originalPrice?: ECommercePrice;
   promocodes?: Array<string>;
   categoriesPath?: Array<string>;
-  payload?: Map<string, string>;
+  payload?: Map<string, string> | Record<string, string>;
 };
 
 export type ECommerceReferrer = {
@@ -41,7 +49,7 @@ export type ECommerceCartItem = {
 export type ECommerceOrder = {
   orderId: string;
   products: Array<ECommerceCartItem>;
-  payload?: Map<string, string>;
+  payload?: Map<string, string> | Record<string, string>;
 };
 
 export type ECommerceEventType =
@@ -66,7 +74,7 @@ export class ECommerce {
   static showScreenEvent(screen: ECommerceScreen): ECommerceEvent {
     return {
       ecommerceEvent: 'showSceenEvent',
-      ecommerceScreen: screen,
+      ecommerceScreen: normalizeECommerceScreen(screen),
     };
   }
 
@@ -76,8 +84,8 @@ export class ECommerce {
   ): ECommerceEvent {
     return {
       ecommerceEvent: 'showProductCardEvent',
-      ecommerceScreen: screen,
-      product: product,
+      ecommerceScreen: normalizeECommerceScreen(screen),
+      product: normalizeECommerceProduct(product),
     };
   }
 
@@ -87,36 +95,36 @@ export class ECommerce {
   ): ECommerceEvent {
     return {
       ecommerceEvent: 'showProductDetailsEvent',
-      product: product,
-      referrer: referrer,
+      product: normalizeECommerceProduct(product),
+      referrer: normalizeECommerceReferrer(referrer),
     };
   }
 
   static addCartItemEvent(item: ECommerceCartItem): ECommerceEvent {
     return {
       ecommerceEvent: 'addCartItemEvent',
-      cartItem: item,
+      cartItem: normalizeECommerceCartItem(item),
     };
   }
 
   static removeCartItemEvent(item: ECommerceCartItem): ECommerceEvent {
     return {
       ecommerceEvent: 'removeCartItemEvent',
-      cartItem: item,
+      cartItem: normalizeECommerceCartItem(item),
     };
   }
 
   static beginCheckoutEvent(order: ECommerceOrder): ECommerceEvent {
     return {
       ecommerceEvent: 'beginCheckoutEvent',
-      order: order,
+      order: normalizeECommerceOrder(order),
     };
   }
 
   static purchaseEvent(order: ECommerceOrder): ECommerceEvent {
     return {
       ecommerceEvent: 'purchaseEvent',
-      order: order,
+      order: normalizeECommerceOrder(order),
     };
   }
 }

package/src/index.ts

@@ -1,6 +1,8 @@
 import { Linking, NativeModules, Platform } from 'react-native';
 import type { ECommerceEvent } from './ecommerce';
 import type { AdRevenue, Revenue } from './revenue';
+import type { UserProfile } from './userProfile';
+import { normalizeAdRevenue } from './utils';
 
 const LINKING_ERROR =
   `The package '@appmetrica/react-native-analytics' doesn't seem to be linked. Make sure: \n\n` +
@@ -51,6 +53,9 @@ export type AppMetricaConfig = {
   activationAsSessionStart?: boolean; // iOS only
   sessionsAutoTracking?: boolean; // iOS only
   appOpenTrackingEnabled?: boolean;
+  userProfileID?: string;
+
+  errorEnvironment?: Record<string, string | undefined>
 };
 
 export type PreloadInfo = {
@@ -87,6 +92,7 @@ export const UUID_KEY = 'appmetrica_uuid';
 
 export * from './ecommerce';
 export * from './revenue';
+export * from './userProfile';
 
 export default class AppMetrica {
   static activate(config: AppMetricaConfig) {
@@ -116,7 +122,7 @@ export default class AppMetrica {
     AppMetricaNative.reportAppOpen(deeplink);
   }
 
-  static reportError(identifier: string, message: string, _reason: Object) {
+  static reportError(identifier: string, message: string, _reason?: Object) {
     AppMetricaNative.reportError(identifier, message);
   }
 
@@ -164,6 +170,14 @@ export default class AppMetrica {
   }
 
   static reportAdRevenue(adRevenue: AdRevenue) {
-    AppMetricaNative.reportAdRevenue(adRevenue);
+    AppMetricaNative.reportAdRevenue(normalizeAdRevenue(adRevenue));
+  }
+
+  static reportUserProfile(userProfile: UserProfile) {
+    AppMetricaNative.reportUserProfile(userProfile)
+  }
+
+  static putErrorEnvironmentValue(key: string, value?: string) {
+    AppMetricaNative.putErrorEnvironmentValue(key, value);
   }
 }

package/src/revenue.ts

@@ -16,7 +16,7 @@ export type Receipt = {
 export type AdRevenue = {
   price: number | string;
   currency: string;
-  payload?: Map<string, string>;
+  payload?: Map<string, string> | Record<string, string>;
   adNetwork?: string;
   adPlacementID?: string;
   adPlacementName?: string;

package/src/userProfile.ts

@@ -0,0 +1,362 @@
+export class UserProfile {
+  private attributes: Array<UserProfileUpdate>;
+
+  constructor() {
+    this.attributes = [];
+  }
+
+  apply(attribute: UserProfileUpdate): UserProfile {
+    this.attributes.push(attribute);
+
+    return this;
+  }
+}
+
+type UserProfileUpdateType =
+  | 'BirthDateWithAge'
+  | 'BirthDateWithYear'
+  | 'BirthDateWithMonth'
+  | 'BirthDateWithDay'
+  | 'BirthDateValueReset'
+  | 'BooleanValue'
+  | 'BooleanValueReset'
+  | 'Counter'
+  | 'GenderValue'
+  | 'GenderValueReset'
+  | 'NameValue'
+  | 'NameValueReset'
+  | 'NotificationsEnabledValue'
+  | 'NotificationsEnabledValueReset'
+  | 'NumberValue'
+  | 'NumberValueReset'
+  | 'StringValue'
+  | 'StringValueReset';
+
+export interface UserProfileUpdate {
+  type: UserProfileUpdateType;
+  key?: string;
+  value?: any;
+  ifUndefined?: boolean;
+  age?: number;
+  year?: number;
+  month?: number;
+  day?: number;
+  delta?: number;
+}
+
+export type UserProfileGender = 'male' | 'female' | 'other';
+
+export class Attributes {
+  static birthDate() {
+    return new BirthDateAttribute();
+  }
+
+  static customBoolean(key: string) {
+    return new BooleanAttribute(key);
+  }
+
+  static customCounter(key: string) {
+    return new CounterAttribute(key);
+  }
+
+  static customNumber(key: string) {
+    return new NumberAttribute(key);
+  }
+
+  static customString(key: string) {
+    return new StringAttribute(key);
+  }
+
+  static gender() {
+    return new GenderAttribute();
+  }
+
+  static userName() {
+    return new NameAttribute();
+  }
+
+  static notificationsEnabled() {
+    return new NotificationsEnabledAttribute();
+  }
+}
+
+export class BirthDateAttribute {
+  withAge(age: number): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithAge',
+      age: age,
+      ifUndefined: false,
+    };
+  }
+
+  withAgeIfUndefined(age: number): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithAge',
+      age: age,
+      ifUndefined: true,
+    };
+  }
+
+  withYear(year: number): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithYear',
+      year: year,
+      ifUndefined: false,
+    };
+  }
+
+  withYearIfUndefined(year: number): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithYear',
+      year: year,
+      ifUndefined: true,
+    };
+  }
+
+  withMonth(year: number, month: number): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithMonth',
+      year: year,
+      month: month,
+      ifUndefined: false,
+    };
+  }
+
+  withMonthIfUndefined(year: number, month: number): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithMonth',
+      year: year,
+      month: month,
+      ifUndefined: true,
+    };
+  }
+
+  withDay(year: number, month: number, day: number): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithDay',
+      year: year,
+      month: month,
+      day: day,
+      ifUndefined: false,
+    };
+  }
+
+  withDayIfUndefined(
+    year: number,
+    month: number,
+    day: number
+  ): UserProfileUpdate {
+    return {
+      type: 'BirthDateWithDay',
+      year: year,
+      month: month,
+      day: day,
+      ifUndefined: true,
+    };
+  }
+
+  withDate(date: Date): UserProfileUpdate {
+    return this.withDay(date.getFullYear(), date.getMonth(), date.getDate());
+  }
+
+  withDateIfUndefined(date: Date): UserProfileUpdate {
+    return this.withDayIfUndefined(
+      date.getFullYear(),
+      date.getMonth(),
+      date.getDate()
+    );
+  }
+
+  withValueReset(): UserProfileUpdate {
+    return {
+      type: 'BirthDateValueReset',
+    };
+  }
+}
+
+export class BooleanAttribute {
+  private readonly key: string;
+
+  constructor(key: string) {
+    this.key = key;
+  }
+
+  withValue(value: boolean): UserProfileUpdate {
+    return {
+      type: 'BooleanValue',
+      key: this.key,
+      value: value,
+      ifUndefined: false,
+    };
+  }
+
+  withValueIfUndefined(value: boolean): UserProfileUpdate {
+    return {
+      type: 'BooleanValue',
+      key: this.key,
+      value: value,
+      ifUndefined: true,
+    };
+  }
+
+  withValueReset(): UserProfileUpdate {
+    return {
+      type: 'BooleanValueReset',
+      key: this.key,
+    };
+  }
+}
+
+export class CounterAttribute {
+  private readonly key: string;
+
+  constructor(key: string) {
+    this.key = key;
+  }
+
+  withDelta(delta: number): UserProfileUpdate {
+    return {
+      type: 'Counter',
+      key: this.key,
+      delta: delta,
+    };
+  }
+}
+
+export class GenderAttribute {
+  withValue(gender: UserProfileGender): UserProfileUpdate {
+    return {
+      type: 'GenderValue',
+      value: gender,
+      ifUndefined: false,
+    };
+  }
+
+  withValueIfUndefined(gender: UserProfileGender): UserProfileUpdate {
+    return {
+      type: 'GenderValue',
+      value: gender,
+      ifUndefined: true,
+    };
+  }
+
+  withValueReset(): UserProfileUpdate {
+    return {
+      type: 'GenderValueReset',
+    };
+  }
+}
+
+export class NameAttribute {
+  withValue(value: string): UserProfileUpdate {
+    return {
+      type: 'NameValue',
+      value: value,
+      ifUndefined: false,
+    };
+  }
+
+  withValueIfUndefined(value: string): UserProfileUpdate {
+    return {
+      type: 'NameValue',
+      value: value,
+      ifUndefined: true,
+    };
+  }
+
+  withValueReset(): UserProfileUpdate {
+    return {
+      type: 'NameValueReset',
+    };
+  }
+}
+
+export class NotificationsEnabledAttribute {
+  withValue(value: boolean): UserProfileUpdate {
+    return {
+      type: 'NotificationsEnabledValue',
+      value: value,
+      ifUndefined: false,
+    };
+  }
+
+  withValueIfUndefined(value: boolean): UserProfileUpdate {
+    return {
+      type: 'NotificationsEnabledValue',
+      value: value,
+      ifUndefined: true,
+    };
+  }
+
+  withValueReset(): UserProfileUpdate {
+    return {
+      type: 'NotificationsEnabledValueReset',
+    };
+  }
+}
+
+export class NumberAttribute {
+  private readonly key: string;
+
+  constructor(key: string) {
+    this.key = key;
+  }
+
+  withValue(value: number): UserProfileUpdate {
+    return {
+      type: 'NumberValue',
+      key: this.key,
+      value: value,
+      ifUndefined: false,
+    };
+  }
+
+  withValueIfUndefined(value: number): UserProfileUpdate {
+    return {
+      type: 'NumberValue',
+      key: this.key,
+      value: value,
+      ifUndefined: true,
+    };
+  }
+
+  withValueReset(): UserProfileUpdate {
+    return {
+      type: 'NumberValueReset',
+      key: this.key,
+    };
+  }
+}
+
+export class StringAttribute {
+  private readonly key: string;
+
+  constructor(key: string) {
+    this.key = key;
+  }
+
+  withValue(value: string): UserProfileUpdate {
+    return {
+      type: 'StringValue',
+      key: this.key,
+      value: value,
+      ifUndefined: false,
+    };
+  }
+
+  withValueIfUndefined(value: string): UserProfileUpdate {
+    return {
+      type: 'StringValue',
+      key: this.key,
+      value: value,
+      ifUndefined: true,
+    };
+  }
+
+  withValueReset(): UserProfileUpdate {
+    return {
+      type: 'StringValueReset',
+      key: this.key,
+    };
+  }
+}

package/src/utils.ts

@@ -0,0 +1,71 @@
+import type {
+  ECommerceCartItem,
+  ECommerceOrder,
+  ECommerceProduct,
+  ECommerceReferrer,
+  ECommerceScreen,
+} from './ecommerce';
+import type { AdRevenue } from './revenue';
+
+function convertMap(
+  map?: Map<string, string>
+): Record<string, string> | undefined {
+  return map !== undefined ? Object.fromEntries(map) : undefined;
+}
+
+export function normalizeECommerceOrder(order: ECommerceOrder): ECommerceOrder {
+  const newOrder = { ...order } as ECommerceOrder;
+  if (order.payload instanceof Map) {
+    newOrder.payload = convertMap(order.payload);
+  }
+  newOrder.products = order.products.map(normalizeECommerceCartItem)
+  return newOrder;
+}
+
+export function normalizeECommerceCartItem(
+  item: ECommerceCartItem
+): ECommerceCartItem {
+  const newItem = { ...item } as ECommerceCartItem;
+  newItem.product = normalizeECommerceProduct(item.product);
+  newItem.referrer = normalizeECommerceReferrer(item.referrer);
+  return newItem;
+}
+
+export function normalizeECommerceProduct(
+  product: ECommerceProduct
+): ECommerceProduct {
+  const newProduct = { ...product } as ECommerceProduct;
+  if (product.payload instanceof Map) {
+    newProduct.payload = convertMap(product.payload);
+  }
+  return newProduct;
+}
+
+export function normalizeECommerceReferrer(
+  referrer?: ECommerceReferrer
+): ECommerceReferrer | undefined {
+  if (referrer === undefined) {
+    return undefined;
+  }
+  const newReferrer = { ...referrer } as ECommerceReferrer;
+  if (referrer.screen != undefined) {
+    newReferrer.screen = normalizeECommerceScreen(referrer.screen);
+  }
+  return newReferrer;
+}
+
+export function normalizeECommerceScreen(screen: ECommerceScreen): ECommerceScreen {
+  const newScreen = { ...screen } as ECommerceScreen;
+  if (screen.payload instanceof Map) {
+    newScreen.payload = convertMap(screen.payload);
+  }
+  return newScreen;
+}
+
+export function normalizeAdRevenue(adRevenue: AdRevenue): AdRevenue {
+  const newAdRevenue = { ...adRevenue } as AdRevenue;
+  if (adRevenue.payload instanceof Map) {
+    newAdRevenue.payload = convertMap(adRevenue.payload);
+  }
+  return newAdRevenue;
+}