react-native-newinstance-chat 0.1.2 → 0.2.0

package/NewinstanceChat.podspec

@@ -18,7 +18,7 @@ Pod::Spec.new do |s|
   s.pod_target_xcconfig = { "DEFINES_MODULE" => "YES" }
 
   # Native chat SDK we wrap, published on CocoaPods Trunk.
-  s.dependency "LiveAndAiChat", "~> 0.1.0"
+  s.dependency "LiveAndAiChat", "~> 0.2.0"
 
   install_modules_dependencies(s)
 end

package/README.md

@@ -86,17 +86,101 @@ unsub();
 ```
 
 Event names: `messageReceived`, `messageSent`, `agentTypingChanged`,
-`connectionStateChanged`, `unreadCountChanged`, `error`. See `src/types.ts`
-for payload shapes.
+`connectionStateChanged`, `unreadCountChanged`, `error`,
+`attachmentUpdated`, `chatClosed`. See `src/types.ts` for payload shapes.
+
+### The chat-close event
+
+`chatClosed` fires **exactly once per chat presentation**, however the
+screen went away: the in-chat close button, Android back navigation
+(button or gesture), an iOS dismissal gesture, `closeChat()`,
+`destroy()` (reason `session_ended`), or the host app navigating the
+screen away. Rerenders and lifecycle churn never produce duplicates.
+
+```ts
+useEffect(() => {
+  const unsub = sdk.addListener('chatClosed', (e) => {
+    // e.reason: 'close_button' | 'back_navigation' | 'gesture' |
+    //           'programmatic' | 'session_ended' | 'host_navigation'
+    // e.initiator: 'user' | 'host' | 'sdk'
+    // plus: timestamp, conversationId, assignmentId, channel,
+    //       previousState, unreadCount, hasDraft,
+    //       pendingAttachmentCount, metadata
+    analytics.track('chat_closed', { reason: e.reason });
+  });
+  return unsub; // always clean up on unmount
+}, []);
+```
+
+Ordering: `chatClosed` is emitted after the SDK has left the open
+state (`unreadCount` and `pendingAttachmentCount` reflect the moment of
+dismissal). The event never contains message contents, credentials, or
+attachment bytes.
 
 ### Sending messages programmatically
 
 ```ts
 sdk.sendMessage('Hi, I have a question.');
-sdk.attachFile({ uri: 'file:///…', name: 'screenshot.png', mimeType: 'image/png' });
 sdk.retryMessage(failedMessageId);
 ```
 
+### Programmatic attachments
+
+`attachFile` accepts base64, data URIs, local file paths,
+`content://` / `file://` URIs (picker outputs), and — when the native
+SDK is configured with `allowRemoteAttachmentUrls` — remote URLs.
+`sourceType: 'auto'` (the default) safely detects string inputs.
+
+```ts
+// Base64 (e.g. from a camera or canvas):
+const id = await sdk.attachFile({
+  source: pngBase64,
+  sourceType: 'base64',
+  name: 'photo.png',
+  mimeType: 'image/png',
+});
+
+// React Native document picker result:
+const [doc] = await pick(); // e.g. @react-native-documents/picker
+await sdk.attachFile({
+  source: doc.uri,          // content:// on Android, file:// on iOS
+  name: doc.name ?? 'document.pdf',
+  mimeType: doc.type ?? 'application/pdf',
+  size: doc.size ?? undefined,
+});
+
+// Data URI:
+await sdk.attachFile({ source: dataUri, name: 'chart.png' });
+```
+
+The returned promise resolves with the attachment **id** as soon as the
+request is accepted and queued. Validation and upload run in the
+background and never block the UI thread — failures surface as
+`attachmentUpdated` with `status: 'failed'` plus an `error` event — and
+the message is never sent until the upload succeeds (send drains only
+uploaded attachments). Track progress and results via
+`attachmentUpdated`:
+
+```ts
+sdk.addListener('attachmentUpdated', (a) => {
+  // a.status: 'queued' | 'uploading' | 'uploaded' | 'failed' | 'cancelled'
+  // a.progress: 0..1 real byte progress
+  if (a.status === 'failed') console.warn(a.error);
+});
+
+sdk.removeAttachment(id); // cancels an in-flight upload
+sdk.clearAttachments();
+```
+
+Validation happens before anything is queued: base64 must decode, URIs
+must be readable, files must be non-empty and at most 25 MB, the MIME
+type must be one of png/jpeg/webp/gif/pdf, a mismatched `size` is
+rejected as corruption, and the extension must agree with the MIME
+type. Attachment contents are never written to logs.
+
+Allowed MIME types and the 25 MB cap mirror the web widget; keys and
+limits are enforced again server-side.
+
 Handoff to a live agent and typing indicators are driven automatically
 by the native chat screen — there's nothing to wire up from the host.
 

package/android/build.gradle

@@ -73,5 +73,5 @@ repositories {
 dependencies {
   implementation "com.facebook.react:react-android"
   // Native chat SDK the bridge wraps. Published under cloud.newinstance.
-  implementation "cloud.newinstance:liveandaichat:0.1.1"
+  implementation "cloud.newinstance:liveandaichat:0.2.0"
 }

package/android/src/main/java/com/newinstancechat/NewinstanceChatModule.kt

@@ -5,8 +5,12 @@ import cloud.newinstance.liveandaichat.LiveAndAiChat
 import cloud.newinstance.liveandaichat.LiveAndAiChatConfig
 import cloud.newinstance.liveandaichat.LiveAndAiChatError
 import cloud.newinstance.liveandaichat.ChatUser
+import cloud.newinstance.liveandaichat.model.AttachmentRequest
+import cloud.newinstance.liveandaichat.model.AttachmentSource
+import cloud.newinstance.liveandaichat.model.ChatCloseEvent
 import cloud.newinstance.liveandaichat.model.ChatMessage
 import cloud.newinstance.liveandaichat.model.TransportMode
+import cloud.newinstance.liveandaichat.upload.QueuedAttachment
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
@@ -124,24 +128,57 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
       promise.reject("E_NOT_CONFIGURED", "configure() must be called first")
       return
     }
-    val uri = opts.getString("uri")
     val name = opts.getString("name")
-    val mimeType = opts.getString("mimeType")
-    if (uri == null || name == null || mimeType == null) {
-      promise.reject("E_ARGS", "uri, name, mimeType are required")
+    if (name.isNullOrBlank()) {
+      promise.reject("E_ARGS", "name is required")
+      return
+    }
+    val sourceValue = opts.getString("source") ?: opts.getString("uri")
+    if (sourceValue.isNullOrBlank()) {
+      promise.reject("E_ARGS", "source (or legacy uri) is required")
+      return
+    }
+    val sourceType = opts.getString("sourceType") ?: "auto"
+    val source = AttachmentSource.fromTypeName(sourceType, sourceValue)
+    if (source == null) {
+      promise.reject(
+        "E_SOURCE",
+        if (sourceType == "auto") "Could not detect the attachment source type — pass sourceType explicitly"
+        else "Unknown sourceType: $sourceType",
+      )
       return
     }
+    val mimeType = opts.getString("mimeType")
+    val declaredSize = if (opts.hasKey("size") && !opts.isNull("size")) opts.getDouble("size").toLong() else null
+    val metadata = mutableMapOf<String, String>()
+    if (opts.hasKey("metadata") && !opts.isNull("metadata")) {
+      val map = opts.getMap("metadata")
+      map?.entryIterator?.forEach { (key, value) -> metadata[key] = value.toString() }
+    }
     try {
-      val bytes = reactApplicationContext.contentResolver
-        .openInputStream(android.net.Uri.parse(uri))?.use { it.readBytes() }
-        ?: throw java.io.IOException("Could not open content URI: $uri")
-      current.attachFile(bytes, name, mimeType, uri)
-      promise.resolve(null)
+      val id = current.attach(
+        AttachmentRequest(
+          source = source,
+          name = name,
+          mimeType = mimeType,
+          declaredSize = declaredSize,
+          metadata = metadata,
+        ),
+      )
+      promise.resolve(id)
     } catch (e: Exception) {
-      promise.reject("E_READ", e.message, e)
+      promise.reject("E_ATTACH", e.message, e)
     }
   }
 
+  override fun removeAttachment(id: String) {
+    sdk?.removeAttachment(id)
+  }
+
+  override fun clearAttachments() {
+    sdk?.clearAttachments()
+  }
+
   override fun destroy() {
     sdk?.destroy()
     sdk = null
@@ -170,6 +207,37 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
   override fun onUnreadCountChange(count: Int) {
     emit("unreadCountChanged", count)
   }
+  override fun onAttachmentUpdate(attachment: QueuedAttachment) {
+    val map = Arguments.createMap()
+    map.putString("id", attachment.id)
+    map.putString("name", attachment.name)
+    map.putString("mimeType", attachment.mimeType)
+    map.putDouble("size", attachment.size.toDouble())
+    map.putString("status", attachment.status.name.lowercase())
+    map.putDouble("progress", attachment.progress.toDouble())
+    attachment.publicUrl?.let { map.putString("url", it) }
+    attachment.errorReason?.let { map.putString("error", it) }
+    emit("attachmentUpdated", map)
+  }
+
+  override fun onChatClosed(event: ChatCloseEvent) {
+    val map = Arguments.createMap()
+    map.putString("reason", event.reason.wire)
+    map.putString("initiator", event.initiator.wire)
+    map.putDouble("timestamp", event.timestamp.toDouble())
+    event.conversationId?.let { map.putString("conversationId", it) }
+    event.assignmentId?.let { map.putString("assignmentId", it) }
+    map.putString("channel", event.channel)
+    map.putString("previousState", event.previousState)
+    map.putInt("unreadCount", event.unreadCount)
+    map.putBoolean("hasDraft", event.hasDraft)
+    map.putInt("pendingAttachmentCount", event.pendingAttachmentCount)
+    val meta = Arguments.createMap()
+    event.metadata.forEach { (k, v) -> meta.putString(k, v) }
+    map.putMap("metadata", meta)
+    emit("chatClosed", map)
+  }
+
   override fun onError(error: LiveAndAiChatError) {
     val map = Arguments.createMap()
     map.putString("type", error.type.name.lowercase())

package/ios/NewinstanceChat.mm

@@ -76,6 +76,16 @@ RCT_EXPORT_MODULE()
   [_impl attachFile:opts resolver:resolve rejecter:reject];
 }
 
+- (void)removeAttachment:(NSString *)attachmentId
+{
+  [_impl removeAttachment:attachmentId];
+}
+
+- (void)clearAttachments
+{
+  [_impl clearAttachments];
+}
+
 // NativeEventEmitter wires these so it can track subscriber counts. The
 // actual event payloads flow through RCTDeviceEventEmitter, so these are
 // intentional no-ops.

package/ios/NewinstanceChatImpl.swift

@@ -140,24 +140,51 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
       rejecter("E_NOT_CONFIGURED", "configure() must be called first", nil)
       return
     }
-    guard let uri = opts["uri"] as? String,
-          let name = opts["name"] as? String,
-          let mimeType = opts["mimeType"] as? String,
-          let url = URL(string: uri) else {
-      rejecter("E_ARGS", "uri, name, mimeType are required", nil)
+    guard let name = opts["name"] as? String, !name.isEmpty else {
+      rejecter("E_ARGS", "name is required", nil)
       return
     }
-    DispatchQueue.global(qos: .userInitiated).async {
-      do {
-        let data = try Data(contentsOf: url)
-        DispatchQueue.main.async {
-          sdk.attachFile(data: data, name: name, mimeType: mimeType, previewUri: uri)
-          resolver(nil)
-        }
-      } catch {
-        rejecter("E_READ", "Failed to read file: \(error.localizedDescription)", error)
-      }
+    guard let sourceValue = (opts["source"] as? String) ?? (opts["uri"] as? String), !sourceValue.isEmpty else {
+      rejecter("E_ARGS", "source (or legacy uri) is required", nil)
+      return
+    }
+    let sourceType = (opts["sourceType"] as? String) ?? "auto"
+    guard let source = AttachmentSource.fromTypeName(sourceType, value: sourceValue) else {
+      rejecter(
+        "E_SOURCE",
+        sourceType == "auto"
+          ? "Could not detect the attachment source type — pass sourceType explicitly"
+          : "Unknown sourceType: \(sourceType)",
+        nil
+      )
+      return
     }
+    let mimeType = opts["mimeType"] as? String
+    let declaredSize = (opts["size"] as? NSNumber)?.int64Value
+    var metadata: [String: String] = [:]
+    if let raw = opts["metadata"] as? [String: Any] {
+      for (key, value) in raw { metadata[key] = String(describing: value) }
+    }
+    let request = AttachmentRequest(
+      source: source,
+      name: name,
+      mimeType: mimeType,
+      declaredSize: declaredSize,
+      metadata: metadata
+    )
+    DispatchQueue.main.async {
+      let id = sdk.attach(request)
+      resolver(id)
+    }
+  }
+
+  @objc(removeAttachment:)
+  public func removeAttachment(_ id: String) {
+    DispatchQueue.main.async { [weak self] in self?.sdk?.removeAttachment(id: id) }
+  }
+
+  @objc public func clearAttachments() {
+    DispatchQueue.main.async { [weak self] in self?.sdk?.clearAttachments() }
   }
 
   @objc public func destroy() {
@@ -171,6 +198,41 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
 
   // MARK: - LiveAndAiChatDelegate
 
+  public func unreadCountDidChange(_ count: Int) {
+    emitter?.emitEvent("unreadCountChanged", body: count)
+  }
+
+  public func attachmentDidUpdate(_ attachment: QueuedAttachment) {
+    var body: [String: Any] = [
+      "id": attachment.id,
+      "name": attachment.name,
+      "mimeType": attachment.mimeType,
+      "size": attachment.size,
+      "status": attachment.status.rawValue,
+      "progress": attachment.progress,
+    ]
+    if let url = attachment.publicUrl { body["url"] = url }
+    if let error = attachment.errorReason { body["error"] = error }
+    emitter?.emitEvent("attachmentUpdated", body: body)
+  }
+
+  public func chatDidClose(_ event: ChatCloseEvent) {
+    var body: [String: Any] = [
+      "reason": event.reason.rawValue,
+      "initiator": event.initiator.rawValue,
+      "timestamp": event.timestamp,
+      "channel": event.channel,
+      "previousState": event.previousState,
+      "unreadCount": event.unreadCount,
+      "hasDraft": event.hasDraft,
+      "pendingAttachmentCount": event.pendingAttachmentCount,
+      "metadata": event.metadata,
+    ]
+    if let id = event.conversationId { body["conversationId"] = id }
+    if let id = event.assignmentId { body["assignmentId"] = id }
+    emitter?.emitEvent("chatClosed", body: body)
+  }
+
   public func didReceiveMessage(_ message: ChatMessage) {
     emitter?.emitEvent("messageReceived", body: Self.chatMessageToDict(message))
   }

package/lib/module/NativeNewinstanceChat.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeNewinstanceChat.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;;AAEpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkBA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,iBAAiB,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeNewinstanceChat.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;;AAEpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAoBA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,iBAAiB,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -65,9 +65,22 @@ export class NewinstanceChat {
    * uploaded reference into the next `sendMessage()`.
    */
   attachFile(opts) {
+    if (!opts.source && !opts.uri) {
+      return Promise.reject(new Error('attachFile requires `source` (or the legacy `uri`)'));
+    }
     return NativeNewinstanceChat.attachFile(opts);
   }
 
+  /** Remove a queued attachment; cancels its upload if still in flight. */
+  removeAttachment(id) {
+    NativeNewinstanceChat.removeAttachment(id);
+  }
+
+  /** Remove every queued attachment and cancel in-flight uploads. */
+  clearAttachments() {
+    NativeNewinstanceChat.clearAttachments();
+  }
+
   /**
    * Subscribe to a native event. Returns an unsubscribe function — call it
    * when your component unmounts to avoid leaks.

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeModules","NativeNewinstanceChat","emitterSource","NewinstanceChat","emitter","constructor","config","ready","configure","setUser","user","initialize","openChat","closeChat","sendMessage","text","retryMessage","messageId","attachFile","opts","addListener","event","handler","sub","remove","destroy"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SACEA,kBAAkB,EAClBC,aAAa,QAER,cAAc;AAErB,OAAOC,qBAAqB,MAAM,4BAAyB;AAqB3D;AACA;AACA;AACA,MAAMC,aAAkB,GACtBF,aAAa,CAACG,eAAe,IAAKF,qBAAiC;AACrE,MAAMG,OAAO,GAAG,IAAIL,kBAAkB,CAACG,aAAa,CAAC;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,CAAC;EAC3B;;EAGAE,WAAWA,CAACC,MAA6B,EAAE;IACzC,IAAI,CAACC,KAAK,GAAGN,qBAAqB,CAACO,SAAS,CAACF,MAAM,CAAC;EACtD;;EAEA;AACF;AACA;AACA;AACA;EACEG,OAAOA,CAACC,IAAc,EAAQ;IAC5BT,qBAAqB,CAACQ,OAAO,CAACC,IAAI,CAAC;EACrC;;EAEA;AACF;AACA;AACA;AACA;EACEC,UAAUA,CAAA,EAAkB;IAC1B,OAAOV,qBAAqB,CAACU,UAAU,CAAC,CAAC;EAC3C;;EAEA;EACAC,QAAQA,CAAA,EAAS;IACfX,qBAAqB,CAACW,QAAQ,CAAC,CAAC;EAClC;;EAEA;EACAC,SAASA,CAAA,EAAS;IAChBZ,qBAAqB,CAACY,SAAS,CAAC,CAAC;EACnC;EAEAC,WAAWA,CAACC,IAAY,EAAQ;IAC9Bd,qBAAqB,CAACa,WAAW,CAACC,IAAI,CAAC;EACzC;EAEAC,YAAYA,CAACC,SAAiB,EAAQ;IACpChB,qBAAqB,CAACe,YAAY,CAACC,SAAS,CAAC;EAC/C;;EAEA;AACF;AACA;AACA;AACA;EACEC,UAAUA,CAACC,IAAqB,EAAiB;IAC/C,OAAOlB,qBAAqB,CAACiB,UAAU,CAACC,IAAI,CAAC;EAC/C;;EAEA;AACF;AACA;AACA;EACEC,WAAWA,CACTC,KAAQ,EACRC,OAAwB,EACZ;IACZ,MAAMC,GAAwB,GAAGnB,OAAO,CAACgB,WAAW,CAClDC,KAAK,EACLC,OACF,CAAC;IACD,OAAO,MAAMC,GAAG,CAACC,MAAM,CAAC,CAAC;EAC3B;;EAEA;AACF;AACA;AACA;EACEC,OAAOA,CAAA,EAAS;IACdxB,qBAAqB,CAACwB,OAAO,CAAC,CAAC;EACjC;AACF","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","NativeModules","NativeNewinstanceChat","emitterSource","NewinstanceChat","emitter","constructor","config","ready","configure","setUser","user","initialize","openChat","closeChat","sendMessage","text","retryMessage","messageId","attachFile","opts","source","uri","Promise","reject","Error","removeAttachment","id","clearAttachments","addListener","event","handler","sub","remove","destroy"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SACEA,kBAAkB,EAClBC,aAAa,QAER,cAAc;AAErB,OAAOC,qBAAqB,MAAM,4BAAyB;AAqB3D;AACA;AACA;AACA,MAAMC,aAAkB,GACtBF,aAAa,CAACG,eAAe,IAAKF,qBAAiC;AACrE,MAAMG,OAAO,GAAG,IAAIL,kBAAkB,CAACG,aAAa,CAAC;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,CAAC;EAC3B;;EAGAE,WAAWA,CAACC,MAA6B,EAAE;IACzC,IAAI,CAACC,KAAK,GAAGN,qBAAqB,CAACO,SAAS,CAACF,MAAM,CAAC;EACtD;;EAEA;AACF;AACA;AACA;AACA;EACEG,OAAOA,CAACC,IAAc,EAAQ;IAC5BT,qBAAqB,CAACQ,OAAO,CAACC,IAAI,CAAC;EACrC;;EAEA;AACF;AACA;AACA;AACA;EACEC,UAAUA,CAAA,EAAkB;IAC1B,OAAOV,qBAAqB,CAACU,UAAU,CAAC,CAAC;EAC3C;;EAEA;EACAC,QAAQA,CAAA,EAAS;IACfX,qBAAqB,CAACW,QAAQ,CAAC,CAAC;EAClC;;EAEA;EACAC,SAASA,CAAA,EAAS;IAChBZ,qBAAqB,CAACY,SAAS,CAAC,CAAC;EACnC;EAEAC,WAAWA,CAACC,IAAY,EAAQ;IAC9Bd,qBAAqB,CAACa,WAAW,CAACC,IAAI,CAAC;EACzC;EAEAC,YAAYA,CAACC,SAAiB,EAAQ;IACpChB,qBAAqB,CAACe,YAAY,CAACC,SAAS,CAAC;EAC/C;;EAEA;AACF;AACA;AACA;AACA;EACEC,UAAUA,CAACC,IAAqB,EAAmB;IACjD,IAAI,CAACA,IAAI,CAACC,MAAM,IAAI,CAACD,IAAI,CAACE,GAAG,EAAE;MAC7B,OAAOC,OAAO,CAACC,MAAM,CAAC,IAAIC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxF;IACA,OAAOvB,qBAAqB,CAACiB,UAAU,CAACC,IAAI,CAAC;EAC/C;;EAEA;EACAM,gBAAgBA,CAACC,EAAU,EAAQ;IACjCzB,qBAAqB,CAACwB,gBAAgB,CAACC,EAAE,CAAC;EAC5C;;EAEA;EACAC,gBAAgBA,CAAA,EAAS;IACvB1B,qBAAqB,CAAC0B,gBAAgB,CAAC,CAAC;EAC1C;;EAEA;AACF;AACA;AACA;EACEC,WAAWA,CACTC,KAAQ,EACRC,OAAwB,EACZ;IACZ,MAAMC,GAAwB,GAAG3B,OAAO,CAACwB,WAAW,CAClDC,KAAK,EACLC,OACF,CAAC;IACD,OAAO,MAAMC,GAAG,CAACC,MAAM,CAAC,CAAC;EAC3B;;EAEA;AACF;AACA;AACA;EACEC,OAAOA,CAAA,EAAS;IACdhC,qBAAqB,CAACgC,OAAO,CAAC,CAAC;EACjC;AACF","ignoreList":[]}

package/lib/typescript/src/NativeNewinstanceChat.d.ts

@@ -17,7 +17,9 @@ export interface Spec extends TurboModule {
     closeChat(): void;
     sendMessage(text: string): void;
     retryMessage(messageId: string): void;
-    attachFile(opts: Object): Promise<void>;
+    attachFile(opts: Object): Promise<string>;
+    removeAttachment(id: string): void;
+    clearAttachments(): void;
     destroy(): void;
     addListener(eventName: string): void;
     removeListeners(count: number): void;

package/lib/typescript/src/NativeNewinstanceChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeNewinstanceChat.d.ts","sourceRoot":"","sources":["../../../src/NativeNewinstanceChat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,IAAI,IAAI,CAAC;IACjB,SAAS,IAAI,IAAI,CAAC;IAClB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC;IAIhB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAyE"}
+{"version":3,"file":"NativeNewinstanceChat.d.ts","sourceRoot":"","sources":["../../../src/NativeNewinstanceChat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,IAAI,IAAI,CAAC;IACjB,SAAS,IAAI,IAAI,CAAC;IAClB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,IAAI,IAAI,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;IAIhB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAyE"}

package/lib/typescript/src/index.d.ts

@@ -37,7 +37,11 @@ export declare class NewinstanceChat {
      * `uri`, pushes them through the SDK's upload pipeline, and bundles the
      * uploaded reference into the next `sendMessage()`.
      */
-    attachFile(opts: AttachmentInput): Promise<void>;
+    attachFile(opts: AttachmentInput): Promise<string>;
+    /** Remove a queued attachment; cancels its upload if still in flight. */
+    removeAttachment(id: string): void;
+    /** Remove every queued attachment and cancel in-flight uploads. */
+    clearAttachments(): void;
     /**
      * Subscribe to a native event. Returns an unsubscribe function — call it
      * when your component unmounts to avoid leaks.

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,SAAS,CAAC;AASjB;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAElB,MAAM,EAAE,qBAAqB;IAIzC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,uEAAuE;IACvE,QAAQ,IAAI,IAAI;IAIhB,sCAAsC;IACtC,SAAS,IAAI,IAAI;IAIjB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,SAAS,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI;IAQb;;;OAGG;IACH,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,SAAS,CAAC;AASjB;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAElB,MAAM,EAAE,qBAAqB;IAIzC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,uEAAuE;IACvE,QAAQ,IAAI,IAAI;IAIhB,sCAAsC;IACtC,SAAS,IAAI,IAAI;IAIjB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC,mEAAmE;IACnE,gBAAgB,IAAI,IAAI;IAIxB;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,SAAS,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI;IAQb;;;OAGG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/lib/typescript/src/types.d.ts

@@ -20,12 +20,63 @@ export interface ChatUser {
     customerEmail?: string;
     customerId?: string;
 }
-/** A local file the native side reads bytes from. */
+export type AttachmentSourceType = 'auto' | 'base64' | 'dataUri' | 'file' | 'contentUri' | 'url';
+/**
+ * A programmatic attachment. Provide `source` + optional `sourceType`
+ * (`'auto'` detects data URIs, `content://`/`file://` URIs, absolute
+ * paths, http(s) URLs — remote URLs upload only when the native SDK is
+ * configured with `allowRemoteAttachmentUrls` — and raw base64).
+ * The legacy `uri` field keeps working and behaves like
+ * `source` + `sourceType: 'auto'`.
+ */
 export interface AttachmentInput {
-    /** Local file URI: `file://...` (iOS) or `content://...` / `file://...` (Android). */
-    uri: string;
+    /** Attachment data or locator, interpreted per `sourceType`. */
+    source?: string;
+    sourceType?: AttachmentSourceType;
+    /** @deprecated Use `source`. Local file URI, still fully supported. */
+    uri?: string;
+    name: string;
+    /** Required unless the source itself carries one (data URIs, content URIs) or the extension resolves it. */
+    mimeType?: string;
+    /** Expected byte size — validated against the resolved data as a corruption guard. */
+    size?: number;
+    /** Free-form string metadata carried on the queued attachment. */
+    metadata?: Record<string, string>;
+}
+export type AttachmentStatus = 'queued' | 'uploading' | 'uploaded' | 'failed' | 'cancelled';
+/** Streamed on `attachmentUpdated` for every attachment state/progress change. */
+export interface AttachmentUpdate {
+    id: string;
     name: string;
     mimeType: string;
+    size: number;
+    status: AttachmentStatus;
+    /** 0..1 — real byte progress while uploading. */
+    progress: number;
+    /** Public URL once `status === 'uploaded'`. */
+    url?: string;
+    /** Failure reason once `status === 'failed'`. */
+    error?: string;
+}
+export type ChatCloseReason = 'close_button' | 'back_navigation' | 'gesture' | 'programmatic' | 'session_ended' | 'host_navigation';
+/**
+ * Fired exactly once per chat presentation when the chat screen goes
+ * away, however it was dismissed. Never contains message contents,
+ * credentials, or attachment data.
+ */
+export interface ChatClosedEvent {
+    reason: ChatCloseReason;
+    initiator: 'user' | 'host' | 'sdk';
+    /** Unix milliseconds. */
+    timestamp: number;
+    conversationId?: string;
+    assignmentId?: string;
+    channel: string;
+    previousState: string;
+    unreadCount: number;
+    hasDraft: boolean;
+    pendingAttachmentCount: number;
+    metadata: Record<string, string>;
 }
 export type ConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'offline';
 export interface ChatMessage {
@@ -63,6 +114,8 @@ export interface EventMap {
     connectionStateChanged: (state: ConnectionState) => void;
     unreadCountChanged: (count: number) => void;
     error: (e: NewinstanceChatError) => void;
+    attachmentUpdated: (attachment: AttachmentUpdate) => void;
+    chatClosed: (event: ChatClosedEvent) => void;
 }
 export type EventName = keyof EventMap;
 export type EventHandler<K extends EventName> = EventMap[K];

package/lib/typescript/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,YAAY,GACZ,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,WAAW,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,kBAAkB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,sBAAsB,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACzD,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC;AACvC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-newinstance-chat",
-  "version": "0.1.2",
-  "description": "New instance LiveAndAiChat React Native SDK — AI + live-agent chat, drop-in native chat screen for iOS and Android.",
+  "version": "0.2.0",
+  "description": "New instance LiveAndAiChat React Native SDK \u2014 AI + live-agent chat, drop-in native chat screen for iOS and Android.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
@@ -130,7 +130,9 @@
     "preset": "@react-native/jest-preset",
     "modulePathIgnorePatterns": [
       "<rootDir>/example/node_modules",
-      "<rootDir>/lib/"
+      "<rootDir>/lib/",
+      "<rootDir>/example/ios",
+      "<rootDir>/example/android"
     ]
   },
   "release-it": {
@@ -162,5 +164,9 @@
       "vite"
     ],
     "version": "0.62.0"
+  },
+  "resolutions": {
+    "jest-environment-node": "^30.4.1",
+    "jest-mock": "^30.4.1"
   }
 }

package/src/NativeNewinstanceChat.ts

@@ -18,7 +18,9 @@ export interface Spec extends TurboModule {
   closeChat(): void;
   sendMessage(text: string): void;
   retryMessage(messageId: string): void;
-  attachFile(opts: Object): Promise<void>;
+  attachFile(opts: Object): Promise<string>;
+  removeAttachment(id: string): void;
+  clearAttachments(): void;
   destroy(): void;
 
   // NativeEventEmitter on iOS calls these to track listener counts.

package/src/index.tsx

@@ -91,10 +91,23 @@ export class NewinstanceChat {
    * `uri`, pushes them through the SDK's upload pipeline, and bundles the
    * uploaded reference into the next `sendMessage()`.
    */
-  attachFile(opts: AttachmentInput): Promise<void> {
+  attachFile(opts: AttachmentInput): Promise<string> {
+    if (!opts.source && !opts.uri) {
+      return Promise.reject(new Error('attachFile requires `source` (or the legacy `uri`)'));
+    }
     return NativeNewinstanceChat.attachFile(opts);
   }
 
+  /** Remove a queued attachment; cancels its upload if still in flight. */
+  removeAttachment(id: string): void {
+    NativeNewinstanceChat.removeAttachment(id);
+  }
+
+  /** Remove every queued attachment and cancel in-flight uploads. */
+  clearAttachments(): void {
+    NativeNewinstanceChat.clearAttachments();
+  }
+
   /**
    * Subscribe to a native event. Returns an unsubscribe function — call it
    * when your component unmounts to avoid leaks.

package/src/types.ts

@@ -23,12 +23,85 @@ export interface ChatUser {
   customerId?: string;
 }
 
-/** A local file the native side reads bytes from. */
+export type AttachmentSourceType =
+  | 'auto'
+  | 'base64'
+  | 'dataUri'
+  | 'file'
+  | 'contentUri'
+  | 'url';
+
+/**
+ * A programmatic attachment. Provide `source` + optional `sourceType`
+ * (`'auto'` detects data URIs, `content://`/`file://` URIs, absolute
+ * paths, http(s) URLs — remote URLs upload only when the native SDK is
+ * configured with `allowRemoteAttachmentUrls` — and raw base64).
+ * The legacy `uri` field keeps working and behaves like
+ * `source` + `sourceType: 'auto'`.
+ */
 export interface AttachmentInput {
-  /** Local file URI: `file://...` (iOS) or `content://...` / `file://...` (Android). */
-  uri: string;
+  /** Attachment data or locator, interpreted per `sourceType`. */
+  source?: string;
+  sourceType?: AttachmentSourceType;
+  /** @deprecated Use `source`. Local file URI, still fully supported. */
+  uri?: string;
+  name: string;
+  /** Required unless the source itself carries one (data URIs, content URIs) or the extension resolves it. */
+  mimeType?: string;
+  /** Expected byte size — validated against the resolved data as a corruption guard. */
+  size?: number;
+  /** Free-form string metadata carried on the queued attachment. */
+  metadata?: Record<string, string>;
+}
+
+export type AttachmentStatus =
+  | 'queued'
+  | 'uploading'
+  | 'uploaded'
+  | 'failed'
+  | 'cancelled';
+
+/** Streamed on `attachmentUpdated` for every attachment state/progress change. */
+export interface AttachmentUpdate {
+  id: string;
   name: string;
   mimeType: string;
+  size: number;
+  status: AttachmentStatus;
+  /** 0..1 — real byte progress while uploading. */
+  progress: number;
+  /** Public URL once `status === 'uploaded'`. */
+  url?: string;
+  /** Failure reason once `status === 'failed'`. */
+  error?: string;
+}
+
+export type ChatCloseReason =
+  | 'close_button'
+  | 'back_navigation'
+  | 'gesture'
+  | 'programmatic'
+  | 'session_ended'
+  | 'host_navigation';
+
+/**
+ * Fired exactly once per chat presentation when the chat screen goes
+ * away, however it was dismissed. Never contains message contents,
+ * credentials, or attachment data.
+ */
+export interface ChatClosedEvent {
+  reason: ChatCloseReason;
+  initiator: 'user' | 'host' | 'sdk';
+  /** Unix milliseconds. */
+  timestamp: number;
+  conversationId?: string;
+  assignmentId?: string;
+  channel: string;
+  previousState: string;
+  unreadCount: number;
+  hasDraft: boolean;
+  pendingAttachmentCount: number;
+  metadata: Record<string, string>;
 }
 
 export type ConnectionState =
@@ -80,6 +153,8 @@ export interface EventMap {
   connectionStateChanged: (state: ConnectionState) => void;
   unreadCountChanged: (count: number) => void;
   error: (e: NewinstanceChatError) => void;
+  attachmentUpdated: (attachment: AttachmentUpdate) => void;
+  chatClosed: (event: ChatClosedEvent) => void;
 }
 
 export type EventName = keyof EventMap;