react-native-newinstance-chat 0.1.0

package/ios/NewinstanceChatImpl.swift

@@ -0,0 +1,239 @@
+import Foundation
+import LiveAndAiChat
+import React
+import UIKit
+
+/// Anything that can route an event payload through to the JS bridge.
+/// The Obj-C `NewinstanceChat` class adopts this in a class extension
+/// (see NewinstanceChat.mm) — Swift only needs the protocol so it
+/// doesn't have to import the auto-generated `NewinstanceChat-Swift.h`
+/// (which would create a circular header dependency at build time).
+@objc public protocol NewinstanceChatEmitter: AnyObject {
+  @objc func emitEvent(_ name: String, body: Any?)
+}
+
+/// Swift implementation backing the `NewinstanceChat` TurboModule.
+///
+/// Holds a single `LiveAndAiChat` SDK instance constructed lazily on
+/// `configure(...)`. Repeated `configure(...)` calls tear down and
+/// rebuild — hosts almost never want concurrent chat sessions.
+///
+/// Events are pushed to JS via the Obj-C bridge class's `emitEvent:body:`
+/// (which uses RCTDeviceEventEmitter under the hood). The emitter
+/// reference is set by `NewinstanceChat` at init.
+@objc(NewinstanceChatImpl)
+public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
+
+  @objc public weak var emitter: NewinstanceChatEmitter?
+
+  private var sdk: LiveAndAiChat?
+  private var pendingUser: ChatUser?
+
+  // MARK: - configure / setUser / initialize
+
+  @objc(configure:resolver:rejecter:)
+  public func configure(_ configDict: NSDictionary,
+                        resolver: @escaping RCTPromiseResolveBlock,
+                        rejecter: @escaping RCTPromiseRejectBlock) {
+    guard let apiKey = configDict["apiKey"] as? String, !apiKey.isEmpty else {
+      rejecter("E_CONFIG", "apiKey is required", nil)
+      return
+    }
+    let baseUrl = configDict["baseUrl"] as? String
+    let initialMessage = configDict["initialMessage"] as? String
+    let transport: TransportMode? = {
+      switch configDict["transport"] as? String {
+      case "sse": return .sse
+      case "ws":  return .ws
+      default:    return nil
+      }
+    }()
+
+    DispatchQueue.main.async { [weak self] in
+      guard let self = self else { return }
+      do {
+        let cfg = try LiveAndAiChatConfig(
+          apiKey: apiKey,
+          baseUrl: baseUrl ?? LiveAndAiChatConfig.defaultBaseUrl,
+          transport: transport,
+          initialMessage: initialMessage
+        )
+        let builder = LiveAndAiChat.Builder().config(cfg)
+        if let user = self.pendingUser { _ = builder.user(user) }
+        self.sdk?.destroy()
+        let instance = try builder.build()
+        instance.addDelegate(self)
+        self.sdk = instance
+        self.pendingUser = nil
+        resolver(nil)
+      } catch let e as LiveAndAiChatError {
+        rejecter("E_BUILD", e.message, e)
+      } catch {
+        rejecter("E_BUILD", error.localizedDescription, error)
+      }
+    }
+  }
+
+  @objc(setUser:)
+  public func setUser(_ userDict: NSDictionary) {
+    guard let name = userDict["customerName"] as? String, !name.isEmpty else { return }
+    let user = ChatUser(
+      customerName: name,
+      customerId: userDict["customerId"] as? String,
+      customerEmail: userDict["customerEmail"] as? String
+    )
+    DispatchQueue.main.async { [weak self] in
+      guard let self = self else { return }
+      if let sdk = self.sdk {
+        sdk.setUser(user)
+      } else {
+        self.pendingUser = user
+      }
+    }
+  }
+
+  @objc(initializeWithResolver:rejecter:)
+  public func initialize(resolver: @escaping RCTPromiseResolveBlock,
+                         rejecter: @escaping RCTPromiseRejectBlock) {
+    guard let sdk = sdk else {
+      rejecter("E_NOT_CONFIGURED", "configure() must be called before initialize()", nil)
+      return
+    }
+    DispatchQueue.main.async {
+      sdk.initialize()
+      resolver(nil)
+    }
+  }
+
+  // MARK: - Native chat presentation
+
+  @objc public func openChat() {
+    DispatchQueue.main.async { [weak self] in
+      guard let self = self, let sdk = self.sdk else { return }
+      guard let host = self.topPresentedViewController() else { return }
+      // `present(from:)` mounts the SDK's native chat screen modally and
+      // calls `openChat()` itself once presented. Calling the SDK's bare
+      // `openChat()` only flips internal state — it shows no UI.
+      sdk.present(from: host)
+    }
+  }
+
+  @objc public func closeChat() {
+    DispatchQueue.main.async { [weak self] in self?.sdk?.closeChat() }
+  }
+
+  // MARK: - Programmatic actions
+
+  @objc public func sendMessage(_ text: String) {
+    DispatchQueue.main.async { [weak self] in self?.sdk?.sendMessage(text) }
+  }
+
+  @objc public func retryMessage(_ messageId: String) {
+    DispatchQueue.main.async { [weak self] in self?.sdk?.retryMessage(messageId: messageId) }
+  }
+
+  @objc(attachFile:resolver:rejecter:)
+  public func attachFile(_ opts: NSDictionary,
+                         resolver: @escaping RCTPromiseResolveBlock,
+                         rejecter: @escaping RCTPromiseRejectBlock) {
+    guard let sdk = sdk else {
+      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)
+      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)
+      }
+    }
+  }
+
+  @objc public func destroy() {
+    DispatchQueue.main.async { [weak self] in
+      guard let self = self else { return }
+      self.sdk?.destroy()
+      self.sdk = nil
+      self.pendingUser = nil
+    }
+  }
+
+  // MARK: - LiveAndAiChatDelegate
+
+  public func didReceiveMessage(_ message: ChatMessage) {
+    emitter?.emitEvent("messageReceived", body: Self.chatMessageToDict(message))
+  }
+  public func didSendMessage(_ message: ChatMessage) {
+    emitter?.emitEvent("messageSent", body: Self.chatMessageToDict(message))
+  }
+  public func agentTypingDidChange(_ isTyping: Bool) {
+    emitter?.emitEvent("agentTypingChanged", body: isTyping)
+  }
+  public func connectionStateDidChange(_ state: ConnectionState) {
+    emitter?.emitEvent("connectionStateChanged", body: Self.connectionStateName(state))
+  }
+  public func didEncounterError(_ error: LiveAndAiChatError) {
+    emitter?.emitEvent("error", body: [
+      "type": Self.errorTypeName(error.type),
+      "message": error.message,
+      "recoverable": error.recoverable,
+    ])
+  }
+
+  // MARK: - Helpers
+
+  private static func chatMessageToDict(_ m: ChatMessage) -> [String: Any?] {
+    return [
+      "id": m.id,
+      "clientId": m.clientId,
+      "conversationId": m.conversationId,
+      "content": m.content,
+      "type": m.type.rawValue,
+      "status": m.status.rawValue,
+      "seq": m.seq,
+      "sentAt": m.createdAt,
+      "senderName": m.sender?.senderName,
+      "totalMessages": m.totalMessages,
+    ]
+  }
+
+  private static func connectionStateName(_ state: ConnectionState) -> String {
+    switch state {
+    case .idle:         return "idle"
+    case .connecting:   return "connecting"
+    case .connected:    return "connected"
+    case .disconnected: return "disconnected"
+    case .offline:      return "offline"
+    }
+  }
+
+  private static func errorTypeName(_ t: ChatErrorType) -> String {
+    switch t {
+    case .network:    return "network"
+    case .validation: return "validation"
+    case .auth:       return "auth"
+    case .system:     return "system"
+    }
+  }
+
+  private func topPresentedViewController() -> UIViewController? {
+    let scenes = UIApplication.shared.connectedScenes.compactMap { $0 as? UIWindowScene }
+    let keyWindow = scenes
+      .flatMap { $0.windows }
+      .first(where: { $0.isKeyWindow }) ?? scenes.first?.windows.first
+    guard var top = keyWindow?.rootViewController else { return nil }
+    while let presented = top.presentedViewController { top = presented }
+    return top
+  }
+}

package/lib/module/NativeNewinstanceChat.js

@@ -0,0 +1,17 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+
+/**
+ * TurboModule spec for the LiveAndAiChat React Native bridge. Codegen
+ * produces native protocol stubs from this file:
+ *   - iOS:     ios/build/.../NewinstanceChatSpec/NewinstanceChatSpec.h
+ *   - Android: android/build/.../NativeNewinstanceChatSpec.java
+ *
+ * Dict-shaped arguments use `Object` because Codegen can't enforce
+ * deep object schemas; the JS class enforces the shapes via TypeScript
+ * before calling in.
+ */
+
+export default TurboModuleRegistry.getEnforcing('NewinstanceChat');
+//# sourceMappingURL=NativeNewinstanceChat.js.map

package/lib/module/NativeNewinstanceChat.js.map

@@ -0,0 +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":[]}

package/lib/module/index.js

@@ -0,0 +1,88 @@
+"use strict";
+
+import { NativeEventEmitter, NativeModules } from 'react-native';
+import NativeNewinstanceChat from "./NativeNewinstanceChat.js";
+// Bridge mode (old arch) exposes the module on NativeModules; new arch
+// goes through TurboModuleRegistry. NativeEventEmitter accepts either —
+// we feed it the legacy handle so listener counts get tracked.
+const emitterSource = NativeModules.NewinstanceChat ?? NativeNewinstanceChat;
+const emitter = new NativeEventEmitter(emitterSource);
+
+/**
+ * React Native binding for the native LiveAndAiChat iOS / Android SDKs.
+ *
+ * Construct, optionally set a user, call `initialize()`, then `openChat()`
+ * when the host wants to surface the native chat screen. Subscribe to
+ * events with `addListener` — the returned function unsubscribes.
+ *
+ * Multiple `new NewinstanceChat(...)` calls reconfigure the same underlying
+ * native instance — the most recent `configure` wins.
+ */
+export class NewinstanceChat {
+  /** Resolves once the native SDK is configured. */
+
+  constructor(config) {
+    this.ready = NativeNewinstanceChat.configure(config);
+  }
+
+  /**
+   * Identify the customer. Safe to call before or after `initialize()`. If
+   * called before `configure()` resolves, the user is queued and applied
+   * once the native instance exists.
+   */
+  setUser(user) {
+    NativeNewinstanceChat.setUser(user);
+  }
+
+  /**
+   * Fetch org config, restore the saved conversation, and connect the
+   * subscription transport in the background. Concurrent callers share
+   * the same in-flight init.
+   */
+  initialize() {
+    return NativeNewinstanceChat.initialize();
+  }
+
+  /** Present the native chat screen modally over the current RN host. */
+  openChat() {
+    NativeNewinstanceChat.openChat();
+  }
+
+  /** Dismiss the native chat screen. */
+  closeChat() {
+    NativeNewinstanceChat.closeChat();
+  }
+  sendMessage(text) {
+    NativeNewinstanceChat.sendMessage(text);
+  }
+  retryMessage(messageId) {
+    NativeNewinstanceChat.retryMessage(messageId);
+  }
+
+  /**
+   * Queue a local file as an attachment. The native side reads bytes from
+   * `uri`, pushes them through the SDK's upload pipeline, and bundles the
+   * uploaded reference into the next `sendMessage()`.
+   */
+  attachFile(opts) {
+    return NativeNewinstanceChat.attachFile(opts);
+  }
+
+  /**
+   * Subscribe to a native event. Returns an unsubscribe function — call it
+   * when your component unmounts to avoid leaks.
+   */
+  addListener(event, handler) {
+    const sub = emitter.addListener(event, handler);
+    return () => sub.remove();
+  }
+
+  /**
+   * Tear down the native SDK. After this the instance is unusable —
+   * construct a new one if you need to chat again.
+   */
+  destroy() {
+    NativeNewinstanceChat.destroy();
+  }
+}
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +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":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

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

@@ -0,0 +1,27 @@
+import { type TurboModule } from 'react-native';
+/**
+ * TurboModule spec for the LiveAndAiChat React Native bridge. Codegen
+ * produces native protocol stubs from this file:
+ *   - iOS:     ios/build/.../NewinstanceChatSpec/NewinstanceChatSpec.h
+ *   - Android: android/build/.../NativeNewinstanceChatSpec.java
+ *
+ * Dict-shaped arguments use `Object` because Codegen can't enforce
+ * deep object schemas; the JS class enforces the shapes via TypeScript
+ * before calling in.
+ */
+export interface Spec extends TurboModule {
+    configure(config: Object): Promise<void>;
+    setUser(user: Object): void;
+    initialize(): Promise<void>;
+    openChat(): void;
+    closeChat(): void;
+    sendMessage(text: string): void;
+    retryMessage(messageId: string): void;
+    attachFile(opts: Object): Promise<void>;
+    destroy(): void;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeNewinstanceChat.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,52 @@
+import type { AttachmentInput, ChatUser, EventHandler, EventName, NewinstanceChatConfig } from './types';
+export type { AttachmentInput, ChatMessage, ChatUser, ConnectionState, EventMap, EventName, NewinstanceChatConfig, NewinstanceChatError, NewinstanceChatErrorType, } from './types';
+/**
+ * React Native binding for the native LiveAndAiChat iOS / Android SDKs.
+ *
+ * Construct, optionally set a user, call `initialize()`, then `openChat()`
+ * when the host wants to surface the native chat screen. Subscribe to
+ * events with `addListener` — the returned function unsubscribes.
+ *
+ * Multiple `new NewinstanceChat(...)` calls reconfigure the same underlying
+ * native instance — the most recent `configure` wins.
+ */
+export declare class NewinstanceChat {
+    /** Resolves once the native SDK is configured. */
+    readonly ready: Promise<void>;
+    constructor(config: NewinstanceChatConfig);
+    /**
+     * Identify the customer. Safe to call before or after `initialize()`. If
+     * called before `configure()` resolves, the user is queued and applied
+     * once the native instance exists.
+     */
+    setUser(user: ChatUser): void;
+    /**
+     * Fetch org config, restore the saved conversation, and connect the
+     * subscription transport in the background. Concurrent callers share
+     * the same in-flight init.
+     */
+    initialize(): Promise<void>;
+    /** Present the native chat screen modally over the current RN host. */
+    openChat(): void;
+    /** Dismiss the native chat screen. */
+    closeChat(): void;
+    sendMessage(text: string): void;
+    retryMessage(messageId: string): void;
+    /**
+     * Queue a local file as an attachment. The native side reads bytes from
+     * `uri`, pushes them through the SDK's upload pipeline, and bundles the
+     * uploaded reference into the next `sendMessage()`.
+     */
+    attachFile(opts: AttachmentInput): Promise<void>;
+    /**
+     * Subscribe to a native event. Returns an unsubscribe function — call it
+     * when your component unmounts to avoid leaks.
+     */
+    addListener<K extends EventName>(event: K, handler: EventHandler<K>): () => void;
+    /**
+     * Tear down the native SDK. After this the instance is unusable —
+     * construct a new one if you need to chat again.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,69 @@
+/**
+ * Public types for `react-native-newinstance-chat`.
+ *
+ * Shapes match what the native bridges produce, normalised across
+ * iOS / Android (e.g. message status / error type / connection state
+ * are lowercased string enums, not platform-specific enum values).
+ */
+export interface NewinstanceChatConfig {
+    /** API key id from your newinstance.cloud dashboard. Never embed the secret half. */
+    apiKey: string;
+    /** Backend base URL. Defaults to `https://service.newinstance.cloud`. */
+    baseUrl?: string;
+    /** Subscription transport. `'sse'` (default in production), `'ws'`, or omit to let the server choose. */
+    transport?: 'sse' | 'ws';
+    /** Optional message pre-seeded as the first outbound message. */
+    initialMessage?: string;
+}
+export interface ChatUser {
+    customerName: string;
+    customerEmail?: string;
+    customerId?: string;
+}
+/** A local file the native side reads bytes from. */
+export interface AttachmentInput {
+    /** Local file URI: `file://...` (iOS) or `content://...` / `file://...` (Android). */
+    uri: string;
+    name: string;
+    mimeType: string;
+}
+export type ConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'offline';
+export interface ChatMessage {
+    id: string;
+    /** Client-side id used to dedupe a sent message against its server echo. */
+    clientId?: string;
+    conversationId: string;
+    content: string;
+    /** Lowercased enum from the native side: `'text'`, `'image'`, etc. */
+    type: string;
+    /** Lowercased enum: `'sent'`, `'delivered'`, `'failed'`, etc. */
+    status: string;
+    /** Server-assigned monotonic sequence number for ordering. */
+    seq?: number;
+    /** ISO-8601 timestamp string. */
+    sentAt?: string;
+    /**
+     * Total persisted messages in the conversation as of this envelope.
+     * Only present on `messageReceived`. The SDK uses this for silent
+     * gap-fill — if the locally-rendered count is below this, it refetches.
+     */
+    totalMessages?: number;
+}
+export type NewinstanceChatErrorType = 'network' | 'validation' | 'auth' | 'system';
+export interface NewinstanceChatError {
+    type: NewinstanceChatErrorType;
+    message: string;
+    recoverable: boolean;
+}
+/** Native event names. Subscribe with `sdk.addListener(event, handler)`. */
+export interface EventMap {
+    messageReceived: (message: ChatMessage) => void;
+    messageSent: (message: ChatMessage) => void;
+    agentTypingChanged: (isTyping: boolean) => void;
+    connectionStateChanged: (state: ConnectionState) => void;
+    unreadCountChanged: (count: number) => void;
+    error: (e: NewinstanceChatError) => void;
+}
+export type EventName = keyof EventMap;
+export type EventHandler<K extends EventName> = EventMap[K];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}