react-native-newinstance-chat 0.2.0 → 0.4.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.2.0"
+  s.dependency "LiveAndAiChat", "~> 0.4.0"
 
   install_modules_dependencies(s)
 end

package/README.md

@@ -1,17 +1,17 @@
 # react-native-newinstance-chat
 
-React Native bindings for [LiveAndAiChat](https://newinstance.cloud) — drops a
+React Native bindings for [LiveAndAiChat](https://newinstance.cloud). Drops a
 complete AI + live-agent chat experience into your iOS and Android RN app
 via native module bridges.
 
 The chat UI, transport, attachments, image cache, typing indicators, and
 silent gap-fill resync all come from the native iOS / Android SDKs. This
-package is a thin TurboModule surface over them — your React Native code
+package is a thin TurboModule surface over them, so your React Native code
 stays small.
 
 ## Requirements
 
-- React Native 0.74+ (TurboModule support — recommended 0.85+)
+- React Native 0.74+ (TurboModule support; 0.85+ recommended)
 - iOS 15.1+
 - Android API 24+, JDK 17
 
@@ -45,7 +45,7 @@ cd ios && pod install
 ### Android
 
 Autolink registers `NewinstanceChatPackage`. The underlying
-`cloud.newinstance:liveandaichat` AAR is resolved from Maven Central —
+`cloud.newinstance:liveandaichat` AAR is resolved from Maven Central, so
 ensure `mavenCentral()` is in `settings.gradle.kts`.
 
 ## Quick start
@@ -54,26 +54,212 @@ ensure `mavenCentral()` is in `settings.gradle.kts`.
 import { NewinstanceChat } from 'react-native-newinstance-chat';
 
 const sdk = new NewinstanceChat({
-  apiKey: 'sk_live_…',
+  customerToken: tokenFromYourBackend,
+});
+
+await sdk.ready;
+await sdk.initialize();
+
+sdk.openChat();
+```
+
+`sdk.ready` resolves once the native module is configured. It rejects with
+an error whose `code` is `E_CONFIG` when the configuration is invalid, and
+`initialize()` rejects with the same error.
+
+The chat screen renders natively, so there is no React component to mount.
+Your RN UI is whatever button, banner or FAB triggers `openChat()`.
+
+## Authentication
+
+The SDK runs in exactly one of two modes. Pass `customerToken` **or**
+`apiKey`, never both. Passing both, or neither, rejects `ready` with
+`E_CONFIG` and the message
+`pass either apiKey (keyId:secret) or customerToken`. Blank strings count
+as absent.
+
+### JWT mode (`customerToken`), for apps you ship to the public
+
+Your backend mints a short-lived chat token for the signed-in customer and
+hands it to the app. The native SDK sends it as `Authorization: Bearer <token>`
+on every request. The customer's identity comes only from the token's signed
+claims, so a tampered app cannot claim to be someone else, and your API key
+never leaves your server.
+
+Mint the token on your backend, on the REST API host
+(`baseUrl` below is `https://api.newinstance.cloud`), with your full
+`keyId:secret` key. Server side only:
+
+```
+POST {baseUrl}/api/v1/chat/sessions
+x-api-key: sk_live_abc123:YOUR_SECRET_KEY
+Content-Type: application/json
+
+{
+  "customerId": "usr_123",
+  "customerName": "Ada Lovelace",
+  "customerEmail": "ada@example.com",
+  "customerPhone": "+44 20 7946 0958",
+  "metadata": { "plan": "enterprise" },
+  "expiresInSeconds": 3600
+}
+```
+
+`customerId` and `customerName` are required; `customerEmail`,
+`customerPhone`, `metadata` and `expiresInSeconds` are optional. The
+response is:
+
+```json
+{
+  "token": "eyJhbGciOi...",
+  "expiresAt": "2026-09-29T13:00:00.000Z",
+  "expiresInSeconds": 3600,
+  "session": { "sessionId": "...", "customerId": "usr_123", "status": "active" }
+}
+```
+
+For example, a Node backend route the app calls after sign-in:
+
+```ts
+app.post('/chat-token', requireSignedInUser, async (req, res) => {
+  const response = await fetch(
+    'https://api.newinstance.cloud/api/v1/chat/sessions',
+    {
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json',
+        'x-api-key': process.env.NEWINSTANCE_API_KEY,
+      },
+      body: JSON.stringify({
+        customerId: req.user.id,
+        customerName: req.user.name,
+        customerEmail: req.user.email,
+        expiresInSeconds: 3600,
+      }),
+    }
+  );
+  const { token, expiresAt } = await response.json();
+  res.json({ token, expiresAt });
+});
+```
+
+Hand `token` to the app and pass it in the config:
+
+```ts
+const { token } = await fetch('https://your-backend.example.com/chat-token', {
+  method: 'POST',
+}).then((r) => r.json());
+
+const sdk = new NewinstanceChat({ customerToken: token });
+await sdk.ready;
+await sdk.initialize();
+```
+
+Tokens expire (one hour by default, 60 seconds to 24 hours via
+`expiresInSeconds`). When the token expires or is revoked, the server
+rejects it and the `error` event fires with `type: 'auth'` and
+`code: 'INVALID_IDENTITY_TOKEN'`. The SDK stops instead of reconnecting with
+the same token. Fetch a fresh token from your backend and swap it in with
+`setUserToken`. The SDK keeps running and keeps the conversation:
+
+```ts
+sdk.addListener('error', async (e) => {
+  if (e.code === 'INVALID_IDENTITY_TOKEN') {
+    await sdk.setUserToken(await fetchFreshTokenFromYourBackend());
+  }
+});
+```
+
+`setUserToken` updates the credential for every later request, rebuilds the
+realtime connection with the new token, and restarts initialization if the
+auth failure stopped it. The stored conversation is kept unless the new
+token belongs to a different customer. A blank token throws `E_CONFIG` with
+the message `customerToken must not be blank`.
+
+A customer holds **one** live session at a time, so minting while their
+token is still valid returns `409` with the existing session. To rotate a
+token before it expires, your backend must first revoke the session
+(`DELETE /api/v1/chat/sessions?customerId=...`, also the sign-out call) and
+then mint a new one. Revocation takes effect on the next request, so an
+invalidated token stops working immediately.
+
+In JWT mode `setUser` is accepted but ignored for identity: the name, email
+and customer id always come from the token.
+
+### Key mode (`apiKey`), for trusted internal apps only
+
+**Key mode ships your secret key inside the app.** Anyone who has the app
+binary can extract it. Use key mode only for trusted internal apps (staff
+tools, kiosks, test builds), never for apps distributed to the public. Use
+JWT mode for those.
+
+`apiKey` is the full `keyId:secret` key from your dashboard. The native SDK
+sends it whole as `x-api-key` on every request. A key ID without its secret
+rejects `ready` with `E_CONFIG` and the message
+`apiKey must be keyId:secret, or use customerToken`.
+
+```ts
+const sdk = new NewinstanceChat({
+  apiKey: keyFromYourBuildConfig,
 });
 
 sdk.setUser({
   customerName: 'Ada Lovelace',
   customerEmail: 'ada@example.com',
+  customerId: 'usr_123',
 });
 
+await sdk.ready;
 await sdk.initialize();
+```
 
-// `sdk.ready` is a Promise that resolves once the native module is configured -
-// await it anywhere you need to know setup completed.
-await sdk.ready;
+Load the key from your build configuration or an environment variable, and
+never commit it to source control.
 
-// Later, in response to a host button tap:
-sdk.openChat();
+In key mode `setUser` supplies the customer. `setUserToken` is not
+available and throws synchronously with `E_CONFIG` and the message
+`setUserToken is only available when the SDK is configured with customerToken`.
+A rejected key arrives on the error event as `INVALID_PUBLIC_KEY`.
+
+### Migrating from 0.3.x
+
+- `ChatUser.customerToken` is gone. Passing `customerToken` to `setUser`
+  throws `E_CONFIG` with the message
+  `customerToken is not a setUser field; pass it in the config or call setUserToken`.
+  Put the token in the config (`customerToken`) and use `setUserToken` to
+  swap it.
+- `apiKey` is now the full `keyId:secret` and is sent whole. A bare key ID
+  is rejected. Prefer JWT mode for public apps.
+- `setUserToken` returns a Promise and is only available in JWT mode.
+
+### Theming
+
+The chat resolves colours from three layers:
+
+```
+dashboard theme  >  your local theme  >  the SDK's built-in theme
+```
+
+The merchant's dashboard configuration wins, your local theme fills in what
+the dashboard did not set, and the built-in palette fills in the rest, so
+every colour always has a value, even with no network. Merging is per
+token, so setting one colour does not discard the others.
+
+```ts
+const sdk = new NewinstanceChat({
+  customerToken: tokenFromYourBackend,
+  theme: { mode: 'dark', sentBubble: '#16A34A' },
+});
 ```
 
-The chat screen renders natively — there is no React component to mount.
-Your RN UI is whatever button / banner / FAB triggers `openChat()`.
+Every `ChatThemeOverride` field is optional; colours are hex strings. An
+unparseable value is ignored rather than throwing. `mode` is only a
+preference: the dashboard's explicit light/dark wins, and its `auto` defers
+to yours, then to the device.
+
+If remote configuration cannot be fetched, your local theme still applies
+and the chat stays fully usable; you get a `CONFIG_FETCH_FAILED` warning on
+the error event.
 
 ### Subscribing to events
 
@@ -89,6 +275,47 @@ Event names: `messageReceived`, `messageSent`, `agentTypingChanged`,
 `connectionStateChanged`, `unreadCountChanged`, `error`,
 `attachmentUpdated`, `chatClosed`. See `src/types.ts` for payload shapes.
 
+### The error event
+
+`error` is the channel for "why is my chat not working". It never surfaces
+in the chat interface the customer sees, and it never carries the API key,
+the secret, the customer token, or customer data.
+
+```ts
+sdk.addListener('error', (e) => {
+  if (e.code === 'INVALID_IDENTITY_TOKEN') return refreshChatToken();
+  if (!e.recoverable) reportToYourMonitoring(e.code, e.message);
+});
+```
+
+| `code` | What went wrong |
+|---|---|
+| `MISSING_WIDGET_KEY` | No API key was supplied |
+| `INVALID_PUBLIC_KEY` | Key mode: the key was rejected (wrong key, wrong environment, revoked, expired) |
+| `CHAT_CONFIG_UNAVAILABLE` | The credential is fine, but the organization has no chat configuration |
+| `CHAT_DISABLED` | Chat is switched off in the dashboard |
+| `CONFIG_FETCH_FAILED` | Remote configuration could not be loaded; the local/built-in theme is in use |
+| `INVALID_IDENTITY_TOKEN` | JWT mode: the token was malformed, expired, revoked, or signed for another organization |
+| `NETWORK_ERROR` | The backend could not be reached |
+| `TRANSPORT_ERROR` | The realtime connection dropped |
+| `CHAT_INITIALIZATION_FAILED` | The conversation could not be started |
+| `MESSAGE_SEND_FAILED` | A message could not be delivered |
+| `ATTACHMENT_FAILED` | An attachment could not be uploaded |
+| `SERVER_ERROR` | The backend returned something unusable |
+
+Auth failures (`type: 'auth'`) report `INVALID_IDENTITY_TOKEN` in JWT mode
+and `INVALID_PUBLIC_KEY` in key mode. After an auth failure the SDK does not
+reconnect with the same credential.
+
+The same codes are emitted by the web, Android, iOS and Flutter SDKs.
+`type` (`network` / `validation` / `auth` / `system`) is still present for
+handlers written against 0.2.x; `code` is `undefined` only when the
+underlying native SDK predates coded errors.
+
+Configuration mistakes are not emitted on the error event. They are thrown
+(or reject `ready`) as an `Error` with `code: 'E_CONFIG'`,
+`type: 'validation'` and `recoverable: false`.
+
 ### The chat-close event
 
 `chatClosed` fires **exactly once per chat presentation**, however the
@@ -127,8 +354,8 @@ 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.
+`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
@@ -155,8 +382,8 @@ 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
+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`:
@@ -182,7 +409,7 @@ 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.
+by the native chat screen; there's nothing to wire up from the host.
 
 ### Tear-down
 
@@ -191,7 +418,25 @@ sdk.destroy();
 ```
 
 Call this when your host component unmounts. After `destroy()` the
-instance is unusable — construct a new one if you need to chat again.
+instance is unusable; construct a new one if you need to chat again.
+
+## Example app
+
+The example app in `example/` runs in JWT mode by default and fetches a
+token from the placeholder URL `https://your-backend.example.com/chat-token`
+in `example/src/App.tsx`. Point it at your own backend route.
+
+To try key mode on a trusted development build instead, set the key in the
+environment before starting Metro. Nothing is committed to the repository:
+
+```sh
+NEWINSTANCE_API_KEY='sk_test_abc123:YOUR_SECRET_KEY' yarn example start --reset-cache
+```
+
+`NEWINSTANCE_BASE_URL` optionally points a debug build at another backend.
+Both variables are empty by default and are inlined by
+`example/babel.config.js`, so restart Metro with `--reset-cache` after
+changing them.
 
 ## Contributing
 

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.2.0"
+  implementation "cloud.newinstance:liveandaichat:0.4.0"
 }

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

@@ -1,10 +1,14 @@
 package com.newinstancechat
 
+import cloud.newinstance.liveandaichat.ChatAuthMode
 import cloud.newinstance.liveandaichat.ConnectionState
 import cloud.newinstance.liveandaichat.LiveAndAiChat
 import cloud.newinstance.liveandaichat.LiveAndAiChatConfig
 import cloud.newinstance.liveandaichat.LiveAndAiChatError
+import cloud.newinstance.liveandaichat.ChatSdkError
+import cloud.newinstance.liveandaichat.ChatThemeOverride
 import cloud.newinstance.liveandaichat.ChatUser
+import cloud.newinstance.liveandaichat.ErrorType
 import cloud.newinstance.liveandaichat.model.AttachmentRequest
 import cloud.newinstance.liveandaichat.model.AttachmentSource
 import cloud.newinstance.liveandaichat.model.ChatCloseEvent
@@ -15,6 +19,7 @@ import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.ReadableType
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.DeviceEventManagerModule
 
@@ -39,6 +44,8 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
   private var sdk: LiveAndAiChat? = null
   private var pendingUser: ChatUser? = null
 
+  private var usingIdentityToken: Boolean = false
+
   override fun getName(): String = NAME
 
   private fun emit(event: String, body: Any?) {
@@ -50,9 +57,10 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
   // MARK: - configure / setUser / initialize
 
   override fun configure(config: ReadableMap, promise: Promise) {
-    val apiKey = config.getString("apiKey")
-    if (apiKey.isNullOrBlank()) {
-      promise.reject("E_CONFIG", "apiKey is required")
+    val apiKey = config.getString("apiKey")?.trim()?.takeIf { it.isNotEmpty() }
+    val customerToken = config.getString("customerToken")?.trim()?.takeIf { it.isNotEmpty() }
+    if ((apiKey == null) == (customerToken == null)) {
+      promise.reject("E_CONFIG", "pass either apiKey (keyId:secret) or customerToken")
       return
     }
     val baseUrl = if (config.hasKey("baseUrl")) config.getString("baseUrl") else null
@@ -66,12 +74,26 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
       }
     } else null
 
+    val themeOverride = if (config.hasKey("theme")) {
+      config.getMap("theme")?.let { map ->
+        val values = mutableMapOf<String, String?>()
+        val it = map.keySetIterator()
+        while (it.hasNextKey()) {
+          val key = it.nextKey()
+          if (map.getType(key) == ReadableType.String) values[key] = map.getString(key)
+        }
+        ChatThemeOverride.fromMap(values)
+      }
+    } else null
+
     try {
       val cfg = LiveAndAiChatConfig(
         apiKey = apiKey,
+        customerToken = customerToken,
         baseUrl = baseUrl ?: LiveAndAiChatConfig.DEFAULT_BASE_URL,
         transport = transport,
         initialMessage = initialMessage,
+        theme = themeOverride,
       )
       sdk?.destroy()
       val builder = LiveAndAiChat.Builder(reactApplicationContext).config(cfg)
@@ -79,16 +101,18 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
       val instance = builder.build()
       instance.addListener(this)
       sdk = instance
+      usingIdentityToken = cfg.authMode == ChatAuthMode.CUSTOMER_TOKEN
       pendingUser = null
       promise.resolve(null)
+    } catch (e: LiveAndAiChatError) {
+      promise.reject(e.code ?: "E_BUILD", e.message, e)
     } catch (e: Exception) {
       promise.reject("E_BUILD", e.message, e)
     }
   }
 
   override fun setUser(user: ReadableMap) {
-    val name = user.getString("customerName") ?: return
-    if (name.isBlank()) return
+    val name = user.getString("customerName")?.takeIf { it.isNotBlank() } ?: return
     val chatUser = ChatUser(
       customerName = name,
       customerId = if (user.hasKey("customerId")) user.getString("customerId") else null,
@@ -102,6 +126,22 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  override fun setUserToken(token: String, promise: Promise) {
+    val current = sdk
+    if (current == null) {
+      promise.reject("E_NOT_CONFIGURED", "configure() must be called first")
+      return
+    }
+    try {
+      current.setUserToken(token)
+      promise.resolve(null)
+    } catch (e: LiveAndAiChatError) {
+      promise.reject(e.code ?: "E_CONFIG", e.message, e)
+    } catch (e: Exception) {
+      promise.reject("E_CONFIG", e.message, e)
+    }
+  }
+
   override fun initialize(promise: Promise) {
     val current = sdk
     if (current == null) {
@@ -143,7 +183,7 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
     if (source == null) {
       promise.reject(
         "E_SOURCE",
-        if (sourceType == "auto") "Could not detect the attachment source type — pass sourceType explicitly"
+        if (sourceType == "auto") "Could not detect the attachment source type: pass sourceType explicitly"
         else "Unknown sourceType: $sourceType",
       )
       return
@@ -240,12 +280,39 @@ class NewinstanceChatModule(reactContext: ReactApplicationContext) :
 
   override fun onError(error: LiveAndAiChatError) {
     val map = Arguments.createMap()
+    map.putString("code", sdkErrorCode(error))
     map.putString("type", error.type.name.lowercase())
     map.putString("message", error.message)
     map.putBoolean("recoverable", error.recoverable)
     emit("error", map)
   }
 
+  private fun sdkErrorCode(error: LiveAndAiChatError): String {
+    val known = setOf(
+      ChatSdkError.CHAT_CONFIG_UNAVAILABLE,
+      ChatSdkError.CHAT_DISABLED,
+      ChatSdkError.INVALID_PUBLIC_KEY,
+      ChatSdkError.MISSING_WIDGET_KEY,
+      ChatSdkError.CONFIG_FETCH_FAILED,
+      ChatSdkError.CHAT_INITIALIZATION_FAILED,
+      ChatSdkError.NETWORK_ERROR,
+      ChatSdkError.SERVER_ERROR,
+      ChatSdkError.INVALID_IDENTITY_TOKEN,
+      ChatSdkError.TRANSPORT_ERROR,
+      ChatSdkError.MESSAGE_SEND_FAILED,
+      ChatSdkError.ATTACHMENT_FAILED,
+    )
+    error.code?.let { if (it in known) return it }
+    return when (error.type) {
+      ErrorType.AUTH ->
+        if (usingIdentityToken) ChatSdkError.INVALID_IDENTITY_TOKEN else ChatSdkError.INVALID_PUBLIC_KEY
+      ErrorType.UNAVAILABLE -> ChatSdkError.CHAT_CONFIG_UNAVAILABLE
+      ErrorType.NETWORK -> ChatSdkError.NETWORK_ERROR
+      ErrorType.VALIDATION -> ChatSdkError.SERVER_ERROR
+      ErrorType.SYSTEM -> ChatSdkError.CHAT_INITIALIZATION_FAILED
+    }
+  }
+
   // MARK: - Helpers
 
   private fun chatMessageToMap(m: ChatMessage): WritableMap {

package/ios/NewinstanceChat.mm

@@ -56,6 +56,13 @@ RCT_EXPORT_MODULE()
   [_impl setUser:user];
 }
 
+- (void)setUserToken:(NSString *)token
+             resolve:(RCTPromiseResolveBlock)resolve
+              reject:(RCTPromiseRejectBlock)reject
+{
+  [_impl setUserToken:token resolver:resolve rejecter:reject];
+}
+
 - (void)initialize:(RCTPromiseResolveBlock)resolve
             reject:(RCTPromiseRejectBlock)reject
 {

package/ios/NewinstanceChatImpl.swift

@@ -29,14 +29,18 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
   private var sdk: LiveAndAiChat?
   private var pendingUser: ChatUser?
 
+  private var usingIdentityToken: Bool = false
+
   // 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)
+    let apiKey = Self.nonBlank(configDict["apiKey"])
+    let customerToken = Self.nonBlank(configDict["customerToken"])
+    guard (apiKey == nil) != (customerToken == nil) else {
+      rejecter("E_CONFIG", "pass either apiKey (keyId:secret) or customerToken", nil)
       return
     }
     let baseUrl = configDict["baseUrl"] as? String
@@ -49,14 +53,25 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
       }
     }()
 
+    let themeOverride: ChatThemeOverride? = {
+      guard let raw = configDict["theme"] as? NSDictionary else { return nil }
+      var values: [String: String] = [:]
+      for (key, value) in raw {
+        if let k = key as? String, let v = value as? String { values[k] = v }
+      }
+      return values.isEmpty ? nil : ChatThemeOverride.fromDictionary(values)
+    }()
+
     DispatchQueue.main.async { [weak self] in
       guard let self = self else { return }
       do {
         let cfg = try LiveAndAiChatConfig(
           apiKey: apiKey,
+          customerToken: customerToken,
           baseUrl: baseUrl ?? LiveAndAiChatConfig.defaultBaseUrl,
           transport: transport,
-          initialMessage: initialMessage
+          initialMessage: initialMessage,
+          theme: themeOverride
         )
         let builder = LiveAndAiChat.Builder().config(cfg)
         if let user = self.pendingUser { _ = builder.user(user) }
@@ -64,10 +79,11 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
         let instance = try builder.build()
         instance.addDelegate(self)
         self.sdk = instance
+        self.usingIdentityToken = cfg.authMode == .customerToken
         self.pendingUser = nil
         resolver(nil)
       } catch let e as LiveAndAiChatError {
-        rejecter("E_BUILD", e.message, e)
+        rejecter(e.code ?? "E_BUILD", e.message, e)
       } catch {
         rejecter("E_BUILD", error.localizedDescription, error)
       }
@@ -76,7 +92,7 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
 
   @objc(setUser:)
   public func setUser(_ userDict: NSDictionary) {
-    guard let name = userDict["customerName"] as? String, !name.isEmpty else { return }
+    guard let name = (userDict["customerName"] as? String).flatMap({ $0.isEmpty ? nil : $0 }) else { return }
     let user = ChatUser(
       customerName: name,
       customerId: userDict["customerId"] as? String,
@@ -92,6 +108,26 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
     }
   }
 
+  @objc(setUserToken:resolver:rejecter:)
+  public func setUserToken(_ token: String,
+                           resolver: @escaping RCTPromiseResolveBlock,
+                           rejecter: @escaping RCTPromiseRejectBlock) {
+    DispatchQueue.main.async { [weak self] in
+      guard let sdk = self?.sdk else {
+        rejecter("E_NOT_CONFIGURED", "configure() must be called first", nil)
+        return
+      }
+      do {
+        try sdk.setUserToken(token)
+        resolver(nil)
+      } catch let e as LiveAndAiChatError {
+        rejecter(e.code ?? "E_CONFIG", e.message, e)
+      } catch {
+        rejecter("E_CONFIG", error.localizedDescription, error)
+      }
+    }
+  }
+
   @objc(initializeWithResolver:rejecter:)
   public func initialize(resolver: @escaping RCTPromiseResolveBlock,
                          rejecter: @escaping RCTPromiseRejectBlock) {
@@ -153,7 +189,7 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
       rejecter(
         "E_SOURCE",
         sourceType == "auto"
-          ? "Could not detect the attachment source type — pass sourceType explicitly"
+          ? "Could not detect the attachment source type: pass sourceType explicitly"
           : "Unknown sourceType: \(sourceType)",
         nil
       )
@@ -247,6 +283,7 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
   }
   public func didEncounterError(_ error: LiveAndAiChatError) {
     emitter?.emitEvent("error", body: [
+      "code": error.sdkCode(usingIdentityToken: usingIdentityToken),
       "type": Self.errorTypeName(error.type),
       "message": error.message,
       "recoverable": error.recoverable,
@@ -255,6 +292,11 @@ public final class NewinstanceChatImpl: NSObject, LiveAndAiChatDelegate {
 
   // MARK: - Helpers
 
+  private static func nonBlank(_ value: Any?) -> String? {
+    guard let text = (value as? String)?.trimmingCharacters(in: .whitespacesAndNewlines), !text.isEmpty else { return nil }
+    return text
+  }
+
   private static func chatMessageToDict(_ m: ChatMessage) -> [String: Any?] {
     return [
       "id": m.id,

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;;AAoBA,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;;AAqBA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,iBAAiB,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -7,6 +7,27 @@ import NativeNewinstanceChat from "./NativeNewinstanceChat.js";
 // we feed it the legacy handle so listener counts get tracked.
 const emitterSource = NativeModules.NewinstanceChat ?? NativeNewinstanceChat;
 const emitter = new NativeEventEmitter(emitterSource);
+function trimmed(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+function configProblem(apiKey, customerToken) {
+  if (!apiKey === !customerToken) {
+    return 'pass either apiKey (keyId:secret) or customerToken';
+  }
+  if (customerToken) return null;
+  const separator = apiKey.indexOf(':');
+  if (separator < 0 || !apiKey.slice(0, separator).trim() || !apiKey.slice(separator + 1).trim()) {
+    return 'apiKey must be keyId:secret, or use customerToken';
+  }
+  return null;
+}
+function configError(message) {
+  return Object.assign(new Error(message), {
+    code: 'E_CONFIG',
+    type: 'validation',
+    recoverable: false
+  });
+}
 
 /**
  * React Native binding for the native LiveAndAiChat iOS / Android SDKs.
@@ -22,7 +43,22 @@ export class NewinstanceChat {
   /** Resolves once the native SDK is configured. */
 
   constructor(config) {
-    this.ready = NativeNewinstanceChat.configure(config);
+    const {
+      apiKey,
+      customerToken,
+      ...rest
+    } = config;
+    const key = trimmed(apiKey);
+    const token = trimmed(customerToken);
+    this.customerTokenMode = !key && !!token;
+    const problem = configProblem(key, token);
+    this.ready = problem ? Promise.reject(configError(problem)) : NativeNewinstanceChat.configure(token ? {
+      ...rest,
+      customerToken: token
+    } : {
+      ...rest,
+      apiKey: key
+    });
   }
 
   /**
@@ -31,8 +67,19 @@ export class NewinstanceChat {
    * once the native instance exists.
    */
   setUser(user) {
+    if ('customerToken' in user) {
+      throw configError('customerToken is not a setUser field; pass it in the config or call setUserToken');
+    }
     NativeNewinstanceChat.setUser(user);
   }
+  setUserToken(customerToken) {
+    if (!this.customerTokenMode) {
+      throw configError('setUserToken is only available when the SDK is configured with customerToken');
+    }
+    const token = trimmed(customerToken);
+    if (!token) throw configError('customerToken must not be blank');
+    return NativeNewinstanceChat.setUserToken(token);
+  }
 
   /**
    * Fetch org config, restore the saved conversation, and connect the
@@ -40,7 +87,7 @@ export class NewinstanceChat {
    * the same in-flight init.
    */
   initialize() {
-    return NativeNewinstanceChat.initialize();
+    return this.ready.then(() => NativeNewinstanceChat.initialize());
   }
 
   /** Present the native chat screen modally over the current RN host. */

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","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":[]}
+{"version":3,"names":["NativeEventEmitter","NativeModules","NativeNewinstanceChat","emitterSource","NewinstanceChat","emitter","trimmed","value","trim","configProblem","apiKey","customerToken","separator","indexOf","slice","configError","message","Object","assign","Error","code","type","recoverable","constructor","config","rest","key","token","customerTokenMode","problem","ready","Promise","reject","configure","setUser","user","setUserToken","initialize","then","openChat","closeChat","sendMessage","text","retryMessage","messageId","attachFile","opts","source","uri","removeAttachment","id","clearAttachments","addListener","event","handler","sub","remove","destroy"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -12,6 +12,7 @@ import { type TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
     configure(config: Object): Promise<void>;
     setUser(user: Object): void;
+    setUserToken(token: string): Promise<void>;
     initialize(): Promise<void>;
     openChat(): void;
     closeChat(): 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,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"}
+{"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,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,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

@@ -1,5 +1,5 @@
 import type { AttachmentInput, ChatUser, EventHandler, EventName, NewinstanceChatConfig } from './types';
-export type { AttachmentInput, ChatMessage, ChatUser, ConnectionState, EventMap, EventName, NewinstanceChatConfig, NewinstanceChatError, NewinstanceChatErrorType, } from './types';
+export type { AttachmentInput, AttachmentUpdate, ChatClosedEvent, ChatMessage, ChatThemeOverride, ChatUser, ConnectionState, EventMap, EventName, NewinstanceChatConfig, NewinstanceChatError, NewinstanceChatErrorCode, NewinstanceChatErrorType, } from './types';
 /**
  * React Native binding for the native LiveAndAiChat iOS / Android SDKs.
  *
@@ -13,6 +13,7 @@ export type { AttachmentInput, ChatMessage, ChatUser, ConnectionState, EventMap,
 export declare class NewinstanceChat {
     /** Resolves once the native SDK is configured. */
     readonly ready: Promise<void>;
+    private readonly customerTokenMode;
     constructor(config: NewinstanceChatConfig);
     /**
      * Identify the customer. Safe to call before or after `initialize()`. If
@@ -20,6 +21,7 @@ export declare class NewinstanceChat {
      * once the native instance exists.
      */
     setUser(user: ChatUser): void;
+    setUserToken(customerToken: string): Promise<void>;
     /**
      * Fetch org config, restore the saved conversation, and connect the
      * subscription transport in the background. Concurrent callers share

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,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"}
+{"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,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,SAAS,CAAC;AAqCjB;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;gBAEhC,MAAM,EAAE,qBAAqB;IAazC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAS7B,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD;;;;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;IASlD,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

@@ -6,14 +6,43 @@
  * 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;
+    apiKey?: string;
+    customerToken?: 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;
+    theme?: ChatThemeOverride;
+}
+export interface ChatThemeOverride {
+    mode?: 'light' | 'dark';
+    chatBackground?: string;
+    headerBackground?: string;
+    headerPrimaryText?: string;
+    headerSecondaryText?: string;
+    headerIcon?: string;
+    closeButton?: string;
+    receivedBubble?: string;
+    receivedText?: string;
+    receivedTimestamp?: string;
+    sentBubble?: string;
+    sentText?: string;
+    sentTimestamp?: string;
+    systemMessageText?: string;
+    daySeparatorBackground?: string;
+    daySeparatorText?: string;
+    footerContainer?: string;
+    chatInputBackground?: string;
+    chatInputText?: string;
+    chatInputPlaceholder?: string;
+    chatInputBorder?: string;
+    sendButtonBackground?: string;
+    sendButtonIcon?: string;
+    attachmentButton?: string;
+    unreadBadgeBackground?: string;
+    unreadBadgeText?: string;
 }
 export interface ChatUser {
     customerName: string;
@@ -101,9 +130,12 @@ export interface ChatMessage {
     totalMessages?: number;
 }
 export type NewinstanceChatErrorType = 'network' | 'validation' | 'auth' | 'system';
+export type NewinstanceChatErrorCode = 'INVALID_PUBLIC_KEY' | 'MISSING_WIDGET_KEY' | 'CHAT_CONFIG_UNAVAILABLE' | 'CHAT_DISABLED' | 'CONFIG_FETCH_FAILED' | 'INVALID_IDENTITY_TOKEN' | 'NETWORK_ERROR' | 'TRANSPORT_ERROR' | 'CHAT_INITIALIZATION_FAILED' | 'MESSAGE_SEND_FAILED' | 'ATTACHMENT_FAILED' | 'SERVER_ERROR';
 export interface NewinstanceChatError {
+    code?: NewinstanceChatErrorCode;
     type: NewinstanceChatErrorType;
     message: string;
+    developerMessage?: string;
     recoverable: boolean;
 }
 /** Native event names. Subscribe with `sdk.addListener(event, handler)`. */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"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.2.0",
-  "description": "New instance LiveAndAiChat React Native SDK \u2014 AI + live-agent chat, drop-in native chat screen for iOS and Android.",
+  "version": "0.4.0",
+  "description": "New instance LiveAndAiChat React Native SDK: 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": {

package/src/NativeNewinstanceChat.ts

@@ -13,6 +13,7 @@ import { TurboModuleRegistry, type TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
   configure(config: Object): Promise<void>;
   setUser(user: Object): void;
+  setUserToken(token: string): Promise<void>;
   initialize(): Promise<void>;
   openChat(): void;
   closeChat(): void;

package/src/index.tsx

@@ -15,13 +15,17 @@ import type {
 
 export type {
   AttachmentInput,
+  AttachmentUpdate,
+  ChatClosedEvent,
   ChatMessage,
+  ChatThemeOverride,
   ChatUser,
   ConnectionState,
   EventMap,
   EventName,
   NewinstanceChatConfig,
   NewinstanceChatError,
+  NewinstanceChatErrorCode,
   NewinstanceChatErrorType,
 } from './types';
 
@@ -32,6 +36,34 @@ const emitterSource: any =
   NativeModules.NewinstanceChat ?? (NativeNewinstanceChat as unknown);
 const emitter = new NativeEventEmitter(emitterSource);
 
+function trimmed(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function configProblem(apiKey: string, customerToken: string): string | null {
+  if (!apiKey === !customerToken) {
+    return 'pass either apiKey (keyId:secret) or customerToken';
+  }
+  if (customerToken) return null;
+  const separator = apiKey.indexOf(':');
+  if (
+    separator < 0 ||
+    !apiKey.slice(0, separator).trim() ||
+    !apiKey.slice(separator + 1).trim()
+  ) {
+    return 'apiKey must be keyId:secret, or use customerToken';
+  }
+  return null;
+}
+
+function configError(message: string) {
+  return Object.assign(new Error(message), {
+    code: 'E_CONFIG' as const,
+    type: 'validation' as const,
+    recoverable: false,
+  });
+}
+
 /**
  * React Native binding for the native LiveAndAiChat iOS / Android SDKs.
  *
@@ -45,9 +77,19 @@ const emitter = new NativeEventEmitter(emitterSource);
 export class NewinstanceChat {
   /** Resolves once the native SDK is configured. */
   readonly ready: Promise<void>;
+  private readonly customerTokenMode: boolean;
 
   constructor(config: NewinstanceChatConfig) {
-    this.ready = NativeNewinstanceChat.configure(config);
+    const { apiKey, customerToken, ...rest } = config;
+    const key = trimmed(apiKey);
+    const token = trimmed(customerToken);
+    this.customerTokenMode = !key && !!token;
+    const problem = configProblem(key, token);
+    this.ready = problem
+      ? Promise.reject(configError(problem))
+      : NativeNewinstanceChat.configure(
+          token ? { ...rest, customerToken: token } : { ...rest, apiKey: key }
+        );
   }
 
   /**
@@ -56,16 +98,32 @@ export class NewinstanceChat {
    * once the native instance exists.
    */
   setUser(user: ChatUser): void {
+    if ('customerToken' in user) {
+      throw configError(
+        'customerToken is not a setUser field; pass it in the config or call setUserToken'
+      );
+    }
     NativeNewinstanceChat.setUser(user);
   }
 
+  setUserToken(customerToken: string): Promise<void> {
+    if (!this.customerTokenMode) {
+      throw configError(
+        'setUserToken is only available when the SDK is configured with customerToken'
+      );
+    }
+    const token = trimmed(customerToken);
+    if (!token) throw configError('customerToken must not be blank');
+    return NativeNewinstanceChat.setUserToken(token);
+  }
+
   /**
    * 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> {
-    return NativeNewinstanceChat.initialize();
+    return this.ready.then(() => NativeNewinstanceChat.initialize());
   }
 
   /** Present the native chat screen modally over the current RN host. */
@@ -93,7 +151,9 @@ export class NewinstanceChat {
    */
   attachFile(opts: AttachmentInput): Promise<string> {
     if (!opts.source && !opts.uri) {
-      return Promise.reject(new Error('attachFile requires `source` (or the legacy `uri`)'));
+      return Promise.reject(
+        new Error('attachFile requires `source` (or the legacy `uri`)')
+      );
     }
     return NativeNewinstanceChat.attachFile(opts);
   }

package/src/types.ts

@@ -7,14 +7,44 @@
  */
 
 export interface NewinstanceChatConfig {
-  /** API key id from your newinstance.cloud dashboard. Never embed the secret half. */
-  apiKey: string;
+  apiKey?: string;
+  customerToken?: 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;
+  theme?: ChatThemeOverride;
+}
+
+export interface ChatThemeOverride {
+  mode?: 'light' | 'dark';
+  chatBackground?: string;
+  headerBackground?: string;
+  headerPrimaryText?: string;
+  headerSecondaryText?: string;
+  headerIcon?: string;
+  closeButton?: string;
+  receivedBubble?: string;
+  receivedText?: string;
+  receivedTimestamp?: string;
+  sentBubble?: string;
+  sentText?: string;
+  sentTimestamp?: string;
+  systemMessageText?: string;
+  daySeparatorBackground?: string;
+  daySeparatorText?: string;
+  footerContainer?: string;
+  chatInputBackground?: string;
+  chatInputText?: string;
+  chatInputPlaceholder?: string;
+  chatInputBorder?: string;
+  sendButtonBackground?: string;
+  sendButtonIcon?: string;
+  attachmentButton?: string;
+  unreadBadgeBackground?: string;
+  unreadBadgeText?: string;
 }
 
 export interface ChatUser {
@@ -139,9 +169,25 @@ export type NewinstanceChatErrorType =
   | 'auth'
   | 'system';
 
+export type NewinstanceChatErrorCode =
+  | 'INVALID_PUBLIC_KEY'
+  | 'MISSING_WIDGET_KEY'
+  | 'CHAT_CONFIG_UNAVAILABLE'
+  | 'CHAT_DISABLED'
+  | 'CONFIG_FETCH_FAILED'
+  | 'INVALID_IDENTITY_TOKEN'
+  | 'NETWORK_ERROR'
+  | 'TRANSPORT_ERROR'
+  | 'CHAT_INITIALIZATION_FAILED'
+  | 'MESSAGE_SEND_FAILED'
+  | 'ATTACHMENT_FAILED'
+  | 'SERVER_ERROR';
+
 export interface NewinstanceChatError {
+  code?: NewinstanceChatErrorCode;
   type: NewinstanceChatErrorType;
   message: string;
+  developerMessage?: string;
   recoverable: boolean;
 }