@rejourneyco/react-native 1.0.0

package/ios/Core/RJLogger.m

@@ -0,0 +1,211 @@
+//
+//  RJLogger.m
+//  Rejourney
+//
+//  Centralized logging utility implementation.
+//
+//  Licensed under the Apache License, Version 2.0 (the "License");
+//  you may not use this file except in compliance with the License.
+//  You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS,
+//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//  See the License for the specific language governing permissions and
+//  limitations under the License.
+//
+//  Copyright (c) 2026 Rejourney
+//
+
+#import "RJLogger.h"
+
+#if __has_include(<React/RCTLog.h>)
+#import <React/RCTLog.h>
+#define RJ_HAS_RCT_LOG 1
+#else
+#define RJ_HAS_RCT_LOG 0
+#endif
+
+static RJLogLevel _minimumLogLevel;
+static BOOL _includeTimestamps = NO;
+static BOOL _debugMode = NO;
+static dispatch_once_t _onceToken;
+
+static NSString *const kLogPrefix = @"[Rejourney]";
+
+@implementation RJLogger
+
+#pragma mark - Class Properties
+
++ (void)initialize {
+  if (self == [RJLogger class]) {
+    dispatch_once(&_onceToken, ^{
+      _minimumLogLevel = RJLogLevelSilent;
+      _debugMode = NO;
+    });
+  }
+}
+
++ (RJLogLevel)minimumLogLevel {
+  return _minimumLogLevel;
+}
+
++ (void)setMinimumLogLevel:(RJLogLevel)minimumLogLevel {
+  _minimumLogLevel = minimumLogLevel;
+}
+
++ (BOOL)includeTimestamps {
+  return _includeTimestamps;
+}
+
++ (void)setIncludeTimestamps:(BOOL)includeTimestamps {
+  _includeTimestamps = includeTimestamps;
+}
+
++ (BOOL)debugMode {
+  return _debugMode;
+}
+
++ (void)setDebugMode:(BOOL)enabled {
+  _debugMode = enabled;
+  if (enabled) {
+    _minimumLogLevel = RJLogLevelDebug;
+  } else {
+#ifdef DEBUG
+    _minimumLogLevel = RJLogLevelError;
+#else
+    _minimumLogLevel = RJLogLevelSilent;
+#endif
+  }
+}
+
+#pragma mark - Logging Methods
+
++ (void)debug:(NSString *)format, ... {
+  va_list args;
+  va_start(args, format);
+  [self logWithLevel:RJLogLevelDebug format:format arguments:args];
+  va_end(args);
+}
+
++ (void)info:(NSString *)format, ... {
+  va_list args;
+  va_start(args, format);
+  [self logWithLevel:RJLogLevelInfo format:format arguments:args];
+  va_end(args);
+}
+
++ (void)warning:(NSString *)format, ... {
+  va_list args;
+  va_start(args, format);
+  [self logWithLevel:RJLogLevelWarning format:format arguments:args];
+  va_end(args);
+}
+
++ (void)error:(NSString *)format, ... {
+  va_list args;
+  va_start(args, format);
+  [self logWithLevel:RJLogLevelError format:format arguments:args];
+  va_end(args);
+}
+
++ (void)logWithLevel:(RJLogLevel)level format:(NSString *)format, ... {
+  va_list args;
+  va_start(args, format);
+  [self logWithLevel:level format:format arguments:args];
+  va_end(args);
+}
+
+#pragma mark - Private Methods
+
++ (void)logWithLevel:(RJLogLevel)level
+              format:(NSString *)format
+           arguments:(va_list)args {
+
+  if (level < _minimumLogLevel) {
+    return;
+  }
+
+  NSString *message = [[NSString alloc] initWithFormat:format arguments:args];
+
+  NSMutableString *fullMessage = [NSMutableString string];
+
+  if (_includeTimestamps) {
+    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
+    formatter.dateFormat = @"HH:mm:ss.SSS";
+    [fullMessage
+        appendFormat:@"[%@] ", [formatter stringFromDate:[NSDate date]]];
+  }
+
+  [fullMessage appendString:kLogPrefix];
+  [fullMessage appendString:[self levelIndicator:level]];
+  [fullMessage appendString:@" "];
+  [fullMessage appendString:message];
+
+  [self outputLog:fullMessage level:level];
+}
+
++ (NSString *)levelIndicator:(RJLogLevel)level {
+  switch (level) {
+  case RJLogLevelDebug:
+    return @"[DEBUG]";
+  case RJLogLevelInfo:
+    return @"";
+  case RJLogLevelWarning:
+    return @"[WARN]";
+  case RJLogLevelError:
+    return @"[ERROR]";
+  case RJLogLevelSilent:
+    return @"";
+  }
+}
+
++ (void)outputLog:(NSString *)message level:(RJLogLevel)level {
+#if RJ_HAS_RCT_LOG
+
+  switch (level) {
+  case RJLogLevelDebug:
+  case RJLogLevelInfo:
+    RCTLogInfo(@"%@", message);
+    break;
+  case RJLogLevelWarning:
+    RCTLogWarn(@"%@", message);
+    break;
+  case RJLogLevelError:
+    RCTLogError(@"%@", message);
+    break;
+  case RJLogLevelSilent:
+    break;
+  }
+#else
+  NSLog(@"%@", message);
+#endif
+}
+
+#pragma mark - Lifecycle Logs
+
++ (void)logInitSuccess:(NSString *)version {
+  if (_debugMode) {
+    RJLogInfo(@"[Rejourney] ✓ SDK initialized (v%@)", version);
+  }
+}
+
++ (void)logInitFailure:(NSString *)reason {
+  RJLogInfo(@"[Rejourney] ✗ Initialization failed: %@", reason);
+}
+
++ (void)logSessionStart:(NSString *)sessionId {
+  if (_debugMode) {
+    RJLogInfo(@"[Rejourney] Session started: %@", sessionId);
+  }
+}
+
++ (void)logSessionEnd:(NSString *)sessionId {
+  if (_debugMode) {
+    RJLogInfo(@"[Rejourney] Session ended: %@", sessionId);
+  }
+}
+
+@end

package/ios/Core/RJTypes.h

@@ -0,0 +1,176 @@
+//
+//  RJTypes.h
+//  Rejourney
+//
+//  Common type definitions used throughout the SDK.
+//
+//  Licensed under the Apache License, Version 2.0 (the "License");
+//  you may not use this file except in compliance with the License.
+//  You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS,
+//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//  See the License for the specific language governing permissions and
+//  limitations under the License.
+//
+//  Copyright (c) 2026 Rejourney
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+#pragma mark - Capture Importance
+
+/**
+ * Represents the importance level of a capture event.
+ * Higher importance events are less likely to be skipped during throttling.
+ */
+typedef NS_ENUM(NSInteger, RJCaptureImportance) {
+    /// Low importance - can be freely skipped (e.g., heartbeat)
+    RJCaptureImportanceLow = 0,
+    
+    /// Medium importance - skip only under heavy load (e.g., tap gestures)
+    RJCaptureImportanceMedium = 1,
+    
+    /// High importance - rarely skip (e.g., scroll events)
+    RJCaptureImportanceHigh = 2,
+    
+    /// Critical importance - never skip (e.g., navigation, app lifecycle)
+    RJCaptureImportanceCritical = 3
+};
+
+#pragma mark - Performance Level
+
+/**
+ * Represents the current performance level of the capture engine.
+ * The engine adjusts its behavior based on system conditions.
+ */
+typedef NS_ENUM(NSInteger, RJPerformanceLevel) {
+    /// Normal operation - full capture rate
+    RJPerformanceLevelNormal = 0,
+    
+    /// Reduced rate due to low battery or thermal throttling
+    RJPerformanceLevelReduced = 1,
+    
+    /// Minimal captures due to memory pressure
+    RJPerformanceLevelMinimal = 2,
+    
+    /// All non-critical captures paused
+    RJPerformanceLevelPaused = 3
+};
+
+#pragma mark - Gesture Types
+
+/**
+ * Represents recognized gesture types.
+ */
+typedef NSString *RJGestureType NS_TYPED_EXTENSIBLE_ENUM;
+
+/// Single tap gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeTap;
+/// Double tap gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeDoubleTap;
+/// Long press gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeLongPress;
+/// Force touch (3D Touch) gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeForceTouch;
+/// Swipe left gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeSwipeLeft;
+/// Swipe right gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeSwipeRight;
+/// Swipe up gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeSwipeUp;
+/// Swipe down gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeSwipeDown;
+/// Scroll up gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeScrollUp;
+/// Scroll down gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeScrollDown;
+/// Pinch in (zoom out) gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypePinchIn;
+/// Pinch out (zoom in) gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypePinchOut;
+/// Clockwise rotation gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeRotateCW;
+/// Counter-clockwise rotation gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeRotateCCW;
+/// Two-finger pan up gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypePanUp;
+/// Two-finger pan down gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypePanDown;
+/// Two-finger pan left gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypePanLeft;
+/// Two-finger pan right gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypePanRight;
+/// Two-finger tap gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeTwoFingerTap;
+/// Three-finger gesture
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeThreeFingerGesture;
+/// Multi-touch gesture (4+ fingers)
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeMultiTouch;
+/// Keyboard tap (privacy-preserved)
+FOUNDATION_EXTERN RJGestureType const RJGestureTypeKeyboardTap;
+
+#pragma mark - Session Event Types
+
+/**
+ * Represents session event types for logging.
+ */
+typedef NSString *RJEventType NS_TYPED_EXTENSIBLE_ENUM;
+
+/// Session started
+FOUNDATION_EXTERN RJEventType const RJEventTypeSessionStart;
+/// Session ended
+FOUNDATION_EXTERN RJEventType const RJEventTypeSessionEnd;
+/// Session timed out due to background
+FOUNDATION_EXTERN RJEventType const RJEventTypeSessionTimeout;
+/// Navigation to new screen
+FOUNDATION_EXTERN RJEventType const RJEventTypeNavigation;
+/// User gesture performed
+FOUNDATION_EXTERN RJEventType const RJEventTypeGesture;
+/// Visual change occurred
+FOUNDATION_EXTERN RJEventType const RJEventTypeVisualChange;
+/// Keyboard shown
+FOUNDATION_EXTERN RJEventType const RJEventTypeKeyboardShow;
+/// Keyboard hidden
+FOUNDATION_EXTERN RJEventType const RJEventTypeKeyboardHide;
+/// Keyboard typing summary
+FOUNDATION_EXTERN RJEventType const RJEventTypeKeyboardTyping;
+/// App entered background
+FOUNDATION_EXTERN RJEventType const RJEventTypeAppBackground;
+/// App entered foreground
+FOUNDATION_EXTERN RJEventType const RJEventTypeAppForeground;
+/// App terminated
+FOUNDATION_EXTERN RJEventType const RJEventTypeAppTerminated;
+/// External URL opened
+FOUNDATION_EXTERN RJEventType const RJEventTypeExternalURLOpened;
+/// OAuth flow started
+FOUNDATION_EXTERN RJEventType const RJEventTypeOAuthStarted;
+/// OAuth flow completed
+FOUNDATION_EXTERN RJEventType const RJEventTypeOAuthCompleted;
+/// OAuth returned from external app
+FOUNDATION_EXTERN RJEventType const RJEventTypeOAuthReturned;
+
+#pragma mark - Completion Handlers
+
+/**
+ * Completion handler for operations that may succeed or fail.
+ *
+ * @param success Whether the operation succeeded.
+ */
+typedef void (^RJCompletionHandler)(BOOL success);
+
+/**
+ * Completion handler for session operations.
+ *
+ * @param success Whether the operation succeeded.
+ * @param sessionId The session ID (if applicable).
+ * @param error Error description (if failed).
+ */
+typedef void (^RJSessionCompletionHandler)(BOOL success, NSString *_Nullable sessionId, NSString *_Nullable error);
+
+NS_ASSUME_NONNULL_END

package/ios/Core/RJTypes.m

@@ -0,0 +1,66 @@
+//
+//  RJTypes.m
+//  Rejourney
+//
+//  Common type definitions implementation.
+//
+//  Licensed under the Apache License, Version 2.0 (the "License");
+//  you may not use this file except in compliance with the License.
+//  You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS,
+//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//  See the License for the specific language governing permissions and
+//  limitations under the License.
+//
+//  Copyright (c) 2026 Rejourney
+//
+
+#import "RJTypes.h"
+
+#pragma mark - Gesture Types
+
+RJGestureType const RJGestureTypeTap = @"tap";
+RJGestureType const RJGestureTypeDoubleTap = @"double_tap";
+RJGestureType const RJGestureTypeLongPress = @"long_press";
+RJGestureType const RJGestureTypeForceTouch = @"force_touch";
+RJGestureType const RJGestureTypeSwipeLeft = @"swipe_left";
+RJGestureType const RJGestureTypeSwipeRight = @"swipe_right";
+RJGestureType const RJGestureTypeSwipeUp = @"swipe_up";
+RJGestureType const RJGestureTypeSwipeDown = @"swipe_down";
+RJGestureType const RJGestureTypeScrollUp = @"scroll_up";
+RJGestureType const RJGestureTypeScrollDown = @"scroll_down";
+RJGestureType const RJGestureTypePinchIn = @"pinch_in";
+RJGestureType const RJGestureTypePinchOut = @"pinch_out";
+RJGestureType const RJGestureTypeRotateCW = @"rotate_cw";
+RJGestureType const RJGestureTypeRotateCCW = @"rotate_ccw";
+RJGestureType const RJGestureTypePanUp = @"pan_up";
+RJGestureType const RJGestureTypePanDown = @"pan_down";
+RJGestureType const RJGestureTypePanLeft = @"pan_left";
+RJGestureType const RJGestureTypePanRight = @"pan_right";
+RJGestureType const RJGestureTypeTwoFingerTap = @"two_finger_tap";
+RJGestureType const RJGestureTypeThreeFingerGesture = @"three_finger_gesture";
+RJGestureType const RJGestureTypeMultiTouch = @"multi_touch";
+RJGestureType const RJGestureTypeKeyboardTap = @"keyboard_tap";
+
+#pragma mark - Session Event Types
+
+RJEventType const RJEventTypeSessionStart = @"session_start";
+RJEventType const RJEventTypeSessionEnd = @"session_end";
+RJEventType const RJEventTypeSessionTimeout = @"session_timeout";
+RJEventType const RJEventTypeNavigation = @"navigation";
+RJEventType const RJEventTypeGesture = @"gesture";
+RJEventType const RJEventTypeVisualChange = @"visual_change";
+RJEventType const RJEventTypeKeyboardShow = @"keyboard_show";
+RJEventType const RJEventTypeKeyboardHide = @"keyboard_hide";
+RJEventType const RJEventTypeKeyboardTyping = @"keyboard_typing";
+RJEventType const RJEventTypeAppBackground = @"app_background";
+RJEventType const RJEventTypeAppForeground = @"app_foreground";
+RJEventType const RJEventTypeAppTerminated = @"app_terminated";
+RJEventType const RJEventTypeExternalURLOpened = @"external_url_opened";
+RJEventType const RJEventTypeOAuthStarted = @"oauth_started";
+RJEventType const RJEventTypeOAuthCompleted = @"oauth_completed";
+RJEventType const RJEventTypeOAuthReturned = @"oauth_returned";

package/ios/Core/Rejourney.h

@@ -0,0 +1,64 @@
+//
+//  Rejourney.h
+//  Rejourney
+//
+//  React Native TurboModule for session recording.
+//
+//  Dual Architecture Support:
+//  - Old Architecture: Implements RCTBridgeModule
+//  - New Architecture: Implements NativeRejourneySpec (generated by Codegen)
+//
+//  Licensed under the Apache License, Version 2.0 (the "License");
+//  you may not use this file except in compliance with the License.
+//  You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS,
+//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//  See the License for the specific language governing permissions and
+//  limitations under the License.
+//
+//  Copyright (c) 2026 Rejourney
+//
+
+#ifndef Rejourney_Core_h
+#define Rejourney_Core_h
+
+#import <Foundation/Foundation.h>
+
+#if __has_include(<React/RCTBridgeModule.h>)
+#import <React/RCTBridgeModule.h>
+#else
+#import "RCTBridgeModule.h"
+#endif
+
+// New Architecture (TurboModules) support
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <RejourneySpec/RejourneySpec.h>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Rejourney Native Module
+ *
+ * Architecture Support:
+ * - Old Architecture: Conforms to RCTBridgeModule, uses RCT_EXPORT_METHOD macros
+ * - New Architecture: Also conforms to NativeRejourneySpec, implements getTurboModule:
+ *
+ * The module automatically detects the architecture at runtime and uses
+ * the appropriate communication channel (Bridge vs JSI).
+ */
+#ifdef RCT_NEW_ARCH_ENABLED
+@interface Rejourney : NSObject <RCTBridgeModule, NativeRejourneySpec>
+#else
+@interface Rejourney : NSObject <RCTBridgeModule>
+#endif
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif /* Rejourney_Core_h */