@loyalytics/swan-react-native-sdk 2.0.1

package/lib/typescript/module/src/providers/FirebasePushProvider.d.ts

@@ -0,0 +1,28 @@
+import { type PushNotificationProvider, type PushEventCallback } from './PushNotificationProvider';
+/**
+ * FirebasePushProvider
+ *
+ * Adapter that wraps FirebaseNotificationManager to implement
+ * the PushNotificationProvider interface.
+ *
+ * This provides a clean abstraction layer between the SDK and Firebase,
+ * making it easier to swap providers in the future.
+ */
+export declare class FirebasePushProvider implements PushNotificationProvider {
+    private firebaseManager;
+    private eventMappings;
+    constructor();
+    initialize(): Promise<boolean>;
+    getToken(): Promise<string | null>;
+    requestPermission(): Promise<boolean>;
+    hasPermission(): Promise<boolean>;
+    addEventListener(eventName: string, callback: PushEventCallback): void;
+    removeEventListener(eventName: string, callback: PushEventCallback): void;
+    deleteToken(): Promise<boolean>;
+    cleanup(): void;
+    getBadgeCount(): Promise<number>;
+    setBadgeCount(count: number): Promise<boolean>;
+    createNotificationChannel(channelId: string, channelName: string, importance?: number, description?: string): Promise<string | null>;
+    deleteNotificationChannel(channelId: string): Promise<boolean>;
+}
+//# sourceMappingURL=FirebasePushProvider.d.ts.map

package/lib/typescript/module/src/providers/FirebasePushProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirebasePushProvider.d.ts","sourceRoot":"","sources":["../../../../../src/providers/FirebasePushProvider.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,wBAAwB,EAE7B,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,wBAAwB;IACnE,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,aAAa,CAAsB;;IA8BrC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAmB9B,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUlC,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAarC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAUvC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAMtE,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAMnE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAUrC,OAAO,IAAI,IAAI;IAIT,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAUhC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU9C,yBAAyB,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAU,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkBnB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAarE"}

package/lib/typescript/module/src/providers/NullPushProvider.d.ts

@@ -0,0 +1,25 @@
+import { type PushNotificationProvider, type PushEventCallback } from './PushNotificationProvider';
+/**
+ * NullPushProvider
+ *
+ * No-op implementation of PushNotificationProvider.
+ * Used when push notifications are disabled in SDK config.
+ *
+ * This allows the rest of the SDK to work normally without
+ * needing to check "if (pushProvider)" everywhere.
+ */
+export declare class NullPushProvider implements PushNotificationProvider {
+    initialize(): Promise<boolean>;
+    getToken(): Promise<string | null>;
+    requestPermission(): Promise<boolean>;
+    hasPermission(): Promise<boolean>;
+    addEventListener(_eventName: string, _callback: PushEventCallback): void;
+    removeEventListener(_eventName: string, _callback: PushEventCallback): void;
+    deleteToken(): Promise<boolean>;
+    cleanup(): void;
+    getBadgeCount(): Promise<number>;
+    setBadgeCount(_count: number): Promise<boolean>;
+    createNotificationChannel(_channelId: string, _channelName: string, _importance?: number, _description?: string): Promise<string | null>;
+    deleteNotificationChannel(_channelId: string): Promise<boolean>;
+}
+//# sourceMappingURL=NullPushProvider.d.ts.map

package/lib/typescript/module/src/providers/NullPushProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NullPushProvider.d.ts","sourceRoot":"","sources":["../../../../../src/providers/NullPushProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEnG;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,wBAAwB;IACzD,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAK9B,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIlC,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKrC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIvC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAIxE,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAIrE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC,OAAO,IAAI,IAAI;IAIT,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAIhC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,yBAAyB,CAC7B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAInB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGtE"}

package/lib/typescript/module/src/providers/PushNotificationProvider.d.ts

@@ -0,0 +1,105 @@
+/**
+ * PushNotificationProvider Interface
+ *
+ * Abstract interface for push notification providers (Firebase, OneSignal, custom, etc.)
+ * This allows the SDK to work with different push providers without tight coupling.
+ */
+export interface RemoteMessage {
+    messageId?: string;
+    notification?: {
+        title?: string;
+        body?: string;
+        android?: {
+            channelId?: string;
+            imageUrl?: string;
+            [key: string]: any;
+        };
+        ios?: {
+            [key: string]: any;
+        };
+        [key: string]: any;
+    };
+    data?: {
+        [key: string]: any;
+    };
+    sentTime?: number;
+    from?: string;
+    [key: string]: any;
+}
+export interface PushNotificationEvents {
+    TOKEN_RECEIVED: string;
+    TOKEN_REFRESH: string;
+    NOTIFICATION_RECEIVED: string;
+    NOTIFICATION_OPENED: string;
+    PERMISSION_CHANGED: string;
+}
+export type PushEventCallback = (data: any) => void;
+/**
+ * Push Notification Provider Interface
+ *
+ * Providers must implement all methods to be compatible with the SDK.
+ */
+export interface PushNotificationProvider {
+    /**
+     * Initialize the push provider
+     * @returns true if initialization successful, false otherwise
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * Get the current push token
+     * @returns push token string or null if not available
+     */
+    getToken(): Promise<string | null>;
+    /**
+     * Request push notification permission from user
+     * @returns true if permission granted, false otherwise
+     */
+    requestPermission(): Promise<boolean>;
+    /**
+     * Check if push notification permission is granted
+     * @returns true if permission granted, false otherwise
+     */
+    hasPermission(): Promise<boolean>;
+    /**
+     * Add event listener for push notifications
+     * @param eventName - Event name to listen for
+     * @param callback - Callback function
+     */
+    addEventListener(eventName: string, callback: PushEventCallback): void;
+    /**
+     * Remove event listener
+     * @param eventName - Event name
+     * @param callback - Callback function to remove
+     */
+    removeEventListener(eventName: string, callback: PushEventCallback): void;
+    /**
+     * Delete push token (optional - used when user revokes permission)
+     * @returns true if deletion successful
+     */
+    deleteToken?(): Promise<boolean>;
+    /**
+     * Cleanup resources when provider is destroyed
+     */
+    cleanup?(): void;
+    /**
+     * Get badge count (iOS/Android)
+     */
+    getBadgeCount?(): Promise<number>;
+    /**
+     * Set badge count (iOS/Android)
+     */
+    setBadgeCount?(count: number): Promise<boolean>;
+    /**
+     * Create notification channel (Android)
+     */
+    createNotificationChannel?(channelId: string, channelName: string, importance?: number, description?: string): Promise<string | null>;
+    /**
+     * Delete notification channel (Android)
+     */
+    deleteNotificationChannel?(channelId: string): Promise<boolean>;
+}
+/**
+ * Standard event names for push notifications
+ */
+export declare const PUSH_NOTIFICATION_EVENTS: PushNotificationEvents;
+//# sourceMappingURL=PushNotificationProvider.d.ts.map

package/lib/typescript/module/src/providers/PushNotificationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PushNotificationProvider.d.ts","sourceRoot":"","sources":["../../../../../src/providers/PushNotificationProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE;YACR,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;SACpB,CAAC;QACF,GAAG,CAAC,EAAE;YACJ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;SACpB,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAElC;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEvE;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE1E;;;OAGG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD;;OAEG;IACH,yBAAyB,CAAC,CACxB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1B;;OAEG;IACH,yBAAyB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,sBAMtC,CAAC"}

package/lib/typescript/module/src/services/DeviceRegistrationService.d.ts

@@ -0,0 +1,60 @@
+import type { DeviceCredentials } from '../state/DeviceStateMachine';
+/**
+ * DeviceRegistrationService
+ *
+ * Handles device registration WITHOUT push token logic.
+ * This service is responsible for:
+ * - Creating/retrieving device IDs
+ * - Managing anonymous profiles (generatedCDID)
+ * - Registering devices with the backend
+ * - Storing device credentials
+ *
+ * KEY: This service does NOT handle push tokens.
+ * Push token management is handled separately by PushTokenService.
+ */
+export declare class DeviceRegistrationService {
+    private appId;
+    private deviceId;
+    private isProduction;
+    private sendToSwanFn;
+    private getDeviceLocationFn;
+    constructor(appId: string, isProduction: 'STAGE' | 'PROD', sendToSwanFn: (url: string, data: any, encode: boolean) => Promise<any>, getDeviceLocationFn: () => Promise<any>);
+    /**
+     * Register device with backend.
+     * If device already registered, returns cached credentials.
+     * Otherwise, creates new device registration.
+     *
+     * NO PUSH TOKEN LOGIC - device registration is independent of push tokens.
+     */
+    registerDevice(): Promise<DeviceCredentials>;
+    /**
+     * Get stored device credentials
+     */
+    getStoredCredentials(key?: string): Promise<DeviceCredentials | null>;
+    /**
+     * Save device credentials
+     */
+    private saveCredentials;
+    /**
+     * Update stored credentials (partial update)
+     */
+    updateStoredCredentials(updates: Partial<DeviceCredentials>): Promise<void>;
+    /**
+     * Register new device with backend
+     * NO PUSH TOKEN PARAMETER - device registration is independent
+     */
+    private registerNewDevice;
+    /**
+     * Update device location on backend
+     */
+    updateLocation(): Promise<void>;
+    /**
+     * Update device on backend (for push token updates and location updates)
+     */
+    private updateDeviceOnBackend;
+    /**
+     * Get device ID
+     */
+    getDeviceId(): string | null;
+}
+//# sourceMappingURL=DeviceRegistrationService.d.ts.map

package/lib/typescript/module/src/services/DeviceRegistrationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceRegistrationService.d.ts","sourceRoot":"","sources":["../../../../../src/services/DeviceRegistrationService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIrE;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAA6B;IAGjD,OAAO,CAAC,YAAY,CAA4D;IAChF,OAAO,CAAC,mBAAmB,CAAqB;gBAG9C,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,OAAO,GAAG,MAAM,EAC9B,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,EACvE,mBAAmB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC;IAQzC;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAuDlD;;OAEG;IACG,oBAAoB,CAAC,GAAG,SAAoB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAatF;;OAEG;YACW,eAAe;IAsB7B;;OAEG;IACG,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjF;;;OAGG;YACW,iBAAiB;IA6C/B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BrC;;OAEG;YACW,qBAAqB;IA2BnC;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,IAAI;CAG7B"}

package/lib/typescript/module/src/services/PushTokenService.d.ts

@@ -0,0 +1,82 @@
+import type { DeviceRegistrationService } from './DeviceRegistrationService';
+import type { PushNotificationProvider } from '../providers/PushNotificationProvider';
+type EventCallback = (data: any) => void;
+/**
+ * PushTokenService
+ *
+ * Manages push token lifecycle:
+ * - Initializes push provider (Firebase, etc.)
+ * - Handles token generation and refresh
+ * - Updates device with token when available
+ * - Manages permission requests
+ *
+ * This service is INDEPENDENT of device registration.
+ * Tokens are managed separately and can arrive at any time.
+ */
+export declare class PushTokenService {
+    private provider;
+    private eventListeners;
+    constructor(provider: PushNotificationProvider, _deviceService: DeviceRegistrationService);
+    /**
+     * Initialize push notification provider
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * Request push notification permission
+     */
+    requestPermission(): Promise<boolean>;
+    /**
+     * Check if permission is granted
+     */
+    hasPermission(): Promise<boolean>;
+    /**
+     * Get current push token
+     */
+    getToken(): Promise<string | null>;
+    /**
+     * Delete push token (when user revokes permission)
+     */
+    deleteToken(): Promise<boolean>;
+    /**
+     * Get badge count
+     */
+    getBadgeCount(): Promise<number>;
+    /**
+     * Set badge count
+     */
+    setBadgeCount(count: number): Promise<boolean>;
+    /**
+     * Create notification channel (Android)
+     */
+    createNotificationChannel(channelId: string, channelName: string, importance?: number, description?: string): Promise<string | null>;
+    /**
+     * Delete notification channel (Android only)
+     */
+    deleteNotificationChannel(channelId: string): Promise<boolean>;
+    /**
+     * Add event listener (delegates to provider)
+     */
+    addEventListener(eventName: string, callback: (data: any) => void): void;
+    /**
+     * Remove event listener (delegates to provider)
+     */
+    removeEventListener(eventName: string, callback: (data: any) => void): void;
+    /**
+     * Setup listeners for provider events (token refresh, notifications)
+     */
+    private setupProviderListeners;
+    /**
+     * Add event listener
+     */
+    on(eventName: string, callback: EventCallback): () => void;
+    /**
+     * Emit event to listeners
+     */
+    private emit;
+    /**
+     * Cleanup
+     */
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=PushTokenService.d.ts.map

package/lib/typescript/module/src/services/PushTokenService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PushTokenService.d.ts","sourceRoot":"","sources":["../../../../../src/services/PushTokenService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAGtF,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,cAAc,CAAuC;gBAG3D,QAAQ,EAAE,wBAAwB,EAClC,cAAc,EAAE,yBAAyB;IAM3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAmCpC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IA8B3C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IASvC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAYrC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAYtC;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYpD;;OAEG;IACG,yBAAyB,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoBzB;;OAEG;IACG,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAepE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIxE;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAI3E;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+C9B;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAgB1D;;OAEG;IACH,OAAO,CAAC,IAAI;IAgBZ;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/lib/typescript/module/src/state/AuthStateMachine.d.ts

@@ -0,0 +1,61 @@
+export declare enum AuthState {
+    LOGGED_OUT = "logged_out",
+    LOGGING_IN = "logging_in",
+    LOGGED_IN = "logged_in",
+    LOGGING_OUT = "logging_out",
+    ERROR = "error"
+}
+type StateChangeListener = (change: {
+    from: AuthState;
+    to: AuthState;
+}) => void;
+/**
+ * State machine for authentication flow (login/logout).
+ * Replaces isLoggingIn and isLoggingOut boolean flags.
+ *
+ * States:
+ * - LOGGED_OUT: No user logged in (anonymous profile)
+ * - LOGGING_IN: Login in progress
+ * - LOGGED_IN: User logged in (currentCDID set)
+ * - LOGGING_OUT: Logout in progress
+ * - ERROR: Login/logout failed
+ */
+export declare class AuthStateMachine {
+    private state;
+    private listeners;
+    private loginPromise;
+    private logoutPromise;
+    getState(): AuthState;
+    /**
+     * Subscribe to state changes
+     */
+    on(listener: StateChangeListener): () => void;
+    /**
+     * Execute login with duplicate call protection
+     */
+    login(loginFn: () => Promise<any>): Promise<any>;
+    /**
+     * Execute logout with duplicate call protection
+     */
+    logout(logoutFn: () => Promise<any>): Promise<any>;
+    /**
+     * Check if user is logged in
+     */
+    isLoggedIn(): boolean;
+    /**
+     * Check if login/logout operation is in progress
+     */
+    isOperationInProgress(): boolean;
+    /**
+     * Reset to logged out state
+     */
+    reset(): void;
+    /**
+     * Restore state from stored credentials (used during SDK initialization)
+     * @param isLoggedIn Whether user has currentCDID in stored credentials
+     */
+    restoreState(isLoggedIn: boolean): void;
+    private transition;
+}
+export {};
+//# sourceMappingURL=AuthStateMachine.d.ts.map

package/lib/typescript/module/src/state/AuthStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthStateMachine.d.ts","sourceRoot":"","sources":["../../../../../src/state/AuthStateMachine.ts"],"names":[],"mappings":"AAEA,oBAAY,SAAS;IACnB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;CAChB;AAED,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,KAAK,IAAI,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,aAAa,CAA6B;IAElD,QAAQ,IAAI,SAAS;IAIrB;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQ7C;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAgCtD;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAgCxD;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAKvC,OAAO,CAAC,UAAU;CAoBnB"}

package/lib/typescript/module/src/state/DeviceStateMachine.d.ts

@@ -0,0 +1,51 @@
+export declare enum DeviceState {
+    UNINITIALIZED = "uninitialized",
+    REGISTERING = "registering",
+    REGISTERED = "registered",
+    FAILED = "failed"
+}
+export interface DeviceCredentials {
+    deviceId: string;
+    generatedCDID: string;
+    currentCDID?: string | null;
+    first_seen_at?: string;
+    deviceActivatedAt?: string;
+    pushNotificationToken?: string;
+    pushPermission?: boolean;
+    isProduction: 'STAGE' | 'PROD';
+    [key: string]: any;
+}
+type StateChangeListener = (change: {
+    from: DeviceState;
+    to: DeviceState;
+}) => void;
+/**
+ * State machine for device registration flow.
+ * Eliminates race conditions from boolean flags.
+ *
+ * States: UNINITIALIZED → REGISTERING → REGISTERED → FAILED
+ */
+export declare class DeviceStateMachine {
+    private state;
+    private registrationPromise;
+    private listeners;
+    getState(): DeviceState;
+    /**
+     * Subscribe to state changes
+     */
+    on(listener: StateChangeListener): () => void;
+    /**
+     * Register device with race condition protection.
+     * If already registered, returns cached credentials.
+     * If registration in progress, waits for existing promise.
+     * Otherwise, starts new registration.
+     */
+    register(registrationFn: () => Promise<DeviceCredentials>): Promise<DeviceCredentials>;
+    /**
+     * Reset state machine (useful for testing or logout scenarios)
+     */
+    reset(): void;
+    private transition;
+}
+export {};
+//# sourceMappingURL=DeviceStateMachine.d.ts.map

package/lib/typescript/module/src/state/DeviceStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceStateMachine.d.ts","sourceRoot":"","sources":["../../../../../src/state/DeviceStateMachine.ts"],"names":[],"mappings":"AAEA,oBAAY,WAAW;IACrB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,WAAW,CAAA;CAAE,KAAK,IAAI,CAAC;AAEpF;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,mBAAmB,CAA2C;IACtE,OAAO,CAAC,SAAS,CAA6B;IAE9C,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQ7C;;;;;OAKG;IACG,QAAQ,CACZ,cAAc,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAC/C,OAAO,CAAC,iBAAiB,CAAC;IA8B7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,UAAU;CAoBnB"}

package/lib/typescript/module/src/state/PushStateMachine.d.ts

@@ -0,0 +1,61 @@
+export declare enum PushState {
+    DISABLED = "disabled",
+    INITIALIZING = "initializing",
+    READY = "ready",
+    PERMISSION_DENIED = "permission_denied",
+    TOKEN_PENDING = "token_pending",
+    ACTIVE = "active",
+    ERROR = "error"
+}
+type StateChangeListener = (change: {
+    from: PushState;
+    to: PushState;
+}) => void;
+/**
+ * State machine for push notification lifecycle.
+ * Manages the complex flow of permission → token → active states.
+ *
+ * States:
+ * - DISABLED: Push notifications not enabled in config
+ * - INITIALIZING: Loading Firebase provider
+ * - READY: Provider initialized, ready to request permission
+ * - PERMISSION_DENIED: User denied permission
+ * - TOKEN_PENDING: Permission granted, waiting for FCM token
+ * - ACTIVE: Token received and registered with backend
+ * - ERROR: Push initialization failed
+ */
+export declare class PushStateMachine {
+    private state;
+    private listeners;
+    getState(): PushState;
+    /**
+     * Subscribe to state changes
+     */
+    on(listener: StateChangeListener): () => void;
+    /**
+     * Transition to a new state
+     */
+    transition(newState: PushState): void;
+    /**
+     * Reset to disabled state
+     */
+    reset(): void;
+    /**
+     * Check if push is active (token received and synced)
+     */
+    isActive(): boolean;
+    /**
+     * Check if push is in error state
+     */
+    isError(): boolean;
+    /**
+     * Check if push is disabled
+     */
+    isDisabled(): boolean;
+    /**
+     * Validate state transitions (optional - for debugging)
+     */
+    private isValidTransition;
+}
+export {};
+//# sourceMappingURL=PushStateMachine.d.ts.map

package/lib/typescript/module/src/state/PushStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PushStateMachine.d.ts","sourceRoot":"","sources":["../../../../../src/state/PushStateMachine.ts"],"names":[],"mappings":"AAEA,oBAAY,SAAS;IACnB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;IAC7B,KAAK,UAAU;IACf,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;IAC/B,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,KAAK,IAAI,CAAC;AAEhF;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,SAAS,CAA6B;IAE9C,QAAQ,IAAI,SAAS;IAIrB;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQ7C;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IA4BrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAc1B"}

package/lib/typescript/module/src/types/EventQueue.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Type definitions for Event Batching System
+ * Supports offline queuing, batching, and fault-tolerant event delivery
+ */
+/**
+ * Event stored in the queue
+ */
+export interface QueuedEvent {
+    id: string;
+    eventName: string;
+    eventData: any;
+    timestamp: number;
+    priority: number;
+    retryCount: number;
+    status: 'pending' | 'sending' | 'failed';
+    createdAt: number;
+    lastAttemptAt?: number;
+}
+/**
+ * Configuration for batch processing
+ */
+export interface BatchConfiguration {
+    batchSize: number;
+    flushInterval: number;
+    maxQueueSize: number;
+    maxRetries: number;
+    retryBaseDelay: number;
+    enableCompression: boolean;
+    queueCleanupDays: number;
+}
+/**
+ * Batch payload sent to backend
+ */
+export interface BatchPayload {
+    common: {
+        appId: string;
+        deviceId: string;
+        sdkVersion: string;
+        platform: string;
+    };
+    events: BatchEvent[];
+    isBatch: boolean;
+}
+/**
+ * Individual event within a batch
+ */
+export interface BatchEvent {
+    id: string;
+    name: string;
+    timestamp: number;
+    data: any;
+    userId: string;
+    currentCDID: string | null;
+    generatedCDID: string;
+}
+/**
+ * Response from batch endpoint
+ */
+export interface BatchResponse {
+    success: boolean;
+    processedCount: number;
+    failedCount: number;
+    results: BatchResult[];
+}
+/**
+ * Result for individual event in batch
+ */
+export interface BatchResult {
+    id: string;
+    success: boolean;
+    CDID?: string;
+    profileSwitched?: boolean;
+    error?: string;
+}
+/**
+ * Queue call type constants
+ * Used to distinguish different network call types in the queue
+ */
+export declare const QUEUE_CALL_TYPES: {
+    readonly PUSH_SUBSCRIBE: "PUSH_SUBSCRIBE";
+    readonly PUSH_UNSUBSCRIBE: "PUSH_UNSUBSCRIBE";
+    readonly PROFILE_ENRICH: "PROFILE_ENRICH";
+    readonly NOTIFICATION_ACK: "SWAN_NOTIFICATION_ACK";
+};
+//# sourceMappingURL=EventQueue.d.ts.map

package/lib/typescript/module/src/types/EventQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventQueue.d.ts","sourceRoot":"","sources":["../../../../../src/types/EventQueue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;CASnB,CAAC"}

package/lib/typescript/module/src/types/SDK.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SDK Configuration Types
+ */
+/**
+ * Swan SDK Configuration
+ *
+ * Push notifications are DISABLED by default.
+ * Apps must explicitly opt-in to use push functionality.
+ */
+export interface SwanSDKConfig {
+    /**
+     * Push notification configuration
+     * If not specified, push notifications are disabled.
+     */
+    pushNotifications?: {
+        /**
+         * Enable push notifications (default: false)
+         */
+        enabled: boolean;
+        /**
+         * Automatically request notification permission on init (default: false)
+         * If false, app must call requestNotificationPermission() manually
+         */
+        autoRequestPermission?: boolean;
+        /**
+         * Push provider to use (default: 'firebase')
+         * Future: can support custom providers
+         */
+        provider?: 'firebase' | 'custom';
+        /**
+         * Custom provider instance (for advanced use cases)
+         */
+        customProvider?: any;
+    };
+    /**
+     * Enable debug logging (default: false)
+     */
+    logging?: boolean;
+    /**
+     * Enable production environment (default: false)
+     */
+    isProduction?: boolean;
+}
+/**
+ * Event callback type
+ */
+export type EventCallback = (data: any) => void;
+/**
+ * Event subscription
+ */
+export interface EventSubscription {
+    remove: () => void;
+}
+//# sourceMappingURL=SDK.d.ts.map

package/lib/typescript/module/src/types/SDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDK.d.ts","sourceRoot":"","sources":["../../../../../src/types/SDK.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,iBAAiB,CAAC,EAAE;QAClB;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;;WAGG;QACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAEhC;;;WAGG;QACH,QAAQ,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;QAEjC;;WAEG;QACH,cAAc,CAAC,EAAE,GAAG,CAAC;KACtB,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB"}