react-native-netmera 1.11.3 → 2.0.0-alpha02

package/src/events/commerce/NetmeraLineItem.ts

@@ -1,7 +1,7 @@
-import { NetmeraProduct } from "./NetmeraProduct";
+import { NetmeraProduct } from './NetmeraProduct';
 
 export class NetmeraLineItem extends NetmeraProduct {
-  private ec: number | undefined;
+  protected ec: number | undefined;
 
   setCount(count: number) {
     this.ec = count;

package/src/events/commerce/NetmeraProduct.ts

@@ -1,14 +1,14 @@
 export class NetmeraProduct {
-  private ea: string | undefined; // id
-  private eb: string | undefined; // name
-  private eq: number | undefined; // price
-  private ga: string[] | undefined; // categoryIds
-  private ef: string[] | undefined; // categoryNames
-  private eh: string | undefined; // brandName
-  private gd: string | undefined; // brandId
-  private ei: string | undefined; // variant
-  private eg: string[] | undefined; // keywords
-  private ge: string | undefined; // campaignId
+  protected ea: string | undefined; // id
+  protected eb: string | undefined; // name
+  protected eq: number | undefined; // price
+  protected ga: string[] | undefined; // categoryIds
+  protected ef: string[] | undefined; // categoryNames
+  protected eh: string | undefined; // brandName
+  protected gd: string | undefined; // brandId
+  protected ei: string | undefined; // variant
+  protected eg: string[] | undefined; // keywords
+  protected ge: string | undefined; // campaignId
 
   setId(value: string) {
     this.ea = value;

package/src/events/media/NetmeraEventContent.ts

@@ -1,4 +1,4 @@
-import NetmeraEvent from "./../NetmeraEvent";
+import NetmeraEvent from './../NetmeraEvent';
 
 export abstract class NetmeraEventContent extends NetmeraEvent {
   static readonly TYPE_OTHER = 0;
@@ -7,13 +7,13 @@ export abstract class NetmeraEventContent extends NetmeraEvent {
   static readonly TYPE_VIDEO = 3;
   static readonly TYPE_TEXT = 4;
 
-  private ea: string | undefined; // id
-  private eb: string | undefined; // name
-  private ed: number | undefined; // type
-  private ee: string | undefined; // provider
-  private ga: string[] | undefined; // categoryIds
-  private ef: string[] | undefined; // categoryNames
-  private eg: string[] | undefined; // keywords
+  protected ea: string | undefined; // id
+  protected eb: string | undefined; // name
+  protected ed: number | undefined; // type
+  protected ee: string | undefined; // provider
+  protected ga: string[] | undefined; // categoryIds
+  protected ef: string[] | undefined; // categoryNames
+  protected eg: string[] | undefined; // keywords
 
   setId(value: string): void {
     this.ea = value;

package/src/events/media/NetmeraEventContentComment.ts

@@ -1,5 +1,5 @@
-import { NetmeraEventContent } from "./NetmeraEventContent";
+import { NetmeraEventContent } from './NetmeraEventContent';
 
 export class NetmeraEventContentComment extends NetmeraEventContent {
-  code = "n:cc";
+  code = 'n:cc';
 }

package/src/events/media/NetmeraEventContentRate.ts

@@ -1,9 +1,9 @@
-import { NetmeraEventContent } from "./NetmeraEventContent";
+import { NetmeraEventContent } from './NetmeraEventContent';
 
 export class NetmeraEventContentRate extends NetmeraEventContent {
-  code: string = "n:rc";
+  code: string = 'n:rc';
 
-  private eo: number | undefined;
+  protected eo: number | undefined;
 
   setRating(value: number): void {
     this.eo = value;

package/src/events/media/NetmeraEventContentView.ts

@@ -1,5 +1,5 @@
-import { NetmeraEventContent } from "./NetmeraEventContent";
+import { NetmeraEventContent } from './NetmeraEventContent';
 
 export class NetmeraEventContentView extends NetmeraEventContent {
-  code = "n:vc";
+  code = 'n:vc';
 }

package/src/index.ts

@@ -0,0 +1,87 @@
+import Netmera from './Netmera';
+import NetmeraCouponObject from './models/NetmeraCouponObject';
+import NetmeraEvent from './events/NetmeraEvent';
+import NetmeraUser from './models/NetmeraUser';
+import { NetmeraUserProfile } from './models/NetmeraUserProfile';
+import {
+  NetmeraProfileAttribute,
+  NetmeraProfileAttributeCollection,
+  Gender,
+  MaritalStatus,
+} from './models/NetmeraProfileAttribute';
+import NetmeraCategory from './models/NetmeraCategory';
+import NetmeraCategoryFilter from './models/NetmeraCategoryFilter';
+import NetmeraPushInbox from './models/NetmeraInbox';
+import NetmeraInboxFilter from './models/NetmeraInboxFilter';
+import NMInboxStatusCountFilter from './models/NMInboxStatusCountFilter';
+import NMCategoryPreference from './models/NMCategoryPreference';
+import { NMInboxStatus } from './models/NMInboxStatus';
+import { NotificationPermissionStatus } from './models/NotificationPermissionStatus';
+import { NetmeraEventBannerOpen } from './events/NetmeraEventBannerOpen';
+import { NetmeraEventBatteryLevel } from './events/NetmeraEventBatteryLevel';
+import { NetmeraEventCategoryView } from './events/NetmeraEventCategoryView';
+import { NetmeraEventInAppPurchase } from './events/NetmeraEventInAppPurchase';
+import { NetmeraEventLogin } from './events/NetmeraEventLogin';
+import { NetmeraEventRegister } from './events/NetmeraEventRegister';
+import { NetmeraEventScreenView } from './events/NetmeraEventScreenView';
+import { NetmeraEventSearch } from './events/NetmeraEventSearch';
+import { NetmeraEventShare } from './events/NetmeraEventShare';
+import { NetmeraEventCartAddProduct } from './events/commerce/NetmeraEventCartAddProduct';
+import { NetmeraEventCartRemoveProduct } from './events/commerce/NetmeraEventCartRemoveProduct';
+import { NetmeraEventCartView } from './events/commerce/NetmeraEventCartView';
+import { NetmeraEventOrderCancel } from './events/commerce/NetmeraEventOrderCancel';
+import { NetmeraEventProductComment } from './events/commerce/NetmeraEventProductComment';
+import { NetmeraEventProductRate } from './events/commerce/NetmeraEventProductRate';
+import { NetmeraEventProductView } from './events/commerce/NetmeraEventProductView';
+import { NetmeraEventPurchase } from './events/commerce/NetmeraEventPurchase';
+import { NetmeraEventWishList } from './events/commerce/NetmeraEventWishList';
+import { NetmeraLineItem } from './events/commerce/NetmeraLineItem';
+import { NetmeraProduct } from './events/commerce/NetmeraProduct';
+import { NetmeraEventContentComment } from './events/media/NetmeraEventContentComment';
+import { NetmeraEventContentRate } from './events/media/NetmeraEventContentRate';
+import { NetmeraEventContentView } from './events/media/NetmeraEventContentView';
+
+export {
+  Netmera,
+  NetmeraCouponObject,
+  NetmeraUser,
+  NetmeraPushInbox,
+  NetmeraInboxFilter,
+  NMInboxStatus,
+  NMInboxStatusCountFilter,
+  NetmeraCategory,
+  NetmeraCategoryFilter,
+  NMCategoryPreference,
+  NotificationPermissionStatus,
+  NetmeraLineItem,
+  NetmeraProduct,
+  NetmeraUserProfile,
+  NetmeraProfileAttribute,
+  NetmeraProfileAttributeCollection,
+  Gender,
+  MaritalStatus,
+
+  // Events
+  NetmeraEvent,
+  NetmeraEventBannerOpen,
+  NetmeraEventBatteryLevel,
+  NetmeraEventCategoryView,
+  NetmeraEventInAppPurchase,
+  NetmeraEventLogin,
+  NetmeraEventRegister,
+  NetmeraEventScreenView,
+  NetmeraEventSearch,
+  NetmeraEventShare,
+  NetmeraEventCartAddProduct,
+  NetmeraEventCartRemoveProduct,
+  NetmeraEventCartView,
+  NetmeraEventOrderCancel,
+  NetmeraEventProductComment,
+  NetmeraEventProductRate,
+  NetmeraEventProductView,
+  NetmeraEventPurchase,
+  NetmeraEventWishList,
+  NetmeraEventContentComment,
+  NetmeraEventContentRate,
+  NetmeraEventContentView,
+};

package/src/models/NMCategoryPreference.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
 export default class NMCategoryPreference {

package/src/models/NMInboxStatusCountFilter.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
 export default class NMInboxStatusCountFilter {

package/src/models/NetmeraCategory.ts

@@ -1,8 +1,8 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
-import NetmeraPushInbox from "./NetmeraInbox";
+import NetmeraPushInbox from './NetmeraInbox';
 
 export default class NetmeraCategory {
   categoryName?: string;

package/src/models/NetmeraCategoryFilter.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
 export default class NetmeraCategoryFilter {

package/src/models/NetmeraCouponObject.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
 export default class NetmeraCouponObject {

package/src/models/NetmeraInbox.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
 export default class NetmeraPushInbox {

package/src/models/NetmeraInboxFilter.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
 export default class NetmeraInboxFilter {

package/src/models/NetmeraProfileAttribute.ts

@@ -0,0 +1,81 @@
+/*
+ * Copyright (c) 2026 Netmera Research.
+ */
+
+export enum NetmeraProfileOperation {
+  ADD = 'ADD',
+  REMOVE = 'REMOVE',
+  SET = 'SET',
+  UNSET = 'UNSET',
+}
+
+export type ProfileOperationPayload<T> = {
+  opr: NetmeraProfileOperation;
+  value?: T;
+};
+
+export enum Gender {
+  MALE = 0,
+  FEMALE = 1,
+  NOT_SPECIFIED = 2,
+}
+
+export enum MaritalStatus {
+  SINGLE = 0,
+  MARRIED = 1,
+  NOT_SPECIFIED = 2,
+}
+
+export class NetmeraProfileAttribute<T> {
+  protected operations: ProfileOperationPayload<T>[] = [];
+
+  public set(value: T): void {
+    if (!value) {
+      console.debug(
+        'ignore NetmeraProfileAttribute::set. value is null or undefined'
+      );
+      return;
+    }
+    this.operations = [{ opr: NetmeraProfileOperation.SET, value: value }];
+  }
+
+  public unset(): void {
+    this.operations = [{ opr: NetmeraProfileOperation.UNSET }];
+  }
+
+  public hasOperations(): boolean {
+    return this.operations.length > 0;
+  }
+
+  public getOperations(): ProfileOperationPayload<T>[] {
+    return this.operations;
+  }
+
+  public hasPendingChanges(): boolean {
+    return this.operations.length > 0;
+  }
+}
+
+export class NetmeraProfileAttributeCollection<
+  T,
+> extends NetmeraProfileAttribute<T[]> {
+  public add(value: T[]): void {
+    if (!value || value.length === 0) {
+      console.debug(
+        `ignore NetmeraProfileAttributeCollection.add(). value is ${value.length === 0 ? 'empty' : 'null or undefined'}`
+      );
+      return;
+    }
+    this.operations.push({ opr: NetmeraProfileOperation.ADD, value: value });
+  }
+
+  public remove(value: T[]): void {
+    if (!value || value.length === 0) {
+      console.debug(
+        `ignore NetmeraProfileAttributeCollection.remove(). value is ${value.length === 0 ? 'empty' : 'null or undefined'}`
+      );
+      return;
+    }
+    this.operations.push({ opr: NetmeraProfileOperation.REMOVE, value: value });
+  }
+}

package/src/models/NetmeraUser.ts

@@ -1,96 +1,98 @@
 /*
- * Copyright (c) 2023 Netmera Research.
+ * Copyright (c) 2026 Netmera Research.
  */
 
-export default class NetmeraUser {
-  private pa?: string;
-  private pb?: string;
-  private pc?: string[];
-  private pd?: number;
-  private pe?: number;
-  private pf?: number;
-  private pg?: number;
-  private ph?: string;
-  private pi?: string;
-  private pj?: string;
-  private pk?: string;
-  private pl?: string;
-  private pm?: string;
-  private pn?: string;
-  private po?: string;
-  userId?: string;
-  msisdn?: string;
-  email?: string;
-
-  set name(value: string) {
-    this.pa = value;
-  }
-
-  set surname(value: string) {
-    this.pb = value;
-  }
+import { Optional } from '../utils/Optional';
 
-  set externalSegments(value: string[]) {
-    this.pc = value;
-  }
-
-  set gender(value: number) {
-    this.pd = value;
-  }
-
-  set dateOfBirth(value: number) {
-    this.pe = value;
-  }
-
-  set maritalStatus(value: number) {
-    this.pf = value;
-  }
-
-  set childCount(value: number) {
-    this.pg = value;
+/**
+ * User payload for {@link Netmera.identifyUser}. Fields distinguish:
+ * - **unset** — property is not assigned,
+ * - **set to null** — assign `null` to clear the attribute on the server,
+ * - **set to string** — normal value.
+ */
+export default class NetmeraUser {
+  private _userId?: Optional<string>;
+  private _email?: Optional<string>;
+  private _msisdn?: Optional<string>;
+  private _wpNumber?: Optional<string>;
+
+  get userId(): string | null | undefined {
+    if (this._userId === undefined) {
+      return undefined;
+    }
+    return this._userId.valueOrNull;
   }
 
-  set country(value: string) {
-    this.ph = value;
+  set userId(value: string | null | undefined) {
+    if (value === undefined) {
+      this._userId = undefined;
+    } else {
+      this._userId = Optional.fromNullable(value);
+    }
   }
 
-  set state(value: string) {
-    this.pi = value;
+  get email(): string | null | undefined {
+    if (this._email === undefined) {
+      return undefined;
+    }
+    return this._email.valueOrNull;
   }
 
-  set city(value: string) {
-    this.pj = value;
+  set email(value: string | null | undefined) {
+    if (value === undefined) {
+      this._email = undefined;
+    } else {
+      this._email = Optional.fromNullable(value);
+    }
   }
 
-  set district(value: string) {
-    this.pk = value;
+  get msisdn(): string | null | undefined {
+    if (this._msisdn === undefined) {
+      return undefined;
+    }
+    return this._msisdn.valueOrNull;
   }
 
-  set occupation(value: string) {
-    this.pl = value;
+  set msisdn(value: string | null | undefined) {
+    if (value === undefined) {
+      this._msisdn = undefined;
+    } else {
+      this._msisdn = Optional.fromNullable(value);
+    }
   }
 
-  set industry(value: string) {
-    this.pm = value;
+  get wpNumber(): string | null | undefined {
+    if (this._wpNumber === undefined) {
+      return undefined;
+    }
+    return this._wpNumber.valueOrNull;
   }
 
-  set favoriteTeam(value: string) {
-    this.pn = value;
+  set wpNumber(value: string | null | undefined) {
+    if (value === undefined) {
+      this._wpNumber = undefined;
+    } else {
+      this._wpNumber = Optional.fromNullable(value);
+    }
   }
 
-  set language(value: string) {
-    this.po = value;
+  /**
+   * Only keys that were explicitly set; values may be `null` so can clear them server-side.
+   */
+  getIdentifyPayload(): Record<string, string | null> {
+    const payload: Record<string, string | null> = {};
+    if (this._userId !== undefined) {
+      payload.userId = this._userId.valueOrNull;
+    }
+    if (this._email !== undefined) {
+      payload.email = this._email.valueOrNull;
+    }
+    if (this._msisdn !== undefined) {
+      payload.msisdn = this._msisdn.valueOrNull;
+    }
+    if (this._wpNumber !== undefined) {
+      payload.wpNumber = this._wpNumber.valueOrNull;
+    }
+    return payload;
   }
 }
-
-export enum NMUserGender {
-  MALE = 0,
-  FEMALE = 1,
-  NOT_SPECIFIED = 2,
-}
-
-export enum NMUserMaritalStatus {
-  SINGLE = 0,
-  MARRIED = 1,
-  NOT_SPECIFIED = 2,
-}

package/src/models/NetmeraUserProfile.ts

@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2026 Netmera Research.
+ */
+
+import {
+  NetmeraProfileAttribute,
+  NetmeraProfileAttributeCollection,
+  Gender,
+  MaritalStatus,
+} from './NetmeraProfileAttribute';
+
+export class NetmeraUserProfile {
+  public name = new NetmeraProfileAttribute<string>();
+  public surname = new NetmeraProfileAttribute<string>();
+  public externalSegments = new NetmeraProfileAttributeCollection<string>();
+  public gender = new NetmeraProfileAttribute<Gender>();
+  public dateOfBirth = new NetmeraProfileAttribute<number>();
+  public maritalStatus = new NetmeraProfileAttribute<MaritalStatus>();
+  public childCount = new NetmeraProfileAttribute<number>();
+  public country = new NetmeraProfileAttribute<string>();
+  public state = new NetmeraProfileAttribute<string>();
+  public city = new NetmeraProfileAttribute<string>();
+  public district = new NetmeraProfileAttribute<string>();
+  public occupation = new NetmeraProfileAttribute<string>();
+  public industry = new NetmeraProfileAttribute<string>();
+  public favoriteTeam = new NetmeraProfileAttribute<string>();
+  public language = new NetmeraProfileAttribute<string>();
+
+  protected getSerializationMap(): Record<string, string> {
+    return {
+      name: 'pa',
+      surname: 'pb',
+      externalSegments: 'pc',
+      gender: 'pd',
+      dateOfBirth: 'pe',
+      maritalStatus: 'pf',
+      childCount: 'pg',
+      country: 'ph',
+      state: 'pi',
+      city: 'pj',
+      district: 'pk',
+      occupation: 'pl',
+      industry: 'pm',
+      favoriteTeam: 'pn',
+      language: 'po',
+    };
+  }
+
+  public getChangesPayload(): Record<string, any> {
+    const payload: Record<string, any> = {};
+    const serializationMap = this.getSerializationMap();
+
+    for (const propertyName in serializationMap) {
+      const attribute = (this as any)[
+        propertyName
+      ] as NetmeraProfileAttribute<any>;
+      if (attribute && attribute.hasPendingChanges()) {
+        const serializedKey = serializationMap[propertyName];
+        if (serializedKey && attribute.hasOperations()) {
+          payload[serializedKey] = attribute.getOperations();
+        }
+      }
+    }
+
+    return payload;
+  }
+}

package/src/models/NotificationPermissionStatus.ts

@@ -1,6 +1,6 @@
 export enum NotificationPermissionStatus {
-  NotDetermined = "notDetermined",
-  Blocked = "blocked",
-  Denied = "denied",
-  Granted = "granted",
+  NotDetermined = 'notDetermined',
+  Blocked = 'blocked',
+  Denied = 'denied',
+  Granted = 'granted',
 }

package/src/utils/DeviceUtils.ts

@@ -1,9 +1,9 @@
-import { Platform } from "react-native";
+import { Platform } from 'react-native';
 
 export const isAndroid = () => {
-  return Platform.OS === "android";
+  return Platform.OS === 'android';
 };
 
 export const isIos = () => {
-  return Platform.OS === "ios";
+  return Platform.OS === 'ios';
 };

package/src/utils/Optional.ts

@@ -0,0 +1,31 @@
+/*
+ * Copyright (c) 2026 Netmera Research.
+ */
+
+/**
+ * Distinguishes a field that was never set from one explicitly cleared.
+ */
+export class Optional<T> {
+  private constructor(
+    private readonly _isPresent: boolean,
+    private readonly _value: T | undefined
+  ) {}
+
+  static of<T>(value: T): Optional<T> {
+    return new Optional(true, value);
+  }
+
+  /** Explicit null / clear on server when serialized as a map value. */
+  static absent<T>(): Optional<T> {
+    return new Optional<T>(false, undefined as T | undefined);
+  }
+
+  /** `null` or `undefined` → {@link Optional.absent}; otherwise {@link Optional.of}. */
+  static fromNullable<T>(value: T | null | undefined): Optional<T> {
+    return value == null ? Optional.absent<T>() : Optional.of(value);
+  }
+
+  get valueOrNull(): T | null {
+    return this._isPresent ? (this._value as T) : null;
+  }
+}

package/src/utils/RNNetmera.ts

@@ -0,0 +1,24 @@
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
+
+const LINKING_ERROR =
+  `The package 'netmera-react-sdk' doesn't seem to be linked. Make sure: \n\n` +
+  Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
+  '- You rebuilt the app after installing the package\n' +
+  '- You are not using Expo Go\n';
+
+const RNNetmera = NativeModules.RNNetmera
+  ? NativeModules.RNNetmera
+  : new Proxy(
+      {},
+      {
+        get() {
+          throw new Error(LINKING_ERROR);
+        },
+      }
+    );
+
+const RNNetmeraRCTEventEmitter = NativeModules.RNNetmeraRCTEventEmitter;
+
+const netmeraRCTEventEmitter = new NativeEventEmitter(RNNetmeraRCTEventEmitter);
+
+export { RNNetmera, netmeraRCTEventEmitter };

package/.eslintignore

@@ -1,7 +0,0 @@
-/example/.eslintrc.js
-/example/__tests__/App-test.js
-/example/babel.config.js
-/example/index.js
-/example/jest.config.js
-/example/metro.config.js
-/scripts

package/.gitattributes

@@ -1 +0,0 @@
-*.pbxproj -text