@teardown/react-native 2.0.24 → 2.0.27

package/src/clients/device/adapters/device-info.adapter.ts

@@ -1,36 +1,29 @@
-import type {
-  ApplicationInfo,
-  HardwareInfo,
-  OSInfo
-} from "@teardown/schemas";
+import type { ApplicationInfo, HardwareInfo, OSInfo } from "@teardown/schemas";
 import { Platform } from "react-native";
 import DeviceInfo from "react-native-device-info";
 import { DeviceInfoAdapter as BaseInfoAdapterInterface } from "./device.adpater-interface";
 
 export class DeviceInfoAdapter extends BaseInfoAdapterInterface {
-  get applicationInfo(): ApplicationInfo {
-    return {
-      version: DeviceInfo.getVersion() ?? "0.0.0",
-      build_number: Number.parseInt(
-        DeviceInfo.getBuildNumber() ?? "0",
-        10
-      ),
-    };
-  }
+	get applicationInfo(): ApplicationInfo {
+		return {
+			version: DeviceInfo.getVersion() ?? "0.0.0",
+			build_number: Number.parseInt(DeviceInfo.getBuildNumber() ?? "0", 10),
+		};
+	}
 
-  get hardwareInfo(): HardwareInfo {
-    return {
-      device_name: DeviceInfo.getDeviceNameSync() ?? "Unknown Device",
-      device_brand: DeviceInfo.getBrand() ?? "Unknown Brand",
-      device_type: DeviceInfo.getDeviceType?.() ?? "unknown",
-    };
-  }
+	get hardwareInfo(): HardwareInfo {
+		return {
+			device_name: DeviceInfo.getDeviceNameSync() ?? "Unknown Device",
+			device_brand: DeviceInfo.getBrand() ?? "Unknown Brand",
+			device_type: DeviceInfo.getDeviceType?.() ?? "unknown",
+		};
+	}
 
-  get osInfo(): OSInfo {
-    return {
-      platform: this.mapPlatform(Platform.OS),
-      name: DeviceInfo.getSystemName() ?? Platform.OS,
-      version: DeviceInfo.getSystemVersion() ?? "0.0.0",
-    };
-  }
+	get osInfo(): OSInfo {
+		return {
+			platform: this.mapPlatform(Platform.OS),
+			name: DeviceInfo.getSystemName() ?? Platform.OS,
+			version: DeviceInfo.getSystemVersion() ?? "0.0.0",
+		};
+	}
 }

package/src/clients/device/adapters/device.adpater-interface.ts

@@ -1,9 +1,4 @@
-import type {
-	ApplicationInfo,
-	DeviceInfo,
-	HardwareInfo,
-	OSInfo
-} from "@teardown/schemas";
+import type { ApplicationInfo, DeviceInfo, HardwareInfo, OSInfo } from "@teardown/schemas";
 import type { Platform } from "react-native";
 import { DevicePlatformEnum } from "../device.client";
 
@@ -37,7 +32,6 @@ export abstract class DeviceInfoAdapter {
 			application: this.applicationInfo,
 			hardware: this.hardwareInfo,
 			os: this.osInfo,
-			notifications: null,
 			update: null,
 		});
 	}
@@ -61,5 +55,4 @@ export abstract class DeviceInfoAdapter {
 				return DevicePlatformEnum.UNKNOWN;
 		}
 	}
-
 }

package/src/clients/device/adapters/expo.adapter.ts

@@ -1,8 +1,4 @@
-import type {
-  ApplicationInfo,
-  HardwareInfo,
-  OSInfo
-} from "@teardown/schemas";
+import type { ApplicationInfo, HardwareInfo, OSInfo } from "@teardown/schemas";
 import * as Application from "expo-application";
 import * as Device from "expo-device";
 import { Platform } from "react-native";
@@ -13,44 +9,41 @@ import { DeviceInfoAdapter } from "./device.adpater-interface";
  * Maps expo-device DeviceType to a string representation
  */
 function mapDeviceType(deviceType: Device.DeviceType | null): string {
-  switch (deviceType) {
-    case Device.DeviceType.PHONE:
-      return "phone";
-    case Device.DeviceType.TABLET:
-      return "tablet";
-    case Device.DeviceType.DESKTOP:
-      return "desktop";
-    case Device.DeviceType.TV:
-      return "tv";
-    default:
-      return "unknown";
-  }
+	switch (deviceType) {
+		case Device.DeviceType.PHONE:
+			return "phone";
+		case Device.DeviceType.TABLET:
+			return "tablet";
+		case Device.DeviceType.DESKTOP:
+			return "desktop";
+		case Device.DeviceType.TV:
+			return "tv";
+		default:
+			return "unknown";
+	}
 }
 
 export class ExpoDeviceAdapter extends DeviceInfoAdapter {
-  get applicationInfo(): ApplicationInfo {
-    return {
-      version: Application.nativeApplicationVersion ?? "0.0.0",
-      build_number: Number.parseInt(
-        Application.nativeBuildVersion ?? "0",
-        10
-      ),
-    };
-  }
+	get applicationInfo(): ApplicationInfo {
+		return {
+			version: Application.nativeApplicationVersion ?? "0.0.0",
+			build_number: Number.parseInt(Application.nativeBuildVersion ?? "0", 10),
+		};
+	}
 
-  get hardwareInfo(): HardwareInfo {
-    return {
-      device_name: Device.deviceName ?? "Unknown Device",
-      device_brand: Device.brand ?? "Unknown Brand",
-      device_type: mapDeviceType(Device.deviceType),
-    };
-  }
+	get hardwareInfo(): HardwareInfo {
+		return {
+			device_name: Device.deviceName ?? "Unknown Device",
+			device_brand: Device.brand ?? "Unknown Brand",
+			device_type: mapDeviceType(Device.deviceType),
+		};
+	}
 
-  get osInfo(): OSInfo {
-    return {
-      platform: this.mapPlatform(Platform.OS),
-      name: Device.osName ?? Platform.OS,
-      version: Device.osVersion ?? "0.0.0",
-    };
-  }
+	get osInfo(): OSInfo {
+		return {
+			platform: this.mapPlatform(Platform.OS),
+			name: Device.osName ?? Platform.OS,
+			version: Device.osVersion ?? "0.0.0",
+		};
+	}
 }

package/src/clients/device/device.client.test.ts

@@ -1,15 +1,15 @@
-import type { DeviceInfo } from "@teardown/schemas";
 import { describe, expect, test } from "bun:test";
+import type { DeviceInfo } from "@teardown/schemas";
 import type { DeviceInfoAdapter } from "./adapters/device.adpater-interface";
 import { DeviceClient } from "./device.client";
 
 function createMockLoggingClient() {
 	return {
 		createLogger: () => ({
-			info: () => { },
-			warn: () => { },
-			error: () => { },
-			debug: () => { },
+			info: () => {},
+			warn: () => {},
+			error: () => {},
+			debug: () => {},
 		}),
 	};
 }
@@ -70,12 +70,9 @@ describe("DeviceClient", () => {
 			const mockUtils = createMockUtilsClient();
 			const mockAdapter = createMockDeviceAdapter();
 
-			const client = new DeviceClient(
-				mockLogging as never,
-				mockUtils as never,
-				mockStorage as never,
-				{ adapter: mockAdapter }
-			);
+			const client = new DeviceClient(mockLogging as never, mockUtils as never, mockStorage as never, {
+				adapter: mockAdapter,
+			});
 
 			const deviceId = await client.getDeviceId();
 
@@ -92,12 +89,9 @@ describe("DeviceClient", () => {
 			// Pre-populate storage with a device ID
 			mockStorage.getStorage().set("deviceId", "existing-device-id");
 
-			const client = new DeviceClient(
-				mockLogging as never,
-				mockUtils as never,
-				mockStorage as never,
-				{ adapter: mockAdapter }
-			);
+			const client = new DeviceClient(mockLogging as never, mockUtils as never, mockStorage as never, {
+				adapter: mockAdapter,
+			});
 
 			const deviceId = await client.getDeviceId();
 
@@ -114,12 +108,9 @@ describe("DeviceClient", () => {
 
 			mockStorage.getStorage().set("deviceId", "consistent-id");
 
-			const client = new DeviceClient(
-				mockLogging as never,
-				mockUtils as never,
-				mockStorage as never,
-				{ adapter: mockAdapter }
-			);
+			const client = new DeviceClient(mockLogging as never, mockUtils as never, mockStorage as never, {
+				adapter: mockAdapter,
+			});
 
 			const id1 = await client.getDeviceId();
 			const id2 = await client.getDeviceId();
@@ -138,12 +129,9 @@ describe("DeviceClient", () => {
 			const mockUtils = createMockUtilsClient();
 			const mockAdapter = createMockDeviceAdapter();
 
-			const client = new DeviceClient(
-				mockLogging as never,
-				mockUtils as never,
-				mockStorage as never,
-				{ adapter: mockAdapter }
-			);
+			const client = new DeviceClient(mockLogging as never, mockUtils as never, mockStorage as never, {
+				adapter: mockAdapter,
+			});
 
 			const deviceInfo = await client.getDeviceInfo();
 
@@ -174,12 +162,9 @@ describe("DeviceClient", () => {
 				},
 			} as DeviceInfoAdapter;
 
-			const client = new DeviceClient(
-				mockLogging as never,
-				mockUtils as never,
-				mockStorage as never,
-				{ adapter: customAdapter }
-			);
+			const client = new DeviceClient(mockLogging as never, mockUtils as never, mockStorage as never, {
+				adapter: customAdapter,
+			});
 
 			const deviceInfo = await client.getDeviceInfo();
 

package/src/clients/device/device.client.ts

@@ -51,7 +51,6 @@ export class DeviceClient {
 	}
 
 	async getDeviceId(): Promise<string> {
-
 		this.logger.debug("Getting device ID");
 		const deviceId = this.storage.getItem("deviceId");
 		this.logger.debug(`Device ID found in storage: ${deviceId}`);
@@ -68,6 +67,4 @@ export class DeviceClient {
 	async getDeviceInfo(): Promise<DeviceInfo> {
 		return this.options.adapter.getDeviceInfo();
 	}
-
-
 }

package/src/clients/identity/identity.client.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, mock, test, beforeEach } from "bun:test";
+import { describe, expect, mock, test } from "bun:test";
 
 // Mock react-native before any imports that use it
 mock.module("react-native", () => ({
@@ -493,7 +493,7 @@ describe("IdentityClient", () => {
 
 			const stored = mockStorage.getStorage().get(IDENTIFY_STORAGE_KEY);
 			expect(stored).toBeDefined();
-			const parsed = JSON.parse(stored!);
+			const parsed = JSON.parse(stored ?? "{}");
 			expect(parsed.type).toBe("identified");
 			expect(parsed.session.session_id).toBe("session-123");
 			expect(parsed.version_info.status).toBe(IdentifyVersionStatusEnum.UP_TO_DATE);
@@ -755,7 +755,7 @@ describe("IdentityClient", () => {
 			await client.identify();
 
 			// Update mock to return new session
-			mockApi.client = async (endpoint: string, config: ApiCallRecord["config"]) => ({
+			mockApi.client = async (_endpoint: string, _config: ApiCallRecord["config"]) => ({
 				error: null,
 				data: {
 					data: {
@@ -800,7 +800,7 @@ describe("IdentityClient", () => {
 			// After reset, storage should contain unidentified state
 			const stored = mockStorage.getStorage().get(IDENTIFY_STORAGE_KEY);
 			expect(stored).toBeDefined();
-			expect(JSON.parse(stored!).type).toBe("unidentified");
+			expect(JSON.parse(stored ?? "{}").type).toBe("unidentified");
 		});
 
 		test("emits unidentified state on reset", async () => {
@@ -1049,14 +1049,14 @@ describe("IdentityClient", () => {
 			// Check storage while API call is pending
 			await new Promise((resolve) => setTimeout(resolve, 10));
 			const intermediateStored = mockStorage.getStorage().get(IDENTIFY_STORAGE_KEY);
-			expect(JSON.parse(intermediateStored!).type).toBe("identifying");
+			expect(JSON.parse(intermediateStored ?? "{}").type).toBe("identifying");
 
 			// Complete API call
-			resolveApi!(null);
+			resolveApi?.(null);
 			await identifyPromise;
 
 			const finalStored = mockStorage.getStorage().get(IDENTIFY_STORAGE_KEY);
-			expect(JSON.parse(finalStored!).type).toBe("identified");
+			expect(JSON.parse(finalStored ?? "{}").type).toBe("identified");
 		});
 
 		test("storage survives client recreation", async () => {
@@ -1140,7 +1140,7 @@ describe("IdentityClient", () => {
 
 			// Verify it can be stored and retrieved
 			const stored = mockStorage.getStorage().get(IDENTIFY_STORAGE_KEY);
-			const parsed = JSON.parse(stored!);
+			const parsed = JSON.parse(stored ?? "{}");
 			expect(parsed.session.session_id).toBe("session-with-émojis-🚀-and-üñíçödé");
 		});
 	});

package/src/clients/identity/identity.client.ts

@@ -23,7 +23,7 @@ export interface IdentityUser {
 		status: IdentifyVersionStatusEnum;
 		update: null;
 	};
-};
+}
 
 export const UnidentifiedSessionStateSchema = z.object({
 	type: z.literal("unidentified"),

package/src/clients/identity/index.ts

@@ -1 +1 @@
-export * from "./identity.client";
+export * from "./identity.client";

package/src/clients/logging/index.ts

@@ -1 +1 @@
-export * from "./logging.client";
+export * from "./logging.client";

package/src/clients/notifications/adapters/expo-notifications.adapter.ts

@@ -0,0 +1,105 @@
+import * as Notifications from "expo-notifications";
+import { NotificationPlatformEnum } from "../../device/device.client";
+import {
+	type DataMessage,
+	NotificationAdapter,
+	type PermissionStatus,
+	type PushNotification,
+	type Unsubscribe,
+} from "./notifications.adapter-interface";
+
+/**
+ * Notification adapter for expo-notifications library.
+ * Uses Expo push tokens for routing through Expo's notification service.
+ *
+ * @example
+ * ```typescript
+ * import { NotificationsClient } from "@teardown/react-native";
+ * import { ExpoNotificationsAdapter } from "@teardown/react-native/expo-notifications";
+ *
+ * const notifications = new NotificationsClient(logging, storage, {
+ *   adapter: new ExpoNotificationsAdapter()
+ * });
+ * ```
+ */
+export class ExpoNotificationsAdapter extends NotificationAdapter {
+	get platform(): NotificationPlatformEnum {
+		return NotificationPlatformEnum.EXPO;
+	}
+
+	async getToken(): Promise<string | null> {
+		try {
+			const { status } = await Notifications.getPermissionsAsync();
+			if (status !== "granted") {
+				return null;
+			}
+
+			const tokenData = await Notifications.getExpoPushTokenAsync();
+			return tokenData.data;
+		} catch {
+			return null;
+		}
+	}
+
+	async requestPermissions(): Promise<PermissionStatus> {
+		const { status, canAskAgain } = await Notifications.requestPermissionsAsync();
+
+		return {
+			granted: status === "granted",
+			canAskAgain: canAskAgain ?? true,
+		};
+	}
+
+	onTokenRefresh(listener: (token: string) => void): Unsubscribe {
+		const subscription = Notifications.addPushTokenListener((event) => {
+			// Expo push token listener returns ExpoPushToken object
+			if (event.data) {
+				listener(event.data);
+			}
+		});
+
+		return () => subscription.remove();
+	}
+
+	onNotificationReceived(listener: (notification: PushNotification) => void): Unsubscribe {
+		const subscription = Notifications.addNotificationReceivedListener((notification) => {
+			const content = notification.request.content;
+			listener({
+				title: content.title ?? undefined,
+				body: content.body ?? undefined,
+				data: content.data ?? undefined,
+			});
+		});
+
+		return () => subscription.remove();
+	}
+
+	onNotificationOpened(listener: (notification: PushNotification) => void): Unsubscribe {
+		const subscription = Notifications.addNotificationResponseReceivedListener((response) => {
+			const content = response.notification.request.content;
+			listener({
+				title: content.title ?? undefined,
+				body: content.body ?? undefined,
+				data: content.data ?? undefined,
+			});
+		});
+
+		return () => subscription.remove();
+	}
+
+	onDataMessage(listener: (message: DataMessage) => void): Unsubscribe {
+		// In Expo, data-only messages come through the same listener as regular notifications
+		// but without title/body. We filter for messages that have data but no display content.
+		const subscription = Notifications.addNotificationReceivedListener((notification) => {
+			const content = notification.request.content;
+			// Data-only message: has data but no title or body
+			if (content.data && !content.title && !content.body) {
+				listener({
+					data: content.data,
+				});
+			}
+		});
+
+		return () => subscription.remove();
+	}
+}

package/src/clients/notifications/adapters/firebase-messaging.adapter.ts

@@ -0,0 +1,87 @@
+import messaging, { type FirebaseMessagingTypes } from "@react-native-firebase/messaging";
+import { NotificationPlatformEnum } from "../../device/device.client";
+import {
+	type DataMessage,
+	NotificationAdapter,
+	type PermissionStatus,
+	type PushNotification,
+	type Unsubscribe,
+} from "./notifications.adapter-interface";
+
+/**
+ * Notification adapter for @react-native-firebase/messaging library.
+ * Uses FCM (Firebase Cloud Messaging) tokens for push notifications.
+ *
+ * @example
+ * ```typescript
+ * import { NotificationsClient } from "@teardown/react-native";
+ * import { FirebaseMessagingAdapter } from "@teardown/react-native/firebase-messaging";
+ *
+ * const notifications = new NotificationsClient(logging, storage, {
+ *   adapter: new FirebaseMessagingAdapter()
+ * });
+ * ```
+ */
+export class FirebaseMessagingAdapter extends NotificationAdapter {
+	get platform(): NotificationPlatformEnum {
+		return NotificationPlatformEnum.FCM;
+	}
+
+	async getToken(): Promise<string | null> {
+		try {
+			const token = await messaging().getToken();
+			return token;
+		} catch {
+			return null;
+		}
+	}
+
+	async requestPermissions(): Promise<PermissionStatus> {
+		const authStatus = await messaging().requestPermission();
+
+		const granted =
+			authStatus === messaging.AuthorizationStatus.AUTHORIZED ||
+			authStatus === messaging.AuthorizationStatus.PROVISIONAL;
+
+		// Firebase doesn't expose canAskAgain, assume true if not denied
+		const canAskAgain = authStatus !== messaging.AuthorizationStatus.DENIED;
+
+		return { granted, canAskAgain };
+	}
+
+	onTokenRefresh(listener: (token: string) => void): Unsubscribe {
+		return messaging().onTokenRefresh(listener);
+	}
+
+	onNotificationReceived(listener: (notification: PushNotification) => void): Unsubscribe {
+		return messaging().onMessage((remoteMessage: FirebaseMessagingTypes.RemoteMessage) => {
+			listener({
+				title: remoteMessage.notification?.title,
+				body: remoteMessage.notification?.body,
+				data: remoteMessage.data,
+			});
+		});
+	}
+
+	onNotificationOpened(listener: (notification: PushNotification) => void): Unsubscribe {
+		return messaging().onNotificationOpenedApp((remoteMessage: FirebaseMessagingTypes.RemoteMessage) => {
+			listener({
+				title: remoteMessage.notification?.title,
+				body: remoteMessage.notification?.body,
+				data: remoteMessage.data,
+			});
+		});
+	}
+
+	onDataMessage(listener: (message: DataMessage) => void): Unsubscribe {
+		// Firebase data-only messages come through onMessage but without notification payload
+		return messaging().onMessage((remoteMessage: FirebaseMessagingTypes.RemoteMessage) => {
+			// Data-only message: has data but no notification
+			if (remoteMessage.data && !remoteMessage.notification) {
+				listener({
+					data: remoteMessage.data,
+				});
+			}
+		});
+	}
+}

package/src/clients/notifications/adapters/notifications.adapter-interface.ts

@@ -0,0 +1,112 @@
+import type { NotificationPlatformEnum } from "../../device/device.client";
+
+/**
+ * Permission status returned from notification permission requests.
+ */
+export interface PermissionStatus {
+	/** Whether notifications permission is granted */
+	granted: boolean;
+	/** Whether the user can be prompted again (iOS specific) */
+	canAskAgain: boolean;
+}
+
+/**
+ * Normalized push notification payload across all adapters.
+ */
+export interface PushNotification {
+	/** Notification title */
+	title?: string;
+	/** Notification body text */
+	body?: string;
+	/** Custom data payload */
+	data?: Record<string, unknown>;
+}
+
+/**
+ * Data-only message payload (silent/background push).
+ * These messages contain only data without notification display.
+ */
+export interface DataMessage {
+	/** Custom data payload */
+	data: Record<string, unknown>;
+}
+
+/**
+ * Function to unsubscribe from event listeners.
+ */
+export type Unsubscribe = () => void;
+
+/**
+ * Abstract adapter interface for push notification providers.
+ *
+ * Implement this interface to add support for different push notification
+ * libraries (expo-notifications, firebase messaging, react-native-notifications).
+ *
+ * @example
+ * ```typescript
+ * class MyNotificationAdapter extends NotificationAdapter {
+ *   get platform() { return NotificationPlatformEnum.FCM; }
+ *   async getToken() { ... }
+ *   // ... implement other methods
+ * }
+ * ```
+ */
+export abstract class NotificationAdapter {
+	/**
+	 * The notification platform this adapter supports.
+	 * Used to identify token type when sending to backend.
+	 */
+	abstract get platform(): NotificationPlatformEnum;
+
+	/**
+	 * Get the current push notification token.
+	 * Returns null if permissions not granted or token unavailable.
+	 */
+	abstract getToken(): Promise<string | null>;
+
+	/**
+	 * Request push notification permissions from the user.
+	 * On iOS, shows the permission dialog. On Android 13+, requests POST_NOTIFICATIONS.
+	 */
+	abstract requestPermissions(): Promise<PermissionStatus>;
+
+	/**
+	 * Subscribe to token refresh events.
+	 * Called when the push token changes (e.g., after app reinstall or token rotation).
+	 *
+	 * @param listener - Callback invoked with new token
+	 * @returns Unsubscribe function to remove the listener
+	 */
+	abstract onTokenRefresh(listener: (token: string) => void): Unsubscribe;
+
+	/**
+	 * Subscribe to foreground notification events.
+	 * Called when a notification is received while the app is in the foreground.
+	 *
+	 * @param listener - Callback invoked with notification payload
+	 * @returns Unsubscribe function to remove the listener
+	 */
+	abstract onNotificationReceived(listener: (notification: PushNotification) => void): Unsubscribe;
+
+	/**
+	 * Subscribe to notification opened events.
+	 * Called when the user taps on a notification to open the app.
+	 *
+	 * @param listener - Callback invoked with notification payload
+	 * @returns Unsubscribe function to remove the listener
+	 */
+	abstract onNotificationOpened(listener: (notification: PushNotification) => void): Unsubscribe;
+
+	/**
+	 * Subscribe to data-only message events (silent/background push).
+	 * Called when a data-only message is received without notification display.
+	 * These are typically used for background data sync or silent updates.
+	 *
+	 * Note: On iOS, requires "Remote notifications" background mode enabled.
+	 * On Android, these are handled automatically via FCM data messages.
+	 *
+	 * @param listener - Callback invoked with data payload
+	 * @returns Unsubscribe function to remove the listener
+	 */
+	abstract onDataMessage(listener: (message: DataMessage) => void): Unsubscribe;
+}