@rejourneyco/react-native 1.0.0

package/package.json

@@ -0,0 +1,102 @@
+{
+    "name": "@rejourneyco/react-native",
+    "version": "1.0.0",
+    "description": "Rejourney Session Recording SDK for React Native",
+    "main": "lib/commonjs/index.js",
+    "module": "lib/module/index.js",
+    "types": "lib/typescript/index.d.ts",
+    "react-native": "lib/module/index.js",
+    "source": "src/index.ts",
+    "files": [
+        "src",
+        "lib",
+        "android",
+        "ios",
+        "rejourney.podspec",
+        "!android/.gradle",
+        "!android/.idea",
+        "!android/build",
+        "!android/local.properties",
+        "!android/.settings",
+        "!android/*.iml",
+        "!ios/build",
+        "!ios/DerivedData",
+        "!ios/Pods",
+        "!ios/*.xcworkspace",
+        "!src/__tests__",
+        "!src/**/*.test.ts",
+        "!src/**/*.spec.ts",
+        "!.DS_Store",
+        "!**/.DS_Store",
+        "!lib/**/*.map"
+    ],
+    "scripts": {
+        "build": "npx react-native-builder-bob build",
+        "prepack": "npx react-native-builder-bob build",
+        "typescript": "tsc --noEmit",
+        "lint": "eslint \"**/*.{js,ts,tsx}\"",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "release": "release-it",
+        "verify:ios": "./scripts/verify-ios-structure.sh",
+        "test:ios-install": "./scripts/test-ios-install.sh"
+    },
+    "keywords": [
+        "react-native",
+        "session-recording",
+        "analytics",
+        "replay"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/rejourneyco/rejourney"
+    },
+    "author": "Rejourney",
+    "license": "Apache-2.0",
+    "devDependencies": {
+        "@eslint/js": "^9.15.0",
+        "@types/react": "*",
+        "@types/react-native": "*",
+        "@typescript-eslint/eslint-plugin": "^8.15.0",
+        "@typescript-eslint/parser": "^8.15.0",
+        "@vitest/coverage-v8": "^2.1.0",
+        "eslint": "^9.39.2",
+        "react": "*",
+        "react-native": "*",
+        "react-native-builder-bob": "^0.23.0",
+        "typescript": "^5.0.0",
+        "vitest": "^2.1.0"
+    },
+    "peerDependencies": {
+        "react": "*",
+        "react-native": "*"
+    },
+    "codegenConfig": {
+        "name": "RejourneySpec",
+        "type": "modules",
+        "jsSrcsDir": "src",
+        "android": {
+            "javaPackageName": "com.rejourney"
+        },
+        "ios": {
+            "modulesProvider": {
+                "Rejourney": "Rejourney"
+            }
+        }
+    },
+    "react-native-builder-bob": {
+        "source": "src",
+        "output": "lib",
+        "targets": [
+            "commonjs",
+            "module",
+            [
+                "typescript",
+                {
+                    "project": "tsconfig.json"
+                }
+            ]
+        ]
+    }
+}

package/rejourney.podspec

@@ -0,0 +1,21 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "rejourney"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"] || "https://rejourney.co"
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => "13.0" }
+  s.source       = { :git => package["repository"]["url"], :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}"
+  s.exclude_files = "ios/build/**/*"
+
+  # Dependencies
+  install_modules_dependencies(s)
+end

package/src/NativeRejourney.ts

@@ -0,0 +1,165 @@
+/**
+ * TurboModule spec for Rejourney SDK
+ *
+ * This file defines the native module interface for React Native's New Architecture.
+ * It follows the official React Native TurboModules pattern for Codegen compatibility.
+ *
+ * IMPORTANT: This spec file is used by Codegen to generate native bindings.
+ * The default export MUST be a direct TurboModuleRegistry.get() call.
+ *
+ * @see https://reactnative.dev/docs/turbo-native-modules-introduction
+ */
+
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+/**
+ * SDK telemetry metrics for observability
+ */
+export interface SDKMetrics {
+  uploadSuccessCount: number;
+  uploadFailureCount: number;
+  retryAttemptCount: number;
+  circuitBreakerOpenCount: number;
+  memoryEvictionCount: number;
+  offlinePersistCount: number;
+  sessionStartCount: number;
+  crashCount: number;
+  uploadSuccessRate: number;
+  avgUploadDurationMs: number;
+  currentQueueDepth: number;
+  lastUploadTime: number | null;
+  lastRetryTime: number | null;
+  totalBytesUploaded: number;
+  totalBytesEvicted: number;
+}
+
+/**
+ * Native Rejourney module specification for TurboModules (New Architecture)
+ *
+ * This interface defines all methods exposed by the native module.
+ * Codegen uses this to generate:
+ * - iOS: RejourneySpec.h (protocol) and RejourneySpec-generated.mm (JSI bindings)
+ * - Android: NativeRejourneySpec.java (interface)
+ */
+export interface Spec extends TurboModule {
+  /**
+   * Start a recording session
+   */
+  startSession(
+    userId: string,
+    apiUrl: string,
+    publicKey: string
+  ): Promise<{
+    success: boolean;
+    sessionId: string;
+    error?: string;
+  }>;
+
+  /**
+   * Stop the current recording session
+   */
+  stopSession(): Promise<{
+    success: boolean;
+    sessionId: string;
+    uploadSuccess?: boolean;
+    warning?: string;
+    error?: string;
+  }>;
+
+  /**
+   * Log a custom event
+   */
+  logEvent(
+    eventType: string,
+    details: Object
+  ): Promise<{
+    success: boolean;
+  }>;
+
+  /**
+   * Notify of a screen change
+   */
+  screenChanged(screenName: string): Promise<{
+    success: boolean;
+  }>;
+
+  /**
+   * Report scroll offset for timeline correlation
+   */
+  onScroll(offsetY: number): Promise<{
+    success: boolean;
+  }>;
+
+  /**
+   * Mark a visual change that should be captured
+   */
+  markVisualChange(reason: string, importance: string): Promise<boolean>;
+
+  /**
+   * Notify that an external URL is being opened
+   */
+  onExternalURLOpened(urlScheme: string): Promise<{
+    success: boolean;
+  }>;
+
+  /**
+   * Notify that an OAuth flow is starting
+   */
+  onOAuthStarted(provider: string): Promise<{
+    success: boolean;
+  }>;
+
+  /**
+   * Notify that an OAuth flow has completed
+   */
+  onOAuthCompleted(provider: string, success: boolean): Promise<{
+    success: boolean;
+  }>;
+
+  /**
+   * Get SDK telemetry metrics for observability
+   */
+  getSDKMetrics(): Promise<SDKMetrics>;
+
+  /**
+   * Trigger a debug crash (Dev only)
+   */
+  debugCrash(): void;
+
+  /**
+   * Trigger a debug ANR (Dev only)
+   * Blocks the main thread for the specified duration
+   */
+  debugTriggerANR(durationMs: number): void;
+
+  /**
+   * Get the current session ID
+   */
+  getSessionId(): Promise<string | null>;
+
+  /**
+   * Mask a view by its nativeID prop (will be occluded in recordings)
+   */
+  maskViewByNativeID(nativeID: string): Promise<{ success: boolean }>;
+
+  /**
+   * Unmask a view by its nativeID prop
+   */
+  unmaskViewByNativeID(nativeID: string): Promise<{ success: boolean }>;
+
+  setUserIdentity(userId: string): Promise<{ success: boolean }>;
+
+  setDebugMode(enabled: boolean): Promise<{ success: boolean }>;
+}
+
+/**
+ * Default export for Codegen.
+ *
+ * CRITICAL: This MUST be a direct TurboModuleRegistry.get() call.
+ * Codegen parses this file statically and requires this exact pattern.
+ *
+ * Using getEnforcing() would throw if module not found.
+ * Using get() returns null, which is safer during development/testing.
+ */
+export default TurboModuleRegistry.get<Spec>('Rejourney');

package/src/components/Mask.tsx

@@ -0,0 +1,80 @@
+/**
+ * Mask Component
+ * 
+ * Wrapper component to mask sensitive content in session replays.
+ * All children wrapped in this component will be obscured in recordings.
+ * 
+ * IMPORTANT: This file uses lazy loading to avoid "PlatformConstants could not be found"
+ * errors on React Native 0.81+ with New Architecture (Bridgeless).
+ * 
+ * @example
+ * ```tsx
+ * import { Mask } from 'rejourney';
+ * 
+ * // Mask sensitive user ID
+ * <Mask>
+ *   <Text>User ID: {user.id}</Text>
+ * </Mask>
+ * 
+ * // Mask credit card info
+ * <Mask>
+ *   <CreditCardDisplay card={card} />
+ * </Mask>
+ * ```
+ */
+import React from 'react';
+import type { ViewProps } from 'react-native';
+
+// Lazy-loaded React Native modules
+let _RN: typeof import('react-native') | null = null;
+
+function getRN(): typeof import('react-native') | null {
+    if (_RN) return _RN;
+    try {
+        _RN = require('react-native');
+        return _RN;
+    } catch {
+        return null;
+    }
+}
+
+export interface MaskProps extends ViewProps {
+    children: React.ReactNode;
+}
+
+/**
+ * Wrapper component to mask sensitive content in session replays.
+ * All children will be obscured in recordings.
+ * 
+ * Uses accessibilityHint to signal to the native capture engine
+ * that this view and its contents should be masked.
+ */
+export const Mask: React.FC<MaskProps> = ({ children, style, ...props }) => {
+    const RN = getRN();
+    
+    // If RN isn't loaded yet (shouldn't happen in practice), render children directly
+    if (!RN) {
+        return <>{children}</>;
+    }
+    
+    const { View, StyleSheet } = RN;
+    
+    const styles = StyleSheet.create({
+        container: {
+            // Minimal container style - doesn't affect layout
+        },
+    });
+    
+    return (
+        <View
+            {...props}
+            style={[styles.container, style]}
+            accessibilityHint="rejourney_occlude"
+            collapsable={false}
+        >
+            {children}
+        </View>
+    );
+};
+
+export default Mask;