@sagepilot-ai/react-native-camera-addon 0.3.0

package/android/src/main/java/ai/sagepilot/reactnativecameraaddon/SagepilotInAppCameraResultStore.java

@@ -0,0 +1,135 @@
+package ai.sagepilot.reactnativecameraaddon;
+
+import android.content.Context;
+import android.util.Log;
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+
+final class SagepilotInAppCameraResultStore {
+  private static final String TAG = "SagepilotInAppCamera";
+  private static final String RESULT_DIRECTORY_NAME = "sagepilot-camera-results";
+  private static final String RESULT_FILE_EXTENSION = ".b64";
+  private static final int BUFFER_SIZE = 8192;
+
+  private static final ConcurrentHashMap<String, PickedImage> RESULTS = new ConcurrentHashMap<>();
+
+  /** Prevents construction of the static camera result store. */
+  private SagepilotInAppCameraResultStore() {}
+
+  /** Stores one captured image payload and returns a small result id for Activity result transport. */
+  static String put(Context context, PickedImage image) {
+    String resultId = UUID.randomUUID().toString();
+    RESULTS.put(resultId, image);
+    writeResultFile(context, resultId, image.dataBase64);
+    return resultId;
+  }
+
+  /** Takes and removes one captured image payload by result id. */
+  static PickedImage take(
+    Context context,
+    String resultId,
+    String fallbackFileName,
+    String fallbackMimeType,
+    long fallbackSizeBytes
+  ) {
+    if (resultId == null || resultId.length() == 0) {
+      return null;
+    }
+    PickedImage image = RESULTS.remove(resultId);
+    if (image != null) {
+      deleteResultFile(context, resultId);
+      return image;
+    }
+
+    String dataBase64 = readResultFile(context, resultId);
+    deleteResultFile(context, resultId);
+    if (dataBase64 == null || dataBase64.length() == 0) {
+      return null;
+    }
+    return new PickedImage(fallbackFileName, fallbackMimeType, fallbackSizeBytes, dataBase64);
+  }
+
+  /** Writes a durable base64 payload copy for process-death recovery between result creation and JS delivery. */
+  private static void writeResultFile(Context context, String resultId, String dataBase64) {
+    if (context == null || dataBase64 == null || dataBase64.length() == 0) {
+      return;
+    }
+    File resultFile = getResultFile(context, resultId);
+    File directory = resultFile.getParentFile();
+    if (directory == null) {
+      return;
+    }
+    try {
+      if (!directory.exists() && !directory.mkdirs()) {
+        Log.w(TAG, "Could not create camera result directory.");
+        return;
+      }
+      try (FileOutputStream outputStream = new FileOutputStream(resultFile)) {
+        outputStream.write(dataBase64.getBytes(StandardCharsets.UTF_8));
+        outputStream.flush();
+      }
+    } catch (IOException | RuntimeException error) {
+      Log.w(TAG, "Could not persist camera result payload.", error);
+    }
+  }
+
+  /** Reads a previously-persisted base64 result payload. */
+  private static String readResultFile(Context context, String resultId) {
+    if (context == null) {
+      return null;
+    }
+    File resultFile = getResultFile(context, resultId);
+    if (!resultFile.exists() || !resultFile.isFile()) {
+      return null;
+    }
+    try (FileInputStream inputStream = new FileInputStream(resultFile);
+         ByteArrayOutputStream outputStream = new ByteArrayOutputStream()) {
+      byte[] buffer = new byte[BUFFER_SIZE];
+      int bytesRead;
+      while ((bytesRead = inputStream.read(buffer)) != -1) {
+        outputStream.write(buffer, 0, bytesRead);
+      }
+      return outputStream.toString(StandardCharsets.UTF_8.name());
+    } catch (IOException | RuntimeException error) {
+      Log.w(TAG, "Could not read persisted camera result payload.", error);
+      return null;
+    }
+  }
+
+  /** Deletes a persisted result payload after it is consumed or superseded by the static store. */
+  private static void deleteResultFile(Context context, String resultId) {
+    if (context == null) {
+      return;
+    }
+    File resultFile = getResultFile(context, resultId);
+    if (resultFile.exists() && !resultFile.delete()) {
+      Log.w(TAG, "Could not delete camera result payload.");
+    }
+  }
+
+  /** Returns the durable result payload path for a result id. */
+  private static File getResultFile(Context context, String resultId) {
+    return new File(new File(context.getCacheDir(), RESULT_DIRECTORY_NAME), resultId + RESULT_FILE_EXTENSION);
+  }
+
+  static final class PickedImage {
+    final String fileName;
+    final String mimeType;
+    final long sizeBytes;
+    final String dataBase64;
+
+    /** Holds the bridge-ready camera payload without putting it into the result Intent. */
+    PickedImage(String fileName, String mimeType, long sizeBytes, String dataBase64) {
+      this.fileName = fileName;
+      this.mimeType = mimeType;
+      this.sizeBytes = sizeBytes;
+      this.dataBase64 = dataBase64;
+    }
+  }
+}

package/android/src/main/java/ai/sagepilot/reactnativecameraaddon/SagepilotReactNativeCameraAddonPackage.java

@@ -0,0 +1,22 @@
+package ai.sagepilot.reactnativecameraaddon;
+
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+import java.util.Collections;
+import java.util.List;
+
+public class SagepilotReactNativeCameraAddonPackage implements ReactPackage {
+  /** Registers the optional CameraX native module exposed to JavaScript. */
+  @Override
+  public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
+    return Collections.singletonList(new SagepilotInAppCameraModule(reactContext));
+  }
+
+  /** The CameraX addon does not register React Native view managers. */
+  @Override
+  public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
+    return Collections.emptyList();
+  }
+}

package/android/src/main/res/drawable/sagepilot_ic_check.xml

@@ -0,0 +1,12 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+  android:width="24dp"
+  android:height="24dp"
+  android:viewportWidth="24"
+  android:viewportHeight="24">
+  <path
+    android:pathData="M20,6 L9,17 L4,12"
+    android:strokeColor="#FF111827"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+</vector>

package/android/src/main/res/drawable/sagepilot_ic_rotate_ccw.xml

@@ -0,0 +1,18 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+  android:width="24dp"
+  android:height="24dp"
+  android:viewportWidth="24"
+  android:viewportHeight="24">
+  <path
+    android:pathData="M3,12 A9,9 0,1 0,12,3 Q8.1,3 5.26,5.74 L3,8"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+  <path
+    android:pathData="M3,3 L3,8 L8,8"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+</vector>

package/android/src/main/res/drawable/sagepilot_ic_switch_camera.xml

@@ -0,0 +1,36 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+  android:width="24dp"
+  android:height="24dp"
+  android:viewportWidth="24"
+  android:viewportHeight="24">
+  <path
+    android:pathData="M11,19 L4,19 Q2,19 2,17 L2,7 Q2,5 4,5 L9,5"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+  <path
+    android:pathData="M13,5 L20,5 Q22,5 22,7 L22,17 Q22,19 20,19 L15,19"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+  <path
+    android:pathData="M12,9 A3,3 0,1 0,12,15 A3,3 0,1 0,12,9"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+  <path
+    android:pathData="M18,22 L15,19 L18,16"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+  <path
+    android:pathData="M6,2 L9,5 L6,8"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+</vector>

package/android/src/main/res/drawable/sagepilot_ic_x.xml

@@ -0,0 +1,18 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+  android:width="24dp"
+  android:height="24dp"
+  android:viewportWidth="24"
+  android:viewportHeight="24">
+  <path
+    android:pathData="M18,6 L6,18"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+  <path
+    android:pathData="M6,6 L18,18"
+    android:strokeColor="#FFFFFFFF"
+    android:strokeWidth="2"
+    android:strokeLineCap="round"
+    android:strokeLineJoin="round" />
+</vector>

package/android/src/main/res/values/styles.xml

@@ -0,0 +1,7 @@
+<resources>
+  <style name="SagepilotInAppCameraTheme" parent="@android:style/Theme.Material.NoActionBar">
+    <item name="android:windowNoTitle">true</item>
+    <item name="android:windowActionBar">false</item>
+    <item name="android:windowFullscreen">true</item>
+  </style>
+</resources>

package/dist/index.d.mts

@@ -0,0 +1,67 @@
+import { SagepilotPickedFile, SagepilotFilePickerAdapter } from '@sagepilot-ai/react-native-sdk';
+
+type SagepilotNativeCameraOptions = {
+    /** Longest image edge in pixels after native processing. */
+    imageMaxDimension?: number;
+    /** JPEG quality from 0 to 1 after native processing. */
+    imageQuality?: number;
+    /** Reject the processed image when it exceeds this size in bytes. */
+    imageMaxFileSizeBytes?: number;
+};
+type SagepilotNativeCameraModule = {
+    openCamera: (options: Required<SagepilotNativeCameraOptions>) => Promise<SagepilotPickedFile | null>;
+    openImageLibrary?: (options: {
+        multiple: boolean;
+        imageMaxFileSizeBytes: number;
+    }) => Promise<SagepilotPickedFile[] | null>;
+    openDocumentPicker?: (options: {
+        multiple: boolean;
+        documentMaxFileSizeBytes: number;
+    }) => Promise<SagepilotPickedFile[] | null>;
+    moduleCapabilitiesVersion?: number;
+    supportsInAppCamera?: boolean;
+    supportsImageLibrary?: boolean;
+    supportsDocumentPicker?: boolean;
+    addListener?: (eventName: string) => void;
+    removeListeners?: (count: number) => void;
+};
+type SagepilotNativeCameraCapabilities = {
+    moduleCapabilitiesVersion: number;
+    requiredModuleCapabilitiesVersion: number;
+    supportsInAppCamera: boolean;
+    supportsImageLibrary: boolean;
+    supportsDocumentPicker: boolean;
+    staleNativeModule: boolean;
+};
+/**
+ * Checks whether the SDK in-app camera native module is registered.
+ * Android registers this module in the current release; iOS can add a
+ * compatible module later without changing the JS contract.
+ */
+declare function isSagepilotNativeCameraAvailable(): boolean;
+/** Reads native picker capability constants from the installed Android module. */
+declare function getSagepilotNativeCameraCapabilities(): SagepilotNativeCameraCapabilities;
+/**
+ * Opens the SDK-owned native in-app camera module and returns adapter shape.
+ * User cancellation maps to an empty array.
+ */
+declare function pickSagepilotCameraFiles(options?: SagepilotNativeCameraOptions): Promise<SagepilotPickedFile[]>;
+
+type SagepilotCameraXFilePickerOptions = SagepilotNativeCameraOptions & {
+    /** Include the CameraX camera source when the Android native module is registered. */
+    includeCamera?: boolean;
+    /** Include Android photo-library picking from the CameraX addon native module. */
+    includeLibrary?: boolean;
+    /** Include Android document picking from the CameraX addon native module. */
+    includeDocuments?: boolean;
+    /** Reject documents larger than this size before reading them into memory. */
+    documentMaxFileSizeBytes?: number;
+};
+/**
+ * Builds the optional Android CameraX file-picker adapter.
+ * Returns undefined on non-Android platforms or when the addon native module is
+ * not linked into the host app.
+ */
+declare function createSagepilotCameraXFilePicker(options?: SagepilotCameraXFilePickerOptions): SagepilotFilePickerAdapter | undefined;
+
+export { type SagepilotCameraXFilePickerOptions, type SagepilotNativeCameraCapabilities, type SagepilotNativeCameraModule, type SagepilotNativeCameraOptions, createSagepilotCameraXFilePicker, getSagepilotNativeCameraCapabilities, isSagepilotNativeCameraAvailable, pickSagepilotCameraFiles };

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+import { SagepilotPickedFile, SagepilotFilePickerAdapter } from '@sagepilot-ai/react-native-sdk';
+
+type SagepilotNativeCameraOptions = {
+    /** Longest image edge in pixels after native processing. */
+    imageMaxDimension?: number;
+    /** JPEG quality from 0 to 1 after native processing. */
+    imageQuality?: number;
+    /** Reject the processed image when it exceeds this size in bytes. */
+    imageMaxFileSizeBytes?: number;
+};
+type SagepilotNativeCameraModule = {
+    openCamera: (options: Required<SagepilotNativeCameraOptions>) => Promise<SagepilotPickedFile | null>;
+    openImageLibrary?: (options: {
+        multiple: boolean;
+        imageMaxFileSizeBytes: number;
+    }) => Promise<SagepilotPickedFile[] | null>;
+    openDocumentPicker?: (options: {
+        multiple: boolean;
+        documentMaxFileSizeBytes: number;
+    }) => Promise<SagepilotPickedFile[] | null>;
+    moduleCapabilitiesVersion?: number;
+    supportsInAppCamera?: boolean;
+    supportsImageLibrary?: boolean;
+    supportsDocumentPicker?: boolean;
+    addListener?: (eventName: string) => void;
+    removeListeners?: (count: number) => void;
+};
+type SagepilotNativeCameraCapabilities = {
+    moduleCapabilitiesVersion: number;
+    requiredModuleCapabilitiesVersion: number;
+    supportsInAppCamera: boolean;
+    supportsImageLibrary: boolean;
+    supportsDocumentPicker: boolean;
+    staleNativeModule: boolean;
+};
+/**
+ * Checks whether the SDK in-app camera native module is registered.
+ * Android registers this module in the current release; iOS can add a
+ * compatible module later without changing the JS contract.
+ */
+declare function isSagepilotNativeCameraAvailable(): boolean;
+/** Reads native picker capability constants from the installed Android module. */
+declare function getSagepilotNativeCameraCapabilities(): SagepilotNativeCameraCapabilities;
+/**
+ * Opens the SDK-owned native in-app camera module and returns adapter shape.
+ * User cancellation maps to an empty array.
+ */
+declare function pickSagepilotCameraFiles(options?: SagepilotNativeCameraOptions): Promise<SagepilotPickedFile[]>;
+
+type SagepilotCameraXFilePickerOptions = SagepilotNativeCameraOptions & {
+    /** Include the CameraX camera source when the Android native module is registered. */
+    includeCamera?: boolean;
+    /** Include Android photo-library picking from the CameraX addon native module. */
+    includeLibrary?: boolean;
+    /** Include Android document picking from the CameraX addon native module. */
+    includeDocuments?: boolean;
+    /** Reject documents larger than this size before reading them into memory. */
+    documentMaxFileSizeBytes?: number;
+};
+/**
+ * Builds the optional Android CameraX file-picker adapter.
+ * Returns undefined on non-Android platforms or when the addon native module is
+ * not linked into the host app.
+ */
+declare function createSagepilotCameraXFilePicker(options?: SagepilotCameraXFilePickerOptions): SagepilotFilePickerAdapter | undefined;
+
+export { type SagepilotCameraXFilePickerOptions, type SagepilotNativeCameraCapabilities, type SagepilotNativeCameraModule, type SagepilotNativeCameraOptions, createSagepilotCameraXFilePicker, getSagepilotNativeCameraCapabilities, isSagepilotNativeCameraAvailable, pickSagepilotCameraFiles };