lig-scanner-expo-sdk 0.5.0 → 1.0.0

package/CLAUDE.md

@@ -12,7 +12,7 @@ This is `lig-scanner-expo-sdk`, an Expo module SDK wrapper for the LiG Scanner l
 - **Core TypeScript API**: `src/` contains the main module interface and high-level components
 - **Native module interface**: `LigScannerExpoSdkModule.ts` declares native methods (initialize, startScanning, stopScanning, showARPlayer)
 - **Native iOS implementation**: `ios/` (Swift) with LiG Scanner engine integration
-- **Native Android implementation**: `android/` (Kotlin) with corresponding functionality  
+- **Native Android implementation**: `android/` (Kotlin) with corresponding functionality
 - **Example app**: `example/App.tsx` demonstrates both integrated and manual usage patterns
 
 ### Key Components Architecture
@@ -60,6 +60,12 @@ npm run open:ios
 
 # Open Android project in Android Studio
 npm run open:android
+
+# Run example app on iOS (requires iOS simulator or device)
+npm run ios
+
+# Run example app on Android (requires Android emulator or device)
+npm run android
 ```
 
 ## Development Patterns
@@ -69,7 +75,7 @@ The SDK uses a state machine pattern managed by `LigScannerManager`:
 - `initializing` → `ready` → `scanning` → `ligtag_ready` (success path)
 - Error states: `error_device`, `error_auth`, `error_other`
 
-### Event System Architecture  
+### Event System Architecture
 - **Native Events**: `onLigtagFound`, `onStatusReported`, `onARReady`, `onARError`, `onARClosed`, `onGameEvent`
 - **Manager Events**: `stateChange`, `tagUpdate`, `tagReady`, `error`
 - **Hook Integration**: State changes automatically trigger React re-renders
@@ -93,4 +99,4 @@ The `example/App.tsx` demonstrates two complete integration approaches:
 
 - `expo-module.config.json`: Defines Apple/Android platforms, native module class names, and required permissions (camera)
 - `tsconfig.json`: Extends expo-module-scripts base config, outputs to `build/`
-- Platform permissions: Camera access required for both iOS (NSCameraUsageDescription) and Android (android.permission.CAMERA)
+- Platform permissions: Camera access required for both iOS (NSCameraUsageDescription) and Android (android.permission.CAMERA)

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Sat Dec 13 20:46:53 CST 2025
+gradle.version=8.9

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'tw.com.lig.scanner.rn.expo'
-version = '0.1.0'
+version = '0.5.1'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -46,7 +46,7 @@ android {
   namespace "tw.com.lig.scanner.rn.expo"
   defaultConfig {
     versionCode 1
-    versionName "0.1.0"
+    versionName "0.5.1"
   }
   lintOptions {
     abortOnError false

package/ios/ARPlayerView.swift

@@ -258,7 +258,7 @@ class ARPlayerView: ExpoView {
         guard !isArOriginSet,
               let lightTagId = lightTagId,
               let arSceneView = arSceneView,
-              let sceneContext = sceneContext else {
+              sceneContext != nil else {
             return
         }
         
@@ -296,13 +296,18 @@ class ARPlayerView: ExpoView {
         
         Task {
             do {
+
                 // Load scene information from LiG Cloud (following iOS Player SDK pattern)
                 let coordinateSystem = try await sceneContext.loadCoordinateSystemFrom(lightId: deviceId, accessToken: scannerAccessToken ?? "")
                 
                 if let cs = coordinateSystem, let scene = cs.scenes?.first {
+
                     sceneContext.startDownloadZip(with: scene.assetsUrl)
+                } else {
+
                 }
             } catch {
+
                 // Handle loading error silently
             }
         }
@@ -367,14 +372,18 @@ extension ARPlayerView: ARSCNViewDelegate {
 
 extension ARPlayerView: SceneKitContextDelegate {
     func didLoaded() {
-//        let ligScene = LiGPlayer.sharedContext?.ligScene
-//        onSceneLoaded([
-//            "scene": [
-//                "id": ligScene?.scene?.sceneID?.description ?? "",
-//                "name": ligScene?.scene?.name ?? "",
-//                "status": "loaded"
-//            ]
-//        ])
+
+        
+        // Cannot access ligScene.scene (internal), so passing empty info for now
+        let sceneData: [String: Any] = [
+            "id": "",
+            "name": "",
+            "status": "loaded"
+        ]
+        
+        onSceneLoaded([
+            "scene": sceneData
+        ])
     }
     
     func gameTypeAction(gameType: LiGPlayerKit.GameType, value: LiGPlayerKit.GameResponse) {

package/ios/LigScannerExpoSdk.podspec

@@ -21,7 +21,7 @@ Pod::Spec.new do |s|
   s.dependency 'ExpoModulesCore'
   
   # LiG Scanner SDK dependencies
-  s.dependency 'LiGScannerKit', '~> 5.1.4'
+  s.dependency 'LiGScannerKit', '~> 5.2.1'
   s.dependency 'LiGPlayerKit', '~> 1.8.15'
   
   # iOS specific frameworks

package/ios/LigScannerExpoSdkModule.swift

@@ -6,8 +6,9 @@ import UIKit
 public class LigScannerExpoSdkModule: Module {
   private var isScanning = false
   private var isInitialized = false
+  private var shouldStartWhenReady = false
   private let scanner = LiGScanner.shared
-  private var lastDetectedTag: LiGTag?
+  private var lastDetectedTag: LigTag?
   private var hasListeners = false
   
   // Each module class must implement the definition function. The definition consists of components
@@ -71,24 +72,40 @@ public class LigScannerExpoSdkModule: Module {
 
     AsyncFunction("startScanning") { (promise: Promise) in
       guard self.isInitialized else {
+        self.shouldStartWhenReady = true
         promise.reject("NOT_INITIALIZED", "Scanner not initialized. Call initialize() first.")
         return
       }
-      
+
       guard !self.isScanning else {
         promise.resolve("Already scanning")
         return
       }
-      
-      self.scanner.start()
-      self.isScanning = true
-      
-      self.sendEvent("onStatusReported", [
-        "status": "SCANNING",
-        "value": 2
-      ])
-      
-      promise.resolve("Scanning started")
+
+      Task {
+        await MainActor.run {
+            // Start LiGTransformManager early for gravity alignment
+            LiGTransformManager.shared.start()
+        }
+        
+        do {
+          try await self.scanner.start()
+          await MainActor.run {
+            self.isScanning = true
+            
+            self.sendEvent("onStatusReported", [
+              "status": "SCANNING",
+              "value": 2
+            ])
+
+            promise.resolve("Scanning started")
+          }
+        } catch {
+          await MainActor.run {
+            promise.reject("START_FAILED", "Failed to start scanner: \(error)")
+          }
+        }
+      }
     }
 
     AsyncFunction("stopScanning") { (promise: Promise) in
@@ -98,6 +115,9 @@ public class LigScannerExpoSdkModule: Module {
       }
       
       self.scanner.stop()
+      // Stop LiGTransformManager
+      LiGTransformManager.shared.stop()
+      
       self.isScanning = false
       
       promise.resolve("Scanning stopped")
@@ -150,58 +170,86 @@ public class LigScannerExpoSdkModule: Module {
   }
   
   // MARK: - Helper Methods
-  
+
   private func initializeScanner(_ productKey: String, _ promise: Promise) {
-    self.isInitialized = true
-    
     // Set up delegate
     self.scanner.delegate = self
-    
+
     self.sendEvent("onStatusReported", [
       "status": "INITIALIZING",
       "value": 0
     ])
-    
-    // Initialize LiGScanner SDK
-    self.scanner.initialize(productKey)
-    
-    self.sendEvent("onStatusReported", [
-      "status": "INITIALIZED",
-      "value": 1
-    ])
-    
-    promise.resolve("Scanner initialized")
+
+    Task {
+      do {
+        // Initialize LiGScanner SDK (async/await)
+        try await self.scanner.initialize(productKey: productKey)
+
+        await MainActor.run {
+          self.isInitialized = true
+
+          self.sendEvent("onStatusReported", [
+            "status": "INITIALIZED",
+            "value": 1
+          ])
+
+          // Start scanning if it was requested before initialization completed
+          if self.shouldStartWhenReady {
+            self.shouldStartWhenReady = false
+            Task {
+              do {
+                try await self.scanner.start()
+                await MainActor.run {
+                  self.isScanning = true
+                  
+                  // Start LiGTransformManager for gravity alignment
+                  LiGTransformManager.shared.start()
+                  
+                  self.sendEvent("onStatusReported", [
+                    "status": "SCANNING",
+                    "value": 2
+                  ])
+                }
+              } catch {
+                // Handle start error silently
+              }
+            }
+          }
+
+          promise.resolve("Scanner initialized")
+        }
+      } catch {
+        await MainActor.run {
+          self.isInitialized = false
+          promise.reject("INIT_FAILED", "Failed to initialize scanner: \(error)")
+        }
+      }
+    }
   }
 }
 
 // MARK: - LiGScannerDelegate
 
 extension LigScannerExpoSdkModule: LiGScannerDelegate {
-  public func scanner(_ scanner: LiGScanner, didDetect ligtag: LiGTag?) {
-    guard let tag = ligtag else { return }
-    
+  public func ligScanner(_ scanner: LiGScanner, didFind ligTag: LigTag?) {
+    guard let tag = ligTag else { return }
+
     // Store the tag for AR player
     lastDetectedTag = tag
-    
-    
-    // Map LiGTag to match Android's onLightIDFound format exactly
+
+
+      // Map LigTag to match Android's onLightIDFound format exactly
     var eventData: [String: Any] = [
       "x": Double(tag.coordinateX),
       "y": Double(tag.coordinateY),
       "isReady": tag.isReady,
-      "isDetected": tag.isDetected,
+      "isDetected": tag.detected,
       "deviceId": tag.deviceId,
-      "status": mapStatusToString(tag.status)
+      "status": mapStatusFromBooleans(detected: tag.detected, decoded: tag.decoded, validPose: tag.validPose, isReady: tag.isReady)
     ]
-    
-    // Add timing data if detected
-    if tag.isDetected {
-      eventData["detectionTime"] = Int(tag.detectionTime)
-      eventData["decodedTime"] = Int(tag.decodedTime)
-    }
-    
+
     // Add position data for all detected tags (needed for AR coordinate system setup)
-    if tag.isDetected {
+    if tag.detected {
       eventData["rotation"] = [
         "x": Double(tag.rotation.x),
         "y": Double(tag.rotation.y),
@@ -212,126 +260,96 @@ extension LigScannerExpoSdkModule: LiGScannerDelegate {
         "y": Double(tag.translation.y),
         "z": Double(tag.translation.z)
       ]
-      eventData["position"] = [
-        "x": Double(tag.position.x),
-        "y": Double(tag.position.y),
-        "z": Double(tag.position.z)
-      ]
-      // Add accessToken for AR cloud authentication
-      eventData["accessToken"] = tag.accessToken
-      
+      // Add accessToken for AR cloud authentication (now optional)
+      if let accessToken = tag.accessToken {
+        eventData["accessToken"] = accessToken
+      }
+
       // Add transform matrix for direct AR coordinate system setup
-      let transform = tag.transform
-      let transformArray: [Double] = [
-        Double(transform.columns.0.x), Double(transform.columns.0.y), 
-        Double(transform.columns.0.z), Double(transform.columns.0.w),
-        Double(transform.columns.1.x), Double(transform.columns.1.y), 
-        Double(transform.columns.1.z), Double(transform.columns.1.w),
-        Double(transform.columns.2.x), Double(transform.columns.2.y), 
-        Double(transform.columns.2.z), Double(transform.columns.2.w),
-        Double(transform.columns.3.x), Double(transform.columns.3.y), 
-        Double(transform.columns.3.z), Double(transform.columns.3.w)
-      ]
-      eventData["transform"] = transformArray
+      // Use gravity-aligned transform from LiGTransformManager ONLY if pose is valid and ready
+      // This prevents Division by Zero in simd_quaternion when rotation is (0,0,0)
+      if tag.isReady && tag.validPose {
+          let transform = LiGTransformManager.shared.getAlignedTransform(tag: tag)
+
+          // Check for NaNs as a second safety layer
+          if !transform.columns.0.x.isNaN && !transform.columns.0.y.isNaN {
+              let transformArray: [Double] = [
+                Double(transform.columns.0.x), Double(transform.columns.0.y),
+                Double(transform.columns.0.z), Double(transform.columns.0.w),
+                Double(transform.columns.1.x), Double(transform.columns.1.y),
+                Double(transform.columns.1.z), Double(transform.columns.1.w),
+                Double(transform.columns.2.x), Double(transform.columns.2.y),
+                Double(transform.columns.2.z), Double(transform.columns.2.w),
+                Double(transform.columns.3.x), Double(transform.columns.3.y),
+                Double(transform.columns.3.z), Double(transform.columns.3.w)
+              ]
+              eventData["transform"] = transformArray
+          }
+      }
     }
-    
+
     sendEvent("onLigtagFound", eventData)
   }
   
-  public func scanner(_ scanner: LiGScannerKit.LiGScanner, didReport status: LiGScannerKit.LiGScannerError) {
-    
+  public func ligScanner(_ scanner: LiGScannerKit.LiGScanner, didReport status: LiGScannerKit.StatusCode) {
+
     // Handle specific status codes
     switch status {
-    case .correct, .deviceIsSupported, .authenticationOK, .initializationComplete, .scannerStopped:
+    case .deviceIsSupported, .authenticationOK, .scannerStopped:
       // These are positive status updates, not errors
       sendEvent("onStatusReported", [
-        "status": mapErrorToString(status),
+        "status": mapStatusCodeToString(status),
         "value": status.rawValue,
         "isError": false
       ])
-      
-    case .invalidProductKey:
+
+    case .authenticationFailed:
       // Reset initialization state to allow retry
       self.isInitialized = false
       sendEvent("onStatusReported", [
-        "status": "INVALID_PRODUCT_KEY",
+        "status": "AUTHENTICATION_FAILED",
         "value": status.rawValue,
         "isError": true,
-        "error": "Invalid product key"
+        "error": "Authentication failed"
       ])
-      
+
     default:
         sendEvent("onStatusReported", [
-          "status": "STATUS: \(status)",
+          "status": status.description.uppercased().replacingOccurrences(of: " ", with: "_"),
           "value": status.rawValue,
           "isError": true,
-          "error": "STATUS: \(status)"
+          "error": status.description
         ])
       // Log error but don't send events to avoid alert dialogs
       // Handle other scanner errors silently
     }
   }
   
-  private func mapStatusToString(_ status: LiGTagStatus) -> String {
-    switch status {
-    case .ready:                          return "READY"
-    case .notDetected:                    return "NOT_DETECTED"
-    case .notDecoded:                     return "NOT_DECODED"
-    case .invalidPosition:                return "INVALID_POSITION"
-    case .notRegistered:                  return "NOT_REGISTER"
-    case .invalidPositionTooClose:        return "INVALID_POSITION_TOO_CLOSE"
-    case .distanceRangeRestrictionNear:   return "DISTANCE_RANGE_RESTRICTION_NEAR"
-    case .distanceRangeRestrictionFar:    return "DISTANCE_RANGE_RESTRUCTION_FAR"
-    case .invalidPositionUnknown:         return "INVALID_POSITION_UNKNOWN"
-    @unknown default:                     return "UNKNOWN_STATUS"
+  private func mapStatusFromBooleans(detected: Bool, decoded: Bool, validPose: Bool, isReady: Bool) -> String {
+    if isReady {
+      return "READY"
+    } else if !detected {
+      return "NOT_DETECTED"
+    } else if !decoded {
+      return "NOT_DECODED"
+    } else if !validPose {
+      return "INVALID_POSITION"
+    } else {
+      return "UNKNOWN_STATUS"
     }
   }
-  
-  private func mapErrorToString(_ error: LiGScannerError) -> String {
-    switch error {
-    case .correct:                      return "TAG_DETECTED"
-    case .initErrorNotSupport:              return "INIT_ERROR_NOT_SUPPORT"
-    case .permissionLack:                   return "PERMISSION_LACK"
+
+  private func mapStatusCodeToString(_ status: StatusCode) -> String {
+    switch status {
     case .notInitialized:                   return "NOT_INITIALIZED"
-    case .imageLowQuality:                  return "IMAGE_LOW_QUALITY"
-    case .cameraNotAvailable:                         return "CAMERA_NOT_AVAILABLE"
-    case .deviceNotSupported:               return "DEVICE_NOT_SUPPORTED"
-    case .cameraAccessException:            return "CAMERA_ACCESS_EXCEPTION"
-    case .internetAnomaly:                  return "INTERNET_ANOMALY"
-    case .lackInternetPermission:           return "LACK_INTERNET_PERMISSION"
-    case .lackAccessWifiStatePermission:    return "LACK_ACCESS_WIFI_STATE_PERMISSION"
-    case .lackCameraPermission:             return "LACK_CAMERA_PERMISSION"
-    case .lackExternalStoragePermission:    return "LACK_EXTERNAL_STORAGE_PERMISSION"
-    case .lackReadPhoneStatePermission:     return "LACK_READ_PHONE_STATE_PERMISSION"
-    case .lackAccessNetworkStatePermission: return "LACK_ACCESS_NETWORK_STATE_PERMISSION"
-    case .serverAnomaly:                    return "SERVER_ANOMALY"
-    case .tokenExpired:                     return "TOKEN_EXPIRED"
-    case .configurationError:               return "CONFIGURATION_ERROR"
+    case .noSupportDevice:                  return "DEVICE_NOT_SUPPORTED"
     case .deviceIsSupported:                return "DEVICE_IS_SUPPORTED"
-    case .deviceStatusUnknown:              return "DEVICE_STATUS_UNKNOWN"
     case .authenticationOK:                 return "AUTHENTICATION_OK"
     case .authenticationFailed:             return "AUTHENTICATION_FAILED"
     case .authenticationTimeout:            return "AUTHENTICATION_TIMEOUT"
-    case .authenticationInterrupted:        return "AUTHENTICATION_INTERRUPTED"
-    case .initializationComplete:           return "INITIALIZATION_COMPLETE"
-    case .alreadyInitialized:               return "ALREADY_INITIALIZED"
-    case .invalidProductKey:                return "INVALID_PRODUCT_KEY"
-    case .cameraPermissionDenied:           return "CAMERA_PERMISSION_DENIED"
-    case .cameraConfigurationFailed:        return "CAMERA_CONFIGURATION_FAILED"
-    case .processingFailed:                 return "PROCESSING_FAILED"
-    case .insufficientLighting:             return "INSUFFICIENT_LIGHTING"
-    case .cameraFocusFailed:                return "CAMERA_FOCUS_FAILED"
-    case .networkError:                     return "NETWORK_ERROR"
-    case .invalidServerResponse:            return "INVALID_SERVER_RESPONSE"
-    case .invalidConfiguration:             return "INVALID_CONFIGURATION"
-    case .encryptionFailed:                 return "ENCRYPTION_FAILED"
-    case .decryptionFailed:                 return "DECRYPTION_FAILED"
     case .scannerStopped:                   return "SCANNER_STOPPED"
-    case .invalidParameter:                 return "INVALID_PARAMETER"
-    case .algorithmError:                   return "ALGORITHM_ERROR"
-    case .internalError:                    return "INTERNAL_ERROR"
-    case .unknown:                          return "UNKNOWN"
-    @unknown default:                       return "UNKNOWN_STATUS_\(error.rawValue)"
+    case .serverAnomaly:                    return "SERVER_ANOMALY"
+    @unknown default:                       return status.description.uppercased().replacingOccurrences(of: " ", with: "_")
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lig-scanner-expo-sdk",
-  "version": "0.5.0",
+  "version": "1.0.0",
   "description": "LiG Scanner SDK Wrapper for Expo framework library",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -23,7 +23,7 @@
     "lig-scanner-expo-sdk",
     "LigScannerExpoSdk"
   ],
-  "repository": "https://github.com/plainwuatlig/lig-scanner-expo-sdk",
+  "repository": "git+https://github.com/plainwuatlig/lig-scanner-expo-sdk.git",
   "bugs": {
     "url": "https://github.com/plainwuatlig/lig-scanner-expo-sdk/issues"
   },
@@ -46,4 +46,4 @@
     "react": "*",
     "react-native": "*"
   }
-}
+}