@sagepilot-ai/react-native-sdk 0.2.1 → 0.2.3

package/README.md

@@ -38,7 +38,7 @@ You configure the SDK with:
 - `tokenStorage`: secure storage adapter for SDK-created customer session tokens
 - optional request, presentation, and behavior settings
 
-For normal Sagepilot cloud usage, omit `host`; API calls and the WebView default to `https://app.sagepilot.ai`.
+For standard Sagepilot cloud usage, omit `host`. The SDK connects to Sagepilot's hosted endpoints automatically. Set `host` only when Sagepilot provides a dedicated endpoint for your workspace.
 
 ```ts
 await SagepilotChat.configure({
@@ -46,7 +46,7 @@ await SagepilotChat.configure({
 });
 ```
 
-If your workspace uses a dedicated host:
+If Sagepilot provides a dedicated endpoint for your workspace, pass it as an optional override:
 
 ```ts
 await SagepilotChat.configure({
@@ -64,8 +64,8 @@ These options are part of the supported React Native SDK configuration contract.
 | Option | Purpose |
 |---|---|
 | `key` | Public routing key in the format `workspace_id:channel_id`. |
-| `host` | Sagepilot app/API host override. Most apps should omit this. |
-| `widgetHost` | Optional hosted widget origin override for development or dedicated widget routing. Most apps should omit this. |
+| `host` | Optional Sagepilot host override. Most apps should omit this unless Sagepilot provides a dedicated endpoint. |
+| `widgetHost` | Optional hosted widget origin override. Use only when Sagepilot provides a separate widget endpoint. |
 | `headers` | Additional headers for SDK service requests. Do not pass server API keys or long-lived secrets from a mobile app. |
 | `fetch` | Custom fetch implementation for runtimes that need one. |
 | `tokenStorage` | Secure storage adapter for SDK-created customer session tokens. |
@@ -83,7 +83,7 @@ These options are part of the supported React Native SDK configuration contract.
 | `behavior.enableUnreadPolling` | Starts or disables automatic unread-count polling after configuration. |
 | `behavior.unreadPollIntervalMs` | Sets the unread polling interval in milliseconds. |
 
-`SagepilotChatProvider` renders the Sagepilot-hosted chat UI in a React Native WebView. Most Sagepilot cloud apps do not need any host override.
+`SagepilotChatProvider` renders the Sagepilot-hosted chat UI in a React Native WebView. Most apps do not need any host override.
 
 ### Chat Launcher Theme
 
@@ -312,8 +312,13 @@ Other open helpers:
 SagepilotChat.present();
 SagepilotChat.presentMessages();
 SagepilotChat.presentMessageComposer("I need help with my order");
+SagepilotChat.presentMessageComposer("Start a new request", { mode: "new" });
 ```
 
+`presentMessageComposer(message)` pre-fills the composer and lets Sagepilot reuse an existing conversation when one is available. If there is no existing conversation, Sagepilot starts a new one when the customer sends the message.
+
+Use `{ mode: "new" }` only when the button or workflow should always start a fresh conversation.
+
 ## Identity
 
 Call `identify()` when you know the signed-in app user.
@@ -375,7 +380,7 @@ await SagepilotChat.destroy();
 
 - `SagepilotChat.present()`: opens the hosted chat home screen.
 - `SagepilotChat.presentMessages()`: opens the hosted conversations/messages screen.
-- `SagepilotChat.presentMessageComposer(message?)`: opens a fresh message composer and optionally pre-fills the composer text. It does not auto-send.
+- `SagepilotChat.presentMessageComposer(message?, options?)`: opens the message composer and optionally pre-fills the composer text. By default, Sagepilot reuses an existing conversation when one is available. Pass `{ mode: "new" }` to force a fresh conversation. It does not auto-send.
 - `SagepilotChat.dismiss()`: closes the hosted chat modal.
 - `SagepilotChat.hide()`: alias for `dismiss()`.
 - `SagepilotChat.toggle()`: opens the chat when closed and closes it when open.

package/android/build.gradle

@@ -0,0 +1,53 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+}
+
+plugins {
+  id "com.android.library"
+}
+
+def isNewArchitectureEnabled() {
+  return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
+}
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def safeExtGet(prop, fallback) {
+  return rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+android {
+  namespace "ai.sagepilot.reactnativesdk"
+  compileSdkVersion safeExtGet("compileSdkVersion", 35)
+
+  defaultConfig {
+    minSdkVersion safeExtGet("minSdkVersion", 24)
+    targetSdkVersion safeExtGet("targetSdkVersion", 35)
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  sourceSets.main {
+    java {
+      if (isNewArchitectureEnabled()) {
+        srcDirs += "${project.buildDir}/generated/source/codegen/java"
+      } else {
+        srcDirs += "src/paper/java"
+      }
+    }
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "androidx.core:core:1.13.1"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/ai/sagepilot/reactnativesdk/SagepilotInsetsChangeEvent.java

@@ -0,0 +1,26 @@
+package ai.sagepilot.reactnativesdk;
+
+import androidx.annotation.Nullable;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.uimanager.events.Event;
+
+public class SagepilotInsetsChangeEvent extends Event<SagepilotInsetsChangeEvent> {
+  public static final String EVENT_NAME = "topInsetsChange";
+  private final WritableMap eventData;
+
+  public SagepilotInsetsChangeEvent(int surfaceId, int viewTag, WritableMap eventData) {
+    super(surfaceId, viewTag);
+    this.eventData = eventData;
+  }
+
+  @Override
+  public String getEventName() {
+    return EVENT_NAME;
+  }
+
+  @Nullable
+  @Override
+  protected WritableMap getEventData() {
+    return eventData;
+  }
+}

package/android/src/main/java/ai/sagepilot/reactnativesdk/SagepilotInsetsView.java

@@ -0,0 +1,78 @@
+package ai.sagepilot.reactnativesdk;
+
+import android.content.Context;
+import android.view.View;
+import android.widget.FrameLayout;
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.ReactContext;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.uimanager.PixelUtil;
+import com.facebook.react.uimanager.UIManagerHelper;
+import com.facebook.react.uimanager.events.EventDispatcher;
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+
+public class SagepilotInsetsView extends FrameLayout {
+  private int appliedTopInset;
+  private int appliedBottomInset;
+
+  public SagepilotInsetsView(Context context) {
+    super(context);
+    installInsetsListener();
+  }
+
+  @Override
+  protected void onAttachedToWindow() {
+    super.onAttachedToWindow();
+    ViewCompat.requestApplyInsets(this);
+  }
+
+  private void installInsetsListener() {
+    ViewCompat.setOnApplyWindowInsetsListener(this, (view, windowInsets) -> {
+      Insets imeInsets = windowInsets.getInsets(WindowInsetsCompat.Type.ime());
+      Insets systemBarInsets = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars());
+      int topInset = systemBarInsets.top;
+      int bottomInset = Math.max(imeInsets.bottom, systemBarInsets.bottom);
+      updateInsets(topInset, bottomInset, imeInsets.bottom, systemBarInsets.bottom);
+      return WindowInsetsCompat.CONSUMED;
+    });
+  }
+
+  private void updateInsets(int topInset, int bottomInset, int imeBottom, int systemBarsBottom) {
+    int nextTopInset = Math.max(0, topInset);
+    int nextBottomInset = Math.max(0, bottomInset);
+    if (nextTopInset == appliedTopInset && nextBottomInset == appliedBottomInset) {
+      return;
+    }
+
+    appliedTopInset = nextTopInset;
+    appliedBottomInset = nextBottomInset;
+    emitInsetsChange(nextTopInset, nextBottomInset, Math.max(0, imeBottom), Math.max(0, systemBarsBottom));
+  }
+
+  private void emitInsetsChange(int topInset, int bottomInset, int imeBottom, int systemBarsBottom) {
+    if (getId() == View.NO_ID || !(getContext() instanceof ReactContext)) {
+      return;
+    }
+
+    WritableMap event = Arguments.createMap();
+    event.putDouble("top", PixelUtil.toDIPFromPixel(topInset));
+    event.putDouble("bottom", PixelUtil.toDIPFromPixel(bottomInset));
+    event.putDouble("imeBottom", PixelUtil.toDIPFromPixel(imeBottom));
+    event.putDouble("systemBarsBottom", PixelUtil.toDIPFromPixel(systemBarsBottom));
+    event.putBoolean("keyboardVisible", imeBottom > systemBarsBottom);
+
+    ReactContext reactContext = (ReactContext) getContext();
+    EventDispatcher eventDispatcher = UIManagerHelper.getEventDispatcherForReactTag(reactContext, getId());
+    if (eventDispatcher == null) {
+      return;
+    }
+
+    eventDispatcher.dispatchEvent(new SagepilotInsetsChangeEvent(
+      UIManagerHelper.getSurfaceId(this),
+      getId(),
+      event
+    ));
+  }
+}

package/android/src/main/java/ai/sagepilot/reactnativesdk/SagepilotInsetsViewManager.java

@@ -0,0 +1,59 @@
+package ai.sagepilot.reactnativesdk;
+
+import android.view.View;
+import com.facebook.react.common.MapBuilder;
+import com.facebook.react.uimanager.ViewManagerDelegate;
+import com.facebook.react.uimanager.ThemedReactContext;
+import com.facebook.react.uimanager.ViewGroupManager;
+import com.facebook.react.viewmanagers.SagepilotInsetsViewManagerDelegate;
+import com.facebook.react.viewmanagers.SagepilotInsetsViewManagerInterface;
+import java.util.Map;
+
+public class SagepilotInsetsViewManager extends ViewGroupManager<SagepilotInsetsView>
+  implements SagepilotInsetsViewManagerInterface<SagepilotInsetsView> {
+  public static final String REACT_CLASS = "SagepilotInsetsView";
+  private final ViewManagerDelegate<SagepilotInsetsView> delegate = new SagepilotInsetsViewManagerDelegate<>(this);
+
+  @Override
+  protected ViewManagerDelegate<SagepilotInsetsView> getDelegate() {
+    return delegate;
+  }
+
+  @Override
+  public String getName() {
+    return REACT_CLASS;
+  }
+
+  @Override
+  public Map<String, Object> getExportedCustomDirectEventTypeConstants() {
+    return MapBuilder.of(
+      SagepilotInsetsChangeEvent.EVENT_NAME,
+      MapBuilder.of("registrationName", "onInsetsChange")
+    );
+  }
+
+  @Override
+  protected SagepilotInsetsView createViewInstance(ThemedReactContext reactContext) {
+    return new SagepilotInsetsView(reactContext);
+  }
+
+  @Override
+  public void addView(SagepilotInsetsView parent, View child, int index) {
+    parent.addView(child, index);
+  }
+
+  @Override
+  public int getChildCount(SagepilotInsetsView parent) {
+    return parent.getChildCount();
+  }
+
+  @Override
+  public View getChildAt(SagepilotInsetsView parent, int index) {
+    return parent.getChildAt(index);
+  }
+
+  @Override
+  public void removeViewAt(SagepilotInsetsView parent, int index) {
+    parent.removeViewAt(index);
+  }
+}

package/android/src/main/java/ai/sagepilot/reactnativesdk/SagepilotReactNativeSdkPackage.java

@@ -0,0 +1,20 @@
+package ai.sagepilot.reactnativesdk;
+
+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 SagepilotReactNativeSdkPackage implements ReactPackage {
+  @Override
+  public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
+    return Collections.emptyList();
+  }
+
+  @Override
+  public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
+    return Collections.singletonList(new SagepilotInsetsViewManager());
+  }
+}

package/android/src/paper/java/com/facebook/react/viewmanagers/SagepilotInsetsViewManagerDelegate.java

@@ -0,0 +1,25 @@
+/**
+ * This code mirrors react-native-codegen output so Paper builds can compile when codegen is off.
+ */
+package com.facebook.react.viewmanagers;
+
+import android.view.View;
+import androidx.annotation.Nullable;
+import com.facebook.react.uimanager.BaseViewManager;
+import com.facebook.react.uimanager.BaseViewManagerDelegate;
+import com.facebook.react.uimanager.LayoutShadowNode;
+
+public class SagepilotInsetsViewManagerDelegate<
+        T extends View,
+        U extends
+            BaseViewManager<T, ? extends LayoutShadowNode> & SagepilotInsetsViewManagerInterface<T>>
+    extends BaseViewManagerDelegate<T, U> {
+  public SagepilotInsetsViewManagerDelegate(U viewManager) {
+    super(viewManager);
+  }
+
+  @Override
+  public void setProperty(T view, String propName, @Nullable Object value) {
+    super.setProperty(view, propName, value);
+  }
+}

package/android/src/paper/java/com/facebook/react/viewmanagers/SagepilotInsetsViewManagerInterface.java

@@ -0,0 +1,10 @@
+/**
+ * This code mirrors react-native-codegen output so Paper builds can compile when codegen is off.
+ */
+package com.facebook.react.viewmanagers;
+
+import android.view.View;
+
+public interface SagepilotInsetsViewManagerInterface<T extends View> {
+  // No props
+}

package/dist/{index.d.cts → index.d.mts}

@@ -216,6 +216,15 @@ type SagepilotMobileState = SagepilotLifecycleState & {
     theme: SagepilotMobileThemeState;
 };
 type SagepilotMobileSubscription = () => void;
+type SagepilotMessageComposerMode = "auto" | "new";
+type SagepilotMessageComposerOptions = {
+    /**
+     * auto: prefill the composer and let the hosted widget reuse an existing
+     * conversation when one is available.
+     * new: force the hosted widget to start a fresh conversation.
+     */
+    mode?: SagepilotMessageComposerMode;
+};
 type SagepilotChatHookState = {
     configured: boolean;
     isPresented: boolean;
@@ -224,7 +233,7 @@ type SagepilotChatHookState = {
     theme: SagepilotMobileThemeState;
     present: () => boolean;
     presentMessages: () => boolean;
-    presentMessageComposer: (message?: string) => boolean;
+    presentMessageComposer: (message?: string, options?: SagepilotMessageComposerOptions) => boolean;
     dismiss: () => boolean;
     hide: () => boolean;
     toggle: () => boolean;
@@ -256,7 +265,7 @@ declare const SagepilotChat: {
     stopUnreadPolling: () => void;
     present: () => boolean;
     presentMessages: () => boolean;
-    presentMessageComposer: (message?: string) => boolean;
+    presentMessageComposer: (message?: string, options?: SagepilotMessageComposerOptions) => boolean;
     dismiss: () => boolean;
     hide: () => boolean;
     toggle: () => boolean;

package/dist/index.d.ts

@@ -216,6 +216,15 @@ type SagepilotMobileState = SagepilotLifecycleState & {
     theme: SagepilotMobileThemeState;
 };
 type SagepilotMobileSubscription = () => void;
+type SagepilotMessageComposerMode = "auto" | "new";
+type SagepilotMessageComposerOptions = {
+    /**
+     * auto: prefill the composer and let the hosted widget reuse an existing
+     * conversation when one is available.
+     * new: force the hosted widget to start a fresh conversation.
+     */
+    mode?: SagepilotMessageComposerMode;
+};
 type SagepilotChatHookState = {
     configured: boolean;
     isPresented: boolean;
@@ -224,7 +233,7 @@ type SagepilotChatHookState = {
     theme: SagepilotMobileThemeState;
     present: () => boolean;
     presentMessages: () => boolean;
-    presentMessageComposer: (message?: string) => boolean;
+    presentMessageComposer: (message?: string, options?: SagepilotMessageComposerOptions) => boolean;
     dismiss: () => boolean;
     hide: () => boolean;
     toggle: () => boolean;
@@ -256,7 +265,7 @@ declare const SagepilotChat: {
     stopUnreadPolling: () => void;
     present: () => boolean;
     presentMessages: () => boolean;
-    presentMessageComposer: (message?: string) => boolean;
+    presentMessageComposer: (message?: string, options?: SagepilotMessageComposerOptions) => boolean;
     dismiss: () => boolean;
     hide: () => boolean;
     toggle: () => boolean;