@clix-so/react-native-sdk 0.0.1 → 0.0.2-beta.2

package/lib/typescript/src/core/Clix.d.ts

@@ -4,13 +4,16 @@ import { NotificationService } from '../services/NotificationService';
 import { StorageService } from '../services/StorageService';
 import { ClixLogLevel } from '../utils/logging/ClixLogger';
 import type { ClixConfig } from './ClixConfig';
+import { ClixInitCoordinator } from './ClixInitCoordinator';
+import { ClixNotification } from './ClixNotification';
 export declare class Clix {
-    private static shared?;
-    private static initCoordinator;
-    protected storageService?: StorageService;
-    protected eventService?: EventService;
-    protected deviceService?: DeviceService;
-    protected notificationService?: NotificationService;
+    static shared?: Clix;
+    static initCoordinator: ClixInitCoordinator;
+    static Notification: ClixNotification;
+    storageService?: StorageService;
+    eventService?: EventService;
+    deviceService?: DeviceService;
+    notificationService?: NotificationService;
     private constructor();
     /**
      * Initialize Clix SDK
@@ -45,7 +48,7 @@ export declare class Clix {
      */
     static getDeviceId(): Promise<string | undefined>;
     /**
-     * Get push token
+     * @deprecated Use Clix.Notification.getToken() instead.
      */
     static getPushToken(): Promise<string | undefined>;
     /**
@@ -55,10 +58,7 @@ export declare class Clix {
     /**
      * Track event
      */
-    protected static trackEvent(name: string, options?: {
-        properties?: Record<string, any>;
-        messageId?: string;
-    }): Promise<void>;
+    static trackEvent(name: string, properties?: Record<string, any>): Promise<void>;
     /**
      * Set configuration
      */

package/lib/typescript/src/core/Clix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Clix.d.ts","sourceRoot":"","sources":["../../../../src/core/Clix.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAc,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAO;IAC7B,OAAO,CAAC,MAAM,CAAC,eAAe,CAA6B;IAE3D,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACtC,SAAS,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACxC,SAAS,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAEpD,OAAO;IAEP;;OAEG;WACU,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1D;;OAEG;WACU,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;OAEG;WACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1C;;OAEG;WACU,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAapE;;OAEG;WACU,iBAAiB,CAC5B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;WACU,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3D;;OAEG;WACU,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhE;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAcvD;;OAEG;WACU,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAcxD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAI7C;;OAEG;qBACoB,UAAU,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,IAAI,CAAC;IAehB;;OAEG;YACW,SAAS;CAkDxB"}
+{"version":3,"file":"Clix.d.ts","sourceRoot":"","sources":["../../../../src/core/Clix.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAc,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qBAAa,IAAI;IACf,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IACrB,MAAM,CAAC,eAAe,sBAA6B;IAEnD,MAAM,CAAC,YAAY,mBAA2B;IAE9C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,OAAO;IAEP;;OAEG;WACU,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1D;;OAEG;WACU,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;OAEG;WACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1C;;OAEG;WACU,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAapE;;OAEG;WACU,iBAAiB,CAC5B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;WACU,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3D;;OAEG;WACU,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhE;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAcvD;;OAEG;WACU,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAcxD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAI7C;;OAEG;WACU,UAAU,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACnC,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;YACW,SAAS;CAkDxB"}

package/lib/typescript/src/core/ClixNotification.d.ts

@@ -0,0 +1,25 @@
+import { type NotificationSettings } from '@notifee/react-native';
+import type { BackgroundMessageHandler, FcmTokenErrorHandler, ForegroundMessageHandler, NotificationOpenedHandler } from '../services/NotificationService';
+interface ConfigureOptions {
+    /**
+     * @default false
+     */
+    autoRequestPermission?: boolean;
+    /**
+     * @default true
+     */
+    autoHandleLandingURL?: boolean;
+}
+export declare class ClixNotification {
+    static shared: ClixNotification;
+    configure(options?: ConfigureOptions): Promise<void>;
+    requestPermission(): Promise<NotificationSettings | null>;
+    setPermissionGranted(isGranted: boolean): Promise<void>;
+    getToken(): Promise<string | undefined>;
+    onMessage(handler?: ForegroundMessageHandler): Promise<void>;
+    onBackgroundMessage(handler?: BackgroundMessageHandler): Promise<void>;
+    onNotificationOpened(handler?: NotificationOpenedHandler): Promise<void>;
+    onFcmTokenError(handler?: FcmTokenErrorHandler): Promise<void>;
+}
+export {};
+//# sourceMappingURL=ClixNotification.d.ts.map

package/lib/typescript/src/core/ClixNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClixNotification.d.ts","sourceRoot":"","sources":["../../../../src/core/ClixNotification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,iCAAiC,CAAC;AAIzC,UAAU,gBAAgB;IACxB;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAA0B;IAEnD,SAAS,CAAC,OAAO,GAAE,gBAAqB;IAsBxC,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAgBzD,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvD,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiBvC,SAAS,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D,mBAAmB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IActE,oBAAoB,CACxB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,IAAI,CAAC;IAgBV,eAAe,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAarE"}

package/lib/typescript/src/services/DeviceService.d.ts

@@ -8,13 +8,14 @@ export declare class DeviceService {
     private readonly deviceAPIService;
     private static readonly DEVICE_ID_KEY;
     constructor(storageService: StorageService, tokenService: TokenService, deviceAPIService: DeviceAPIService);
-    getCurrentDeviceId(): Promise<string>;
+    getCurrentDeviceId(): string;
     setProjectUserId(projectUserId: string): Promise<void>;
     removeProjectUserId(): Promise<void>;
     updateUserProperties(properties: Record<string, any>): Promise<void>;
     removeUserProperties(names: string[]): Promise<void>;
     upsertToken(token: string, tokenType?: string): Promise<void>;
+    upsertIsPushPermissionGranted(isGranted: boolean): Promise<void>;
     private getPushPermissionStatus;
-    createDevice(deviceId: string, token?: string): Promise<ClixDevice>;
+    createDevice(deviceId: string, token?: string, isPushPermissionGranted?: boolean): Promise<ClixDevice>;
 }
 //# sourceMappingURL=DeviceService.d.ts.map

package/lib/typescript/src/services/DeviceService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeviceService.d.ts","sourceRoot":"","sources":["../../../../src/services/DeviceService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IALnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAoB;gBAGtC,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,gBAAgB;IAG/C,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAarC,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActD,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcpC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpE,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAepD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAgC5D,uBAAuB;IA6B/B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAwC1E"}
+{"version":3,"file":"DeviceService.d.ts","sourceRoot":"","sources":["../../../../src/services/DeviceService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IALnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAoB;gBAGtC,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,gBAAgB;IAGrD,kBAAkB,IAAI,MAAM;IAatB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActD,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcpC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpE,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAepD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCpE,6BAA6B,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAmBxD,uBAAuB;IAoB/B,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,uBAAuB,CAAC,EAAE,OAAO,GAChC,OAAO,CAAC,UAAU,CAAC;CAyCvB"}

package/lib/typescript/src/services/EventAPIService.d.ts

@@ -2,6 +2,6 @@ import { ClixAPIClient } from './ClixAPIClient';
 export declare class EventAPIService {
     private readonly apiClient;
     constructor(apiClient: ClixAPIClient);
-    trackEvent(deviceId: string, name: string, properties: Record<string, any>, messageId?: string): Promise<void>;
+    trackEvent(deviceId: string, name: string, properties: Record<string, any>, messageId?: string, userJourneyId?: string, userJourneyNodeId?: string): Promise<void>;
 }
 //# sourceMappingURL=EventAPIService.d.ts.map

package/lib/typescript/src/services/EventAPIService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventAPIService.d.ts","sourceRoot":"","sources":["../../../../src/services/EventAPIService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE/C,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;CAoCjB"}
+{"version":3,"file":"EventAPIService.d.ts","sourceRoot":"","sources":["../../../../src/services/EventAPIService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE/C,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC;CAsCjB"}

package/lib/typescript/src/services/EventService.d.ts

@@ -4,6 +4,6 @@ export declare class EventService {
     private readonly eventAPIService;
     private readonly deviceService;
     constructor(eventAPIService: EventAPIService, deviceService: DeviceService);
-    trackEvent(name: string, properties?: Record<string, any>, messageId?: string): Promise<void>;
+    trackEvent(name: string, properties?: Record<string, any>, messageId?: string, userJourneyId?: string, userJourneyNodeId?: string): Promise<void>;
 }
 //# sourceMappingURL=EventService.d.ts.map

package/lib/typescript/src/services/EventService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventService.d.ts","sourceRoot":"","sources":["../../../../src/services/EventService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa;IAGzC,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;CA8BjB"}
+{"version":3,"file":"EventService.d.ts","sourceRoot":"","sources":["../../../../src/services/EventService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa;IAGzC,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC;CAmCjB"}

package/lib/typescript/src/services/NotificationService.d.ts

@@ -1,7 +1,13 @@
+import { type NotificationSettings } from '@notifee/react-native';
 import { DeviceService } from './DeviceService';
 import { EventService } from './EventService';
 import { StorageService } from './StorageService';
 import { TokenService } from './TokenService';
+type NotificationData = Record<string, any>;
+export type ForegroundMessageHandler = (data: NotificationData) => Promise<boolean> | boolean;
+export type BackgroundMessageHandler = (data: NotificationData) => Promise<void> | void;
+export type NotificationOpenedHandler = (data: NotificationData) => Promise<void> | void;
+export type FcmTokenErrorHandler = (error: Error) => Promise<void> | void;
 export declare class NotificationService {
     private static instance;
     private static readonly DEFAULT_CHANNEL;
@@ -13,6 +19,11 @@ export declare class NotificationService {
     private storageService;
     private deviceService?;
     private tokenService?;
+    private autoHandleLandingUrl;
+    private messageHandler?;
+    private backgroundMessageHandler?;
+    private openedHandler?;
+    private fcmTokenErrorHandler?;
     private unsubscribeForegroundMessage?;
     private unsubscribeNotificationOpened?;
     private unsubscribeTokenRefresh?;
@@ -23,6 +34,11 @@ export declare class NotificationService {
     initialize(eventService: EventService, storageService: StorageService, deviceService?: DeviceService, tokenService?: TokenService): Promise<NotificationService>;
     getCurrentToken(): Promise<string | null>;
     cleanup(): void;
+    setMessageHandler(handler?: ForegroundMessageHandler): void;
+    setBackgroundMessageHandler(handler?: BackgroundMessageHandler): void;
+    setNotificationOpenedHandler(handler?: NotificationOpenedHandler): void;
+    setFcmTokenErrorHandler(handler?: FcmTokenErrorHandler): void;
+    setAutoHandleLandingUrl(enable: boolean): void;
     private initializeNotificationDisplayService;
     private createNotificationChannels;
     private setupNotificationEventListeners;
@@ -32,7 +48,8 @@ export declare class NotificationService {
     private setupMessageHandlers;
     private handleBackgroundMessage;
     private handleForegroundMessage;
-    private requestMessagePermission;
+    requestPermission(): Promise<NotificationSettings>;
+    setPermissionGranted(isGranted: boolean): Promise<void>;
     private setupTokenRefreshListener;
     private checkInitialNotification;
     private getAndUpdateToken;
@@ -52,5 +69,8 @@ export declare class NotificationService {
     private trackPushEvent;
     private extractTrackingProperties;
     private trackEventInBackground;
+    private shouldDisplayForegroundNotification;
+    private handleFcmTokenError;
 }
+export {};
 //# sourceMappingURL=NotificationService.d.ts.map

package/lib/typescript/src/services/NotificationService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationService.d.ts","sourceRoot":"","sources":["../../../../src/services/NotificationService.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ9C,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoC;IAE3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAQrC;IAEF,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,OAAO,CAAC,4BAA4B,CAAC,CAAa;IAClD,OAAO,CAAC,6BAA6B,CAAC,CAAa;IACnD,OAAO,CAAC,uBAAuB,CAAC,CAAa;IAC7C,OAAO,CAAC,6BAA6B,CAAC,CAAa;IAEnD,OAAO;WAEO,WAAW,IAAI,mBAAmB;WAOlC,aAAa,IAAI,IAAI;IAO7B,UAAU,CACd,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,aAAa,CAAC,EAAE,aAAa,EAC7B,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IA4BzB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU/C,OAAO,IAAI,IAAI;YAUD,oCAAoC;YAgBpC,0BAA0B;IASxC,OAAO,CAAC,+BAA+B;YAQzB,uBAAuB;YAyBvB,iBAAiB;YAUjB,wBAAwB;IAWtC,OAAO,CAAC,oBAAoB;YAoBd,uBAAuB;YA6BvB,uBAAuB;YAgCvB,wBAAwB;IAkBtC,OAAO,CAAC,yBAAyB;YAcnB,wBAAwB;YAgBxB,iBAAiB;YAWjB,eAAe;YAaf,oBAAoB;YAQpB,uBAAuB;YAOvB,mBAAmB;YA2CnB,wBAAwB;IA4DtC,OAAO,CAAC,yBAAyB;IA6BjC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,0BAA0B;YAwCpB,kBAAkB;YAYlB,gBAAgB;YAahB,qBAAqB;YAUrB,mBAAmB;IA8BjC,OAAO,CAAC,gBAAgB;YA8CV,cAAc;IAU5B,OAAO,CAAC,yBAAyB;YAUnB,sBAAsB;CAiDrC"}
+{"version":3,"file":"NotificationService.d.ts","sourceRoot":"","sources":["../../../../src/services/NotificationService.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/services/StorageService.d.ts

@@ -1,10 +1,15 @@
 export declare class StorageService {
     private storage;
-    constructor();
-    set<T>(key: string, value: T): Promise<void>;
-    get<T>(key: string): Promise<T | undefined>;
-    remove(key: string): Promise<void>;
-    clear(): Promise<void>;
-    getAllKeys(): Promise<string[]>;
+    constructor(projectId: string);
+    private initializeCompat;
+    /**
+     * Delete a key from storage (works with both v2/v3 and v4 APIs)
+     */
+    private removeCompat;
+    set<T>(key: string, value: T): void;
+    get<T>(key: string): T | undefined;
+    remove(key: string): void;
+    clear(): void;
+    getAllKeys(): string[];
 }
 //# sourceMappingURL=StorageService.d.ts.map

package/lib/typescript/src/services/StorageService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../../src/services/StorageService.ts"],"names":[],"mappings":"AAGA,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAO;;IAShB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAsB3C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAStC"}
+{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../../src/services/StorageService.ts"],"names":[],"mappings":"AAaA,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAe;gBAElB,SAAS,EAAE,MAAM;IAI7B,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAoBnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAuBlC,MAAM,CAAC,GAAG,EAAE,MAAM;IAUlB,KAAK;IASL,UAAU;CASX"}

package/lib/typescript/src/services/TokenService.d.ts

@@ -5,11 +5,11 @@ export declare class TokenService {
     private static readonly PREVIOUS_TOKENS_KEY;
     private static readonly MAX_TOKENS;
     constructor(storageService: StorageService);
-    getCurrentToken(): Promise<string | undefined>;
-    getPreviousTokens(): Promise<string[]>;
-    saveToken(token: string): Promise<void>;
-    clearTokens(): Promise<void>;
+    getCurrentToken(): string | undefined;
+    getPreviousTokens(): string[];
+    saveToken(token: string): void;
+    clearTokens(): void;
     convertTokenToString(deviceToken: number[]): string;
-    reset(): Promise<void>;
+    reset(): void;
 }
 //# sourceMappingURL=TokenService.d.ts.map

package/lib/typescript/src/services/TokenService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenService.d.ts","sourceRoot":"","sources":["../../../../src/services/TokenService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,cAAc;IAJ3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAK;gBAEV,cAAc,EAAE,cAAc;IAErD,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAW9C,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IActC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BvC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAWlC,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM;IAM7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"TokenService.d.ts","sourceRoot":"","sources":["../../../../src/services/TokenService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,cAAc;IAJ3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAK;gBAEV,cAAc,EAAE,cAAc;IAE3D,eAAe,IAAI,MAAM,GAAG,SAAS;IASrC,iBAAiB,IAAI,MAAM,EAAE;IAc7B,SAAS,CAAC,KAAK,EAAE,MAAM;IA4BvB,WAAW;IAWX,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM;IAMnD,KAAK;CAGN"}

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

@@ -0,0 +1,4 @@
+export declare class ClixDateFormatter {
+    static format(date: Date): string;
+}
+//# sourceMappingURL=ClixDateFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClixDateFormatter.d.ts","sourceRoot":"","sources":["../../../../src/utils/ClixDateFormatter.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;CAiBlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clix-so/react-native-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2-beta.2",
   "description": "Clix - Mobile push for builders",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -81,7 +81,7 @@
     "react-native-builder-bob": "0.40.12",
     "react-native-device-info": "13.2.0",
     "react-native-get-random-values": "1.11.0",
-    "react-native-mmkv": "2.12.2",
+    "react-native-mmkv": "4.0.1",
     "release-it": "17.10.0",
     "typescript": "5.8.3",
     "uuid": "11.1.0"

package/src/core/Clix.ts

@@ -10,15 +10,18 @@ import { ClixError } from '../utils/ClixError';
 import { ClixLogger, ClixLogLevel } from '../utils/logging/ClixLogger';
 import type { ClixConfig } from './ClixConfig';
 import { ClixInitCoordinator } from './ClixInitCoordinator';
+import { ClixNotification } from './ClixNotification';
 
 export class Clix {
-  private static shared?: Clix;
-  private static initCoordinator = new ClixInitCoordinator();
+  static shared?: Clix;
+  static initCoordinator = new ClixInitCoordinator();
 
-  protected storageService?: StorageService;
-  protected eventService?: EventService;
-  protected deviceService?: DeviceService;
-  protected notificationService?: NotificationService;
+  static Notification = ClixNotification.shared;
+
+  storageService?: StorageService;
+  eventService?: EventService;
+  deviceService?: DeviceService;
+  notificationService?: NotificationService;
 
   private constructor() {}
 
@@ -153,7 +156,7 @@ export class Clix {
   }
 
   /**
-   * Get push token
+   * @deprecated Use Clix.Notification.getToken() instead.
    */
   static async getPushToken(): Promise<string | undefined> {
     try {
@@ -179,21 +182,14 @@ export class Clix {
   /**
    * Track event
    */
-  protected static async trackEvent(
+  static async trackEvent(
     name: string,
-    options?: {
-      properties?: Record<string, any>;
-      messageId?: string;
-    }
+    properties: Record<string, any> = {}
   ): Promise<void> {
     try {
       await Clix.initCoordinator.waitForInitialization();
       if (this.shared?.eventService) {
-        await this.shared.eventService.trackEvent(
-          name,
-          options?.properties,
-          options?.messageId
-        );
+        await this.shared.eventService.trackEvent(name, properties);
       }
     } catch (error) {
       ClixLogger.error(`Failed to track event: ${error}`);
@@ -204,12 +200,12 @@ export class Clix {
    * Set configuration
    */
   private async setConfig(config: ClixConfig): Promise<void> {
-    this.storageService = new StorageService();
+    this.storageService = new StorageService(config.projectId);
 
     try {
-      await this.storageService.set('project_id', config.projectId);
-      await this.storageService.set('api_key', config.apiKey);
-      await this.storageService.set('clix_config', {
+      this.storageService.set('project_id', config.projectId);
+      this.storageService.set('api_key', config.apiKey);
+      this.storageService.set('clix_config', {
         projectId: config.projectId,
         apiKey: config.apiKey,
         endpoint: config.endpoint,

package/src/core/ClixNotification.ts

@@ -0,0 +1,157 @@
+import { type NotificationSettings } from '@notifee/react-native';
+import type {
+  BackgroundMessageHandler,
+  FcmTokenErrorHandler,
+  ForegroundMessageHandler,
+  NotificationOpenedHandler,
+} from '../services/NotificationService';
+import { ClixLogger } from '../utils/logging/ClixLogger';
+import { Clix } from './Clix';
+
+interface ConfigureOptions {
+  /**
+   * @default false
+   */
+  autoRequestPermission?: boolean;
+  /**
+   * @default true
+   */
+  autoHandleLandingURL?: boolean;
+}
+
+export class ClixNotification {
+  static shared: ClixNotification = new ClixNotification();
+
+  async configure(options: ConfigureOptions = {}) {
+    const { autoRequestPermission = false, autoHandleLandingURL = true } =
+      options;
+
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return;
+      }
+
+      notificationService.setAutoHandleLandingUrl(autoHandleLandingURL);
+
+      if (autoRequestPermission) {
+        await notificationService.requestPermission();
+      }
+    } catch (error) {
+      ClixLogger.error('Failed to configure notifications', error);
+    }
+  }
+
+  async requestPermission(): Promise<NotificationSettings | null> {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return null;
+      }
+
+      return await notificationService.requestPermission();
+    } catch (error) {
+      ClixLogger.error('Failed to request notification permission', error);
+      return null;
+    }
+  }
+
+  async setPermissionGranted(isGranted: boolean): Promise<void> {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return;
+      }
+
+      await notificationService.setPermissionGranted(isGranted);
+    } catch (error) {
+      ClixLogger.error(
+        'Failed to update push permission status on server',
+        error
+      );
+    }
+  }
+
+  async getToken(): Promise<string | undefined> {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return undefined;
+      }
+
+      const token = await notificationService.getCurrentToken();
+      return token ?? undefined;
+    } catch (error) {
+      ClixLogger.error('Failed to get push token', error);
+      return undefined;
+    }
+  }
+
+  async onMessage(handler?: ForegroundMessageHandler): Promise<void> {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return;
+      }
+      notificationService.setMessageHandler(handler);
+    } catch (error) {
+      ClixLogger.error('Failed to register onMessage handler', error);
+    }
+  }
+
+  async onBackgroundMessage(handler?: BackgroundMessageHandler): Promise<void> {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return;
+      }
+      notificationService.setBackgroundMessageHandler(handler);
+    } catch (error) {
+      ClixLogger.error('Failed to register onBackgroundMessage handler', error);
+    }
+  }
+
+  async onNotificationOpened(
+    handler?: NotificationOpenedHandler
+  ): Promise<void> {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return;
+      }
+      notificationService.setNotificationOpenedHandler(handler);
+    } catch (error) {
+      ClixLogger.error(
+        'Failed to register onNotificationOpened handler',
+        error
+      );
+    }
+  }
+  async onFcmTokenError(handler?: FcmTokenErrorHandler): Promise<void> {
+    try {
+      await Clix.initCoordinator.waitForInitialization();
+      const notificationService = Clix.shared?.notificationService;
+      if (!notificationService) {
+        ClixLogger.warn('Notification service is not initialized');
+        return;
+      }
+      notificationService.setFcmTokenErrorHandler(handler);
+    } catch (error) {
+      ClixLogger.error('Failed to register onFcmTokenError handler', error);
+    }
+  }
+}