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

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sagepilot AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# `@sagepilot-ai/react-native-camera-addon`
+
+Optional Android CameraX attachment picker for `@sagepilot-ai/react-native-sdk`.
+
+Install this package only when you want Sagepilot to provide an in-app Android CameraX picker. Apps that do not install it can keep the smaller base SDK install.
+
+This is not a replacement SDK. Your app always installs and configures `@sagepilot-ai/react-native-sdk` first, then adds this package only when it wants the optional CameraX picker.
+
+## Install Flow
+
+Install the base SDK and WebView:
+
+```bash
+npm install @sagepilot-ai/react-native-sdk react-native-webview
+```
+
+Then install the CameraX addon:
+
+```bash
+npm install @sagepilot-ai/react-native-camera-addon
+```
+
+If your app already has the base SDK installed, run only the addon install command.
+
+After adding this package, run a clean native Android rebuild. A Metro reload is not enough because React Native autolinking registers the new native module only during the native build:
+
+```bash
+cd android && ./gradlew clean
+cd .. && npx react-native run-android
+```
+
+Expo apps should run a fresh native build, for example:
+
+```bash
+npx expo run:android
+```
+
+On device, verify the adapter log includes the native sources:
+
+```text
+[SagepilotSDK][CameraXAddon] adapter created ... sources:["camera","library","documents"]
+```
+
+If the app was only Metro-reloaded after installing the addon, `NativeModules.SagepilotInAppCamera` is not registered yet. In that state `createSagepilotCameraXFilePicker()` returns `undefined`, the base SDK receives no `filePicker`, and the widget falls back to the WebView file input.
+
+## Configure
+
+```ts
+import { SagepilotChat } from "@sagepilot-ai/react-native-sdk";
+import { createSagepilotCameraXFilePicker } from "@sagepilot-ai/react-native-camera-addon";
+
+await SagepilotChat.configure({
+  key: "workspace_id:channel_id",
+  filePicker: createSagepilotCameraXFilePicker()
+});
+```
+
+Mount `SagepilotChatProvider` from the base SDK once near the top of your app. The addon only supplies the `filePicker` adapter used by `SagepilotChat.configure`.
+
+`createSagepilotCameraXFilePicker()` returns `undefined` outside Android, so cross-platform apps can call it from shared configuration code. On Android it exposes the CameraX camera source plus the addon native module's photo-library and document sources when they are linked in the host app.
+
+iOS does not use this Android addon. If you pass `createSagepilotCameraXFilePicker()` from shared setup code on iOS, it returns `undefined` and the hosted widget uses WKWebView's native file input sheet unless your app provides a separate iOS picker through the base SDK.
+
+## Options
+
+```ts
+createSagepilotCameraXFilePicker({
+  imageMaxDimension: 1920,
+  imageQuality: 0.8,
+  imageMaxFileSizeBytes: 15 * 1024 * 1024,
+  documentMaxFileSizeBytes: 20 * 1024 * 1024,
+  includeLibrary: true,
+  includeDocuments: true
+});
+```

package/android/build.gradle

@@ -0,0 +1,45 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.5.0"
+  }
+}
+
+apply plugin: "com.android.library"
+
+def safeExtGet(prop, fallback) {
+  return rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+def cameraXVersion = safeExtGet("sagepilotCameraXVersion", "1.5.3")
+def exifInterfaceVersion = safeExtGet("sagepilotExifInterfaceVersion", "1.4.2")
+def activityVersion = safeExtGet("sagepilotActivityVersion", "1.10.1")
+
+android {
+  namespace "ai.sagepilot.reactnativecameraaddon"
+  compileSdkVersion safeExtGet("compileSdkVersion", 35)
+
+  defaultConfig {
+    minSdkVersion safeExtGet("minSdkVersion", 24)
+    targetSdkVersion safeExtGet("targetSdkVersion", 35)
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "androidx.core:core:1.13.1"
+  implementation "androidx.activity:activity:${activityVersion}"
+  implementation "androidx.camera:camera-core:${cameraXVersion}"
+  implementation "androidx.camera:camera-camera2:${cameraXVersion}"
+  implementation "androidx.camera:camera-lifecycle:${cameraXVersion}"
+  implementation "androidx.camera:camera-view:${cameraXVersion}"
+  implementation "androidx.exifinterface:exifinterface:${exifInterfaceVersion}"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,12 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+  <uses-permission android:name="android.permission.CAMERA" />
+
+  <application>
+    <activity
+      android:name="ai.sagepilot.reactnativecameraaddon.SagepilotInAppCameraActivity"
+      android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|uiMode"
+      android:exported="false"
+      android:theme="@style/SagepilotInAppCameraTheme" />
+  </application>
+</manifest>