react-native-rectangle-doc-scanner 3.106.0 → 3.108.0

package/README.md

@@ -120,7 +120,7 @@ Manual capture exposes an imperative `capture()` method via `ref`. Children rend
 ## Convenience APIs
 
 - `CropEditor` – wraps `react-native-perspective-image-cropper` for manual corner adjustment.
-- `FullDocScanner` – puts the scanner and crop editor into a single modal-like flow. If the host app has the `expo-image-manipulator` native module installed, the confirmation screen exposes 90° rotation buttons; otherwise rotation controls remain hidden.
+- `FullDocScanner` – puts the scanner and crop editor into a single modal-like flow. If the host app links either `expo-image-manipulator` or `react-native-image-rotate`, the confirmation screen exposes 90° rotation buttons; otherwise rotation controls remain hidden.
 
 ## License
 

package/SETUP.md

@@ -117,7 +117,7 @@ function MyComponent() {
 }
 ```
 
-> 참고: 최종 확인 화면의 회전 버튼은 프로젝트에 `expo-image-manipulator` 네이티브 모듈이 설치되어 있을 때만 노출됩니다. 모듈이 없으면 버튼이 자동으로 숨겨지고 원본 각도로 결과가 반환됩니다.
+> 참고: 최종 확인 화면의 회전 버튼은 프로젝트에 `expo-image-manipulator` 또는 `react-native-image-rotate` 네이티브 모듈이 연결되어 있을 때만 노출됩니다. 둘 중 하나라도 없으면 버튼이 자동으로 숨겨지고 원본 각도로 결과가 반환됩니다.
 
 ## API 변경사항
 

package/dist/FullDocScanner.js

@@ -44,14 +44,44 @@ const react_native_image_crop_picker_1 = __importDefault(require("react-native-i
 const react_native_fs_1 = __importDefault(require("react-native-fs"));
 const DocScanner_1 = require("./DocScanner");
 let ImageManipulator = null;
+let ImageRotate = null;
+const ImageStoreManager = react_native_1.NativeModules.ImageStoreManager;
 try {
     ImageManipulator = require('expo-image-manipulator');
 }
 catch (error) {
-    console.warn('[FullDocScanner] expo-image-manipulator module unavailable. Image rotation will be disabled.', error);
+    console.warn('[FullDocScanner] expo-image-manipulator module unavailable. Checking fallback options.', error);
 }
-const isImageRotationSupported = !!ImageManipulator?.manipulateAsync;
+try {
+    const rotateModule = require('react-native-image-rotate');
+    ImageRotate = (rotateModule?.default ?? rotateModule);
+}
+catch (error) {
+    console.warn('[FullDocScanner] react-native-image-rotate module unavailable. Image rotation fallback disabled.', error);
+}
+const isExpoImageManipulatorAvailable = !!ImageManipulator?.manipulateAsync;
+const isImageRotateAvailable = !!ImageRotate?.rotateImage;
+const isImageRotationSupported = isExpoImageManipulatorAvailable || isImageRotateAvailable;
 const stripFileUri = (value) => value.replace(/^file:\/\//, '');
+const ensureFileUri = (value) => (value.startsWith('file://') ? value : `file://${value}`);
+const getBase64FromImageStore = async (uri) => {
+    const getBase64ForTag = ImageStoreManager?.getBase64ForTag?.bind(ImageStoreManager);
+    if (!getBase64ForTag) {
+        throw new Error('ImageStoreManager.getBase64ForTag unavailable');
+    }
+    return new Promise((resolve, reject) => {
+        getBase64ForTag(uri, (base64) => resolve(base64), (error) => {
+            const message = typeof error === 'string'
+                ? error
+                : error && typeof error === 'object' && 'message' in error
+                    ? String(error.message)
+                    : 'Failed to read from ImageStore';
+            reject(new Error(message));
+        });
+    }).finally(() => {
+        ImageStoreManager?.removeImageForTag?.(uri);
+    });
+};
 const CROPPER_TIMEOUT_MS = 8000;
 const CROPPER_TIMEOUT_CODE = 'cropper_timeout';
 const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -351,9 +381,25 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
     const handleFlashToggle = (0, react_1.useCallback)(() => {
         setFlashEnabled(prev => !prev);
     }, []);
+    const rotateImageWithFallback = (0, react_1.useCallback)((uri, angle) => {
+        return new Promise((resolve, reject) => {
+            if (!ImageRotate?.rotateImage) {
+                reject(new Error('react-native-image-rotate unavailable'));
+                return;
+            }
+            ImageRotate.rotateImage(uri, angle, (rotatedUri) => resolve(rotatedUri), (error) => {
+                const message = typeof error === 'string'
+                    ? error
+                    : error && typeof error === 'object' && 'message' in error
+                        ? String(error.message)
+                        : 'Unknown rotation error';
+                reject(new Error(message));
+            });
+        });
+    }, []);
     const handleRotateImage = (0, react_1.useCallback)((degrees) => {
         if (!isImageRotationSupported) {
-            console.warn('[FullDocScanner] Image rotation requested but expo-image-manipulator is unavailable.');
+            console.warn('[FullDocScanner] Image rotation requested but no rotation module is available.');
             return;
         }
         // UI만 회전 (실제 파일 회전은 confirm 시 처리)
@@ -372,10 +418,7 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
             return;
         }
         // 회전이 없거나 모듈을 사용할 수 없으면 기존 데이터 그대로 전달
-        if (rotationDegrees === 0 || !isImageRotationSupported || !ImageManipulator) {
-            if (rotationDegrees !== 0 && !isImageRotationSupported) {
-                console.warn('[FullDocScanner] Confirm requested with rotation but expo-image-manipulator is unavailable. Returning original image.');
-            }
+        if (rotationDegrees === 0) {
             onResult({
                 path: croppedImageData.path,
                 base64: croppedImageData.base64,
@@ -386,25 +429,51 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
             setProcessing(true);
             // 회전 각도 정규화 (0, 90, 180, 270)
             const rotationNormalized = ((rotationDegrees % 360) + 360) % 360;
-            const manipulator = ImageManipulator;
-            if (!manipulator?.manipulateAsync) {
-                console.warn('[FullDocScanner] expo-image-manipulator is unavailable at runtime. Returning original image.');
+            if (rotationNormalized === 0) {
                 onResult({
                     path: croppedImageData.path,
                     base64: croppedImageData.base64,
                 });
                 return;
             }
-            // expo-image-manipulator로 이미지 회전
-            const result = await manipulator.manipulateAsync(croppedImageData.path, [{ rotate: rotationNormalized }], {
-                compress: 0.9,
-                format: manipulator.SaveFormat.JPEG,
-                base64: true,
-            });
-            // 회전된 이미지로 결과 전달
+            if (isExpoImageManipulatorAvailable && ImageManipulator?.manipulateAsync) {
+                // expo-image-manipulator로 이미지 회전
+                const result = await ImageManipulator.manipulateAsync(croppedImageData.path, [{ rotate: rotationNormalized }], {
+                    compress: 0.9,
+                    format: ImageManipulator.SaveFormat.JPEG,
+                    base64: true,
+                });
+                onResult({
+                    path: result.uri,
+                    base64: result.base64,
+                });
+                return;
+            }
+            if (isImageRotateAvailable && ImageRotate?.rotateImage) {
+                const sourceUri = ensureFileUri(croppedImageData.path);
+                const rotatedUri = await rotateImageWithFallback(sourceUri, rotationNormalized);
+                let finalPath = croppedImageData.path;
+                let base64Result = croppedImageData.base64;
+                try {
+                    const base64FromStore = await getBase64FromImageStore(rotatedUri);
+                    const destinationPath = `${react_native_fs_1.default.CachesDirectoryPath}/full-doc-scanner-rotated-${Date.now()}-${Math.floor(Math.random() * 10000)}.jpg`;
+                    await react_native_fs_1.default.writeFile(destinationPath, base64FromStore, 'base64');
+                    finalPath = destinationPath;
+                    base64Result = base64FromStore;
+                }
+                catch (readError) {
+                    console.warn('[FullDocScanner] Failed to persist rotated image from ImageStore:', readError);
+                }
+                onResult({
+                    path: finalPath,
+                    base64: base64Result,
+                });
+                return;
+            }
+            console.warn('[FullDocScanner] Rotation requested but no supported rotation module is available. Returning original image.');
             onResult({
-                path: result.uri,
-                base64: result.base64,
+                path: croppedImageData.path,
+                base64: croppedImageData.base64,
             });
         }
         catch (error) {
@@ -415,7 +484,7 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
         finally {
             setProcessing(false);
         }
-    }, [croppedImageData, rotationDegrees, onResult]);
+    }, [croppedImageData, rotationDegrees, onResult, rotateImageWithFallback]);
     const handleRetake = (0, react_1.useCallback)(() => {
         console.log('[FullDocScanner] Retake - clearing cropped image and resetting scanner');
         setCroppedImageData(null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-rectangle-doc-scanner",
-  "version": "3.106.0",
+  "version": "3.108.0",
   "description": "Native-backed document scanner for React Native with customizable overlays.",
   "license": "MIT",
   "main": "dist/index.js",

package/src/FullDocScanner.tsx

@@ -8,6 +8,7 @@ import {
   Text,
   TouchableOpacity,
   View,
+  NativeModules,
 } from 'react-native';
 import { launchImageLibrary } from 'react-native-image-picker';
 import ImageCropPicker from 'react-native-image-crop-picker';
@@ -22,21 +23,79 @@ import type {
 } from './DocScanner';
 
 type ImageManipulatorModule = typeof import('expo-image-manipulator');
+type ImageRotateModule = {
+  rotateImage: (
+    uri: string,
+    angle: number,
+    onSuccess: (uri: string) => void,
+    onError: (error: unknown) => void,
+  ) => void;
+} | null;
+
+type ImageStoreModule = {
+  getBase64ForTag?: (
+    uri: string,
+    success: (base64: string) => void,
+    failure: (error: unknown) => void,
+  ) => void;
+  removeImageForTag?: (uri: string) => void;
+} | undefined;
 
 let ImageManipulator: ImageManipulatorModule | null = null;
+let ImageRotate: ImageRotateModule = null;
+const ImageStoreManager: ImageStoreModule = NativeModules.ImageStoreManager;
 
 try {
   ImageManipulator = require('expo-image-manipulator') as ImageManipulatorModule;
 } catch (error) {
   console.warn(
-    '[FullDocScanner] expo-image-manipulator module unavailable. Image rotation will be disabled.',
+    '[FullDocScanner] expo-image-manipulator module unavailable. Checking fallback options.',
     error,
   );
 }
 
-const isImageRotationSupported = !!ImageManipulator?.manipulateAsync;
+try {
+  const rotateModule = require('react-native-image-rotate');
+  ImageRotate = (rotateModule?.default ?? rotateModule) as ImageRotateModule;
+} catch (error) {
+  console.warn(
+    '[FullDocScanner] react-native-image-rotate module unavailable. Image rotation fallback disabled.',
+    error,
+  );
+}
+
+const isExpoImageManipulatorAvailable = !!ImageManipulator?.manipulateAsync;
+const isImageRotateAvailable = !!ImageRotate?.rotateImage;
+const isImageRotationSupported = isExpoImageManipulatorAvailable || isImageRotateAvailable;
 
 const stripFileUri = (value: string) => value.replace(/^file:\/\//, '');
+const ensureFileUri = (value: string) => (value.startsWith('file://') ? value : `file://${value}`);
+
+const getBase64FromImageStore = async (uri: string): Promise<string> => {
+  const getBase64ForTag = ImageStoreManager?.getBase64ForTag?.bind(ImageStoreManager);
+
+  if (!getBase64ForTag) {
+    throw new Error('ImageStoreManager.getBase64ForTag unavailable');
+  }
+
+  return new Promise<string>((resolve, reject) => {
+    getBase64ForTag(
+      uri,
+      (base64: string) => resolve(base64),
+      (error: unknown) => {
+        const message =
+          typeof error === 'string'
+            ? error
+            : error && typeof error === 'object' && 'message' in error
+              ? String((error as any).message)
+              : 'Failed to read from ImageStore';
+        reject(new Error(message));
+      },
+    );
+  }).finally(() => {
+    ImageStoreManager?.removeImageForTag?.(uri);
+  });
+};
 
 const CROPPER_TIMEOUT_MS = 8000;
 const CROPPER_TIMEOUT_CODE = 'cropper_timeout';
@@ -470,37 +529,58 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
     setFlashEnabled(prev => !prev);
   }, []);
 
-  const handleRotateImage = useCallback((degrees: -90 | 90) => {
-    if (!isImageRotationSupported) {
-      console.warn(
-        '[FullDocScanner] Image rotation requested but expo-image-manipulator is unavailable.',
-      );
-      return;
-    }
+  const rotateImageWithFallback = useCallback((uri: string, angle: number) => {
+    return new Promise<string>((resolve, reject) => {
+      if (!ImageRotate?.rotateImage) {
+        reject(new Error('react-native-image-rotate unavailable'));
+        return;
+      }
 
-    // UI만 회전 (실제 파일 회전은 confirm 시 처리)
-    setRotationDegrees((prev) => {
-      const newRotation = prev + degrees;
-      // -360 ~ 360 범위로 정규화
-      if (newRotation <= -360) return newRotation + 360;
-      if (newRotation >= 360) return newRotation - 360;
-      return newRotation;
+      ImageRotate.rotateImage(
+        uri,
+        angle,
+        (rotatedUri) => resolve(rotatedUri),
+        (error) => {
+          const message =
+            typeof error === 'string'
+              ? error
+              : error && typeof error === 'object' && 'message' in error
+                ? String((error as any).message)
+                : 'Unknown rotation error';
+          reject(new Error(message));
+        },
+      );
     });
   }, []);
 
+  const handleRotateImage = useCallback(
+    (degrees: -90 | 90) => {
+      if (!isImageRotationSupported) {
+        console.warn(
+          '[FullDocScanner] Image rotation requested but no rotation module is available.',
+        );
+        return;
+      }
+
+      // UI만 회전 (실제 파일 회전은 confirm 시 처리)
+      setRotationDegrees((prev) => {
+        const newRotation = prev + degrees;
+        // -360 ~ 360 범위로 정규화
+        if (newRotation <= -360) return newRotation + 360;
+        if (newRotation >= 360) return newRotation - 360;
+        return newRotation;
+      });
+    },
+    [],
+  );
+
   const handleConfirm = useCallback(async () => {
     if (!croppedImageData) {
       return;
     }
 
     // 회전이 없거나 모듈을 사용할 수 없으면 기존 데이터 그대로 전달
-    if (rotationDegrees === 0 || !isImageRotationSupported || !ImageManipulator) {
-      if (rotationDegrees !== 0 && !isImageRotationSupported) {
-        console.warn(
-          '[FullDocScanner] Confirm requested with rotation but expo-image-manipulator is unavailable. Returning original image.',
-        );
-      }
-
+    if (rotationDegrees === 0) {
       onResult({
         path: croppedImageData.path,
         base64: croppedImageData.base64,
@@ -514,12 +594,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
       // 회전 각도 정규화 (0, 90, 180, 270)
       const rotationNormalized = ((rotationDegrees % 360) + 360) % 360;
 
-      const manipulator = ImageManipulator;
-
-      if (!manipulator?.manipulateAsync) {
-        console.warn(
-          '[FullDocScanner] expo-image-manipulator is unavailable at runtime. Returning original image.',
-        );
+      if (rotationNormalized === 0) {
         onResult({
           path: croppedImageData.path,
           base64: croppedImageData.base64,
@@ -527,21 +602,56 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
         return;
       }
 
-      // expo-image-manipulator로 이미지 회전
-      const result = await manipulator.manipulateAsync(
-        croppedImageData.path,
-        [{ rotate: rotationNormalized }],
-        {
-          compress: 0.9,
-          format: manipulator.SaveFormat.JPEG,
-          base64: true,
-        },
-      );
+      if (isExpoImageManipulatorAvailable && ImageManipulator?.manipulateAsync) {
+        // expo-image-manipulator로 이미지 회전
+        const result = await ImageManipulator.manipulateAsync(
+          croppedImageData.path,
+          [{ rotate: rotationNormalized }],
+          {
+            compress: 0.9,
+            format: ImageManipulator.SaveFormat.JPEG,
+            base64: true,
+          },
+        );
+
+        onResult({
+          path: result.uri,
+          base64: result.base64,
+        });
+        return;
+      }
+
+      if (isImageRotateAvailable && ImageRotate?.rotateImage) {
+        const sourceUri = ensureFileUri(croppedImageData.path);
+        const rotatedUri = await rotateImageWithFallback(sourceUri, rotationNormalized);
+
+        let finalPath = croppedImageData.path;
+        let base64Result: string | undefined = croppedImageData.base64;
+
+        try {
+          const base64FromStore = await getBase64FromImageStore(rotatedUri);
+          const destinationPath = `${RNFS.CachesDirectoryPath}/full-doc-scanner-rotated-${Date.now()}-${Math.floor(Math.random() * 10000)}.jpg`;
+
+          await RNFS.writeFile(destinationPath, base64FromStore, 'base64');
+          finalPath = destinationPath;
+          base64Result = base64FromStore;
+        } catch (readError) {
+          console.warn('[FullDocScanner] Failed to persist rotated image from ImageStore:', readError);
+        }
 
-      // 회전된 이미지로 결과 전달
+        onResult({
+          path: finalPath,
+          base64: base64Result,
+        });
+        return;
+      }
+
+      console.warn(
+        '[FullDocScanner] Rotation requested but no supported rotation module is available. Returning original image.',
+      );
       onResult({
-        path: result.uri,
-        base64: result.base64,
+        path: croppedImageData.path,
+        base64: croppedImageData.base64,
       });
     } catch (error) {
       console.error('[FullDocScanner] Image rotation error on confirm:', error);
@@ -552,7 +662,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
     } finally {
       setProcessing(false);
     }
-  }, [croppedImageData, rotationDegrees, onResult]);
+  }, [croppedImageData, rotationDegrees, onResult, rotateImageWithFallback]);
 
   const handleRetake = useCallback(() => {
     console.log('[FullDocScanner] Retake - clearing cropped image and resetting scanner');