react-native-newinstance-chat 0.1.2 → 0.3.0

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

@@ -29,11 +29,27 @@ export class NewinstanceChat {
    * 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.
+   *
+   * Prefer `customerToken`: it is minted by your backend, so the server can
+   * verify who the customer is. `customerName` / `customerEmail` /
+   * `customerId` alone are client-asserted and are not trusted as identity.
    */
   setUser(user) {
     NativeNewinstanceChat.setUser(user);
   }
 
+  /**
+   * Identify the customer with a backend-minted chat identity token only.
+   * Nothing else needs to be supplied: the server derives the name, email and
+   * customer id from the token's signed claims.
+   */
+  setUserToken(customerToken) {
+    NativeNewinstanceChat.setUser({
+      customerName: 'Customer',
+      customerToken
+    });
+  }
+
   /**
    * Fetch org config, restore the saved conversation, and connect the
    * subscription transport in the background. Concurrent callers share
@@ -65,9 +81,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","setUserToken","customerToken","customerName","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;AAyB3D;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;AACA;AACA;AACA;AACA;EACEG,OAAOA,CAACC,IAAc,EAAQ;IAC5BT,qBAAqB,CAACQ,OAAO,CAACC,IAAI,CAAC;EACrC;;EAEA;AACF;AACA;AACA;AACA;EACEC,YAAYA,CAACC,aAAqB,EAAQ;IACxCX,qBAAqB,CAACQ,OAAO,CAAC;MAAEI,YAAY,EAAE,UAAU;MAAED;IAAc,CAAC,CAAC;EAC5E;;EAEA;AACF;AACA;AACA;AACA;EACEE,UAAUA,CAAA,EAAkB;IAC1B,OAAOb,qBAAqB,CAACa,UAAU,CAAC,CAAC;EAC3C;;EAEA;EACAC,QAAQA,CAAA,EAAS;IACfd,qBAAqB,CAACc,QAAQ,CAAC,CAAC;EAClC;;EAEA;EACAC,SAASA,CAAA,EAAS;IAChBf,qBAAqB,CAACe,SAAS,CAAC,CAAC;EACnC;EAEAC,WAAWA,CAACC,IAAY,EAAQ;IAC9BjB,qBAAqB,CAACgB,WAAW,CAACC,IAAI,CAAC;EACzC;EAEAC,YAAYA,CAACC,SAAiB,EAAQ;IACpCnB,qBAAqB,CAACkB,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,OAAO1B,qBAAqB,CAACoB,UAAU,CAACC,IAAI,CAAC;EAC/C;;EAEA;EACAM,gBAAgBA,CAACC,EAAU,EAAQ;IACjC5B,qBAAqB,CAAC2B,gBAAgB,CAACC,EAAE,CAAC;EAC5C;;EAEA;EACAC,gBAAgBA,CAAA,EAAS;IACvB7B,qBAAqB,CAAC6B,gBAAgB,CAAC,CAAC;EAC1C;;EAEA;AACF;AACA;AACA;EACEC,WAAWA,CACTC,KAAQ,EACRC,OAAwB,EACZ;IACZ,MAAMC,GAAwB,GAAG9B,OAAO,CAAC2B,WAAW,CAClDC,KAAK,EACLC,OACF,CAAC;IACD,OAAO,MAAMC,GAAG,CAACC,MAAM,CAAC,CAAC;EAC3B;;EAEA;AACF;AACA;AACA;EACEC,OAAOA,CAAA,EAAS;IACdnC,qBAAqB,CAACmC,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

@@ -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.
  *
@@ -18,8 +18,18 @@ export declare class NewinstanceChat {
      * 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.
+     *
+     * Prefer `customerToken`: it is minted by your backend, so the server can
+     * verify who the customer is. `customerName` / `customerEmail` /
+     * `customerId` alone are client-asserted and are not trusted as identity.
      */
     setUser(user: ChatUser): void;
+    /**
+     * Identify the customer with a backend-minted chat identity token only.
+     * Nothing else needs to be supplied: the server derives the name, email and
+     * customer id from the token's signed claims.
+     */
+    setUserToken(customerToken: string): void;
     /**
      * Fetch org config, restore the saved conversation, and connect the
      * subscription transport in the background. Concurrent callers share
@@ -37,7 +47,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,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;AASjB;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAElB,MAAM,EAAE,qBAAqB;IAIzC;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B;;;;OAIG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;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

@@ -14,18 +14,124 @@ export interface NewinstanceChatConfig {
     transport?: 'sse' | 'ws';
     /** Optional message pre-seeded as the first outbound message. */
     initialMessage?: string;
+    /**
+     * Local theme. Ranked BELOW whatever the merchant configured in the
+     * dashboard and ABOVE the SDK's built-in palette, merged per property, so a
+     * token you set here applies only where the dashboard did not set one.
+     */
+    theme?: ChatThemeOverride;
+}
+/**
+ * Local theme tokens. Every field is optional; colours are hex strings
+ * (`#RRGGBB` or `#AARRGGBB`). An unparseable value is ignored rather than
+ * throwing, so a bad colour can never crash the app.
+ */
+export interface ChatThemeOverride {
+    /**
+     * Force light or dark. Omit for "no opinion": the dashboard's mode wins if
+     * it set one, otherwise the device setting.
+     */
+    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;
     customerEmail?: string;
+    /**
+     * Your reference for this customer. Sent for agent context but NOT trusted
+     * as identity: an id asserted by app code cannot be verified. For a trusted
+     * identity use `customerToken`.
+     */
     customerId?: string;
+    /**
+     * Chat identity token minted by YOUR backend with `createCsCustomerToken`
+     * and handed to the app. When set it is the authoritative identity: the
+     * server derives name, email and customer id from its signed claims, so a
+     * tampered app cannot impersonate another customer.
+     */
+    customerToken?: 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 {
@@ -50,9 +156,54 @@ export interface ChatMessage {
     totalMessages?: number;
 }
 export type NewinstanceChatErrorType = 'network' | 'validation' | 'auth' | 'system';
+/**
+ * Stable, cross-platform diagnostic codes. The same strings are emitted by the
+ * web, Android, iOS and Flutter SDKs, so `code` is the value to branch on and
+ * to quote in a support request.
+ */
+export type NewinstanceChatErrorCode = 
+/** The API key was rejected: wrong key, wrong environment, revoked, or expired. */
+'INVALID_PUBLIC_KEY'
+/** No API key was supplied. */
+ | 'MISSING_WIDGET_KEY'
+/** The key is valid but no chat configuration exists for the organization. */
+ | 'CHAT_CONFIG_UNAVAILABLE'
+/** The key and config are fine, but chat is switched off in the dashboard. */
+ | 'CHAT_DISABLED'
+/** Remote configuration could not be fetched; the built-in theme is in use. */
+ | 'CONFIG_FETCH_FAILED'
+/** The chat identity token was malformed, expired, or signed for another organization. */
+ | 'INVALID_IDENTITY_TOKEN'
+/** A request could not reach the backend at all. */
+ | 'NETWORK_ERROR'
+/** The realtime transport dropped and could not be re-established. */
+ | 'TRANSPORT_ERROR'
+/** Starting a conversation failed. */
+ | 'CHAT_INITIALIZATION_FAILED'
+/** A message could not be delivered. */
+ | 'MESSAGE_SEND_FAILED'
+/** An attachment could not be uploaded. */
+ | 'ATTACHMENT_FAILED'
+/** The backend answered, but not with anything the SDK could use. */
+ | 'SERVER_ERROR';
+/**
+ * Delivered on the `error` event. This is the channel for "why is my chat not
+ * working": it is never rendered inside the chat interface, and it never
+ * carries the API key, the identity token, or customer personal data.
+ */
 export interface NewinstanceChatError {
+    /** Stable code to branch on. Undefined only from SDK versions older than 0.3.0. */
+    code?: NewinstanceChatErrorCode;
+    /** Broad category, kept for backwards compatibility with 0.2.x handlers. */
     type: NewinstanceChatErrorType;
+    /** Safe to log and to show a developer. Not written for end users. */
     message: string;
+    /**
+     * Extra detail for developers, when the SDK had any that was safe to
+     * expose. Never a raw server response body.
+     */
+    developerMessage?: string;
+    /** False when the SDK has given up until the host fixes something. */
     recoverable: boolean;
 }
 /** Native event names. Subscribe with `sdk.addListener(event, handler)`. */
@@ -63,6 +214,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.3.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

@@ -15,13 +15,17 @@ import type {
 
 export type {
   AttachmentInput,
+  AttachmentUpdate,
+  ChatClosedEvent,
   ChatMessage,
+  ChatThemeOverride,
   ChatUser,
   ConnectionState,
   EventMap,
   EventName,
   NewinstanceChatConfig,
   NewinstanceChatError,
+  NewinstanceChatErrorCode,
   NewinstanceChatErrorType,
 } from './types';
 
@@ -54,11 +58,24 @@ export class NewinstanceChat {
    * 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.
+   *
+   * Prefer `customerToken`: it is minted by your backend, so the server can
+   * verify who the customer is. `customerName` / `customerEmail` /
+   * `customerId` alone are client-asserted and are not trusted as identity.
    */
   setUser(user: ChatUser): void {
     NativeNewinstanceChat.setUser(user);
   }
 
+  /**
+   * Identify the customer with a backend-minted chat identity token only.
+   * Nothing else needs to be supplied: the server derives the name, email and
+   * customer id from the token's signed claims.
+   */
+  setUserToken(customerToken: string): void {
+    NativeNewinstanceChat.setUser({ customerName: 'Customer', customerToken });
+  }
+
   /**
    * Fetch org config, restore the saved conversation, and connect the
    * subscription transport in the background. Concurrent callers share
@@ -91,10 +108,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.