@repzo/widget-react-native 1.3.0 → 1.4.0

package/lib/typescript/module/ui/screens/home/HomeView.d.ts

@@ -1,12 +1,14 @@
 /**
- * Home space — branded greeting header, the "start a conversation" card, a
- * preview of recent threads and a team/availability strip.
+ * Home space — branded greeting header, the newest conversation in a "Recent
+ * message" card, the "start a conversation" card under it and a
+ * team/availability strip.
  * Port of `client/src/widget/components/HomeView.tsx`.
  *
  * The header meets the white body on a straight seam, the same as the web
  * widget. Whether that seam is a hard edge or the background washing out into
- * white is the dashboard's `homeBackgroundFade` toggle, and the start card sits
- * astride it either way: top over the brand background, bottom over white.
+ * white is the dashboard's `homeBackgroundFade` toggle, and the first card (the
+ * recent message, or the start card when there is none) sits astride it either
+ * way: top over the brand background, bottom over white.
  *
  * Everything on this screen comes from the widget config or the conversations
  * the visitor already has; nothing here assumes a field the backend does not
@@ -20,5 +22,5 @@ import type { HomeViewProps } from './HomeView.types';
  * derive something legible from the background instead.
  */
 export declare function resolveHeaderTextColor(config: WidgetConfig | null, fallbackColor: string): string;
-export declare function HomeView({ config, color, visitorName, conversationCount, recentConversations, unreadByConversation, teamAgents, isOnline, offlineMessage, startConversationLabel, replyTimeLabel, allowNewConversations, showPreviousConversations, labels, onClose, onStartConversation, onViewConversations, onOpenConversation, }: HomeViewProps): import("react").JSX.Element;
+export declare function HomeView({ config, color, visitorName, conversationCount, recentConversation, unreadByConversation, teamAgents, isOnline, offlineMessage, startConversationLabel, replyTimeLabel, allowNewConversations, showPreviousConversations, labels, onClose, onStartConversation, onOpenConversation, }: HomeViewProps): import("react").JSX.Element;
 //# sourceMappingURL=HomeView.d.ts.map

package/lib/typescript/module/ui/screens/home/HomeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HomeView.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/home/HomeView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA2BnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAQjG;AAED,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,KAAK,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,MAAM,EACN,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,EAAE,aAAa,+BAmNf"}
+{"version":3,"file":"HomeView.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/home/HomeView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAcH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA2BnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAQjG;AAED,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,KAAK,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,MAAM,EACN,OAAO,EACP,mBAAmB,EACnB,kBAAkB,GACnB,EAAE,aAAa,+BAkMf"}

package/lib/typescript/module/ui/screens/home/HomeView.styles.d.ts

@@ -4,15 +4,16 @@
  */
 /**
  * Header geometry in dp, measured off the web widget so the two surfaces line
- * up: a tall header with the greeting pinned low, a start card that overhangs
+ * up: a tall header with the greeting pinned low, a first card that overhangs
  * the seam by a fixed amount rather than half its height, and a fade that is a
  * straight white ramp over the bottom of the header, starting just under the
  * heading.
  */
 export declare const HEADER_MIN_HEIGHT = 228;
-/** Between the greeting and whatever comes next: the seam, or the start card. */
+/** Between the greeting and whatever comes next: the seam, or the first card. */
 export declare const HEADER_BOTTOM_PADDING = 36;
-export declare const START_CARD_LIFT = 28;
+/** How far the first card (recent message, else the start card) rides up over the seam. */
+export declare const LEAD_CARD_LIFT = 28;
 export declare const START_CARD_MIN_HEIGHT = 76;
 export declare const HEADER_FADE_HEIGHT = 90;
 export declare const CLOSE_BUTTON_SIZE = 28;
@@ -98,8 +99,33 @@ export declare const styles: {
         lineHeight: number;
         color: "#92400e";
     };
-    startCardSlot: {
+    leadCards: {
         marginTop: number;
+        gap: 12;
+    };
+    recentCard: {
+        shadowColor: "#0f172a";
+        shadowOffset: {
+            readonly width: 0;
+            readonly height: 4;
+        };
+        shadowOpacity: 0.08;
+        shadowRadius: 14;
+        elevation: 3;
+        paddingTop: 16;
+        paddingBottom: 8;
+        borderRadius: 12;
+        borderWidth: number;
+        borderColor: "#e5e7eb";
+        backgroundColor: "#ffffff";
+    };
+    recentTitle: {
+        textAlign: "left" | "right";
+        paddingHorizontal: 20;
+        marginBottom: 4;
+        fontSize: 17;
+        fontWeight: "600";
+        color: "#1a1a1a";
     };
     startCard: {
         shadowColor: "#0f172a";
@@ -147,37 +173,6 @@ export declare const styles: {
         color: "#9ca3af";
         marginTop: number;
     };
-    recentHeader: {
-        flexDirection: "row";
-        alignItems: "center";
-        justifyContent: "space-between";
-        minHeight: number;
-        marginBottom: 8;
-    };
-    recentTitle: {
-        textAlign: "left" | "right";
-        fontSize: 12;
-        fontWeight: "700";
-        color: "#6b7280";
-        letterSpacing: number;
-        textTransform: "uppercase";
-    };
-    viewAllButton: {
-        minHeight: number;
-        paddingHorizontal: 4;
-        justifyContent: "center";
-    };
-    viewAllLabel: {
-        textAlign: "left" | "right";
-        fontSize: 13;
-        fontWeight: "600";
-    };
-    recentCard: {
-        overflow: "hidden";
-    };
-    recentDivider: {
-        marginStart: number;
-    };
     spacer: {
         flex: number;
         minHeight: 16;

package/lib/typescript/module/ui/screens/home/HomeView.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HomeView.styles.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/home/HomeView.styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,qFAAqF;AACrF,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyNjB,CAAC"}
+{"version":3,"file":"HomeView.styles.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/home/HomeView.styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,2FAA2F;AAC3F,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,qFAAqF;AACrF,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgNjB,CAAC"}

package/lib/typescript/module/ui/screens/home/HomeView.types.d.ts

@@ -1,11 +1,10 @@
 /** Props and label bundle for the Home space. */
 import type { Conversation, WidgetConfig } from '../../../types';
+import type { LastMessageLabels } from '../../components/ConversationRow';
 import type { RelativeTimeLabels, TeamAgent } from '../../utils/conversations';
 export interface HomeViewLabels {
     close: string;
-    /** Accessibility label for the "view all" control. */
-    viewPrevious: string;
-    viewAll: string;
+    /** Heading inside the "Recent message" card. */
     recentTitle: string;
     noConversations: string;
     statusOnline: string;
@@ -15,14 +14,15 @@ export interface HomeViewLabels {
     time: RelativeTimeLabels;
     /** Template with a `{count}` token. */
     unread: string;
+    lastMessage: LastMessageLabels;
 }
 export interface HomeViewProps {
     config: WidgetConfig | null;
     color: string;
     visitorName?: string;
     conversationCount: number;
-    /** Already sorted newest-first and capped by the provider. */
-    recentConversations: Conversation[];
+    /** The newest conversation, picked by the provider; none before the first one. */
+    recentConversation?: Conversation;
     unreadByConversation: Record<string, number>;
     teamAgents: TeamAgent[];
     isOnline: boolean;
@@ -34,7 +34,6 @@ export interface HomeViewProps {
     labels: HomeViewLabels;
     onClose: () => void;
     onStartConversation: () => void;
-    onViewConversations: () => void;
     onOpenConversation: (conversationId: string) => void;
 }
 //# sourceMappingURL=HomeView.types.d.ts.map

package/lib/typescript/module/ui/screens/home/HomeView.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HomeView.types.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/home/HomeView.types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;IACzB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,mBAAmB,EAAE,YAAY,EAAE,CAAC;IACpC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yBAAyB,EAAE,OAAO,CAAC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD"}
+{"version":3,"file":"HomeView.types.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/home/HomeView.types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;IACzB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yBAAyB,EAAE,OAAO,CAAC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD"}

package/lib/typescript/module/ui/styles/theme.d.ts

@@ -62,6 +62,8 @@ export interface WidgetTheme {
     allowNewConversations: boolean;
     showPreviousConversations: boolean;
     attachmentsEnabled: boolean;
+    /** The server's upload cap; null when it only takes files inline in the message. */
+    maxAttachmentBytes: number | null;
     preChatEnabled: boolean;
 }
 export declare const DEFAULT_PRIMARY_COLOR = "#0d9488";

package/lib/typescript/module/ui/styles/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../../src/ui/styles/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;CAkBV,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;CAMT,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yBAAyB,EAAE,OAAO,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C;;;;GAIG;AAGH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAgBnE;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAYvE;AAED,wFAAwF;AACxF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;CAeV,CAAC"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../../src/ui/styles/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;CAkBV,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;CAMT,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yBAAyB,EAAE,OAAO,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oFAAoF;IACpF,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C;;;;GAIG;AAGH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAoBnE;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAYvE;AAED,wFAAwF;AACxF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;CAeV,CAAC"}

package/lib/typescript/module/ui/utils/conversations.d.ts

@@ -1,9 +1,10 @@
 /**
  * Conversation selectors and formatting shared by the Home and Messages
- * spaces, so the two can never disagree about ordering or wording.
+ * spaces (and the store and chat thread, for message helpers), so they can
+ * never disagree about ordering or wording.
  * Pure and free of React so they stay trivial to test.
  */
-import type { Conversation } from '../../types';
+import type { Conversation, Message } from '../../types';
 export interface TeamAgent {
     name: string | null;
     avatar: string | null;
@@ -38,4 +39,11 @@ export declare function formatDayLabel(dateStr: string, locale: string, labels:
     today: string;
     yesterday: string;
 }): string;
+/** Optimistic visitor bubbles the server hasn't acknowledged (pending/failed). */
+export declare function isLocalMessage(message: Message): boolean;
+/**
+ * The visitor's own bubble that never reached the server. A `failed` status
+ * the server sets on any other message isn't something this device can re-send.
+ */
+export declare function canRetryMessage(message: Message): boolean;
 //# sourceMappingURL=conversations.d.ts.map

package/lib/typescript/module/ui/utils/conversations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/conversations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE3E;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE,CAEhG;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,SAAS,EAAE,CAepF;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CActF;AAKD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQvE;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,CAmBR"}
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/conversations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE3E;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE,CAEhG;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,SAAS,EAAE,CAepF;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CActF;AAKD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQvE;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,CAmBR;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD"}

package/lib/typescript/module/ui/utils/html.d.ts

@@ -6,6 +6,11 @@
 export declare function decodeEntities(text: string): string;
 /** Block-level tags become newlines so paragraphs survive the strip. */
 export declare function stripHtml(html: string): string;
+/**
+ * Agent reply HTML → the Markdown subset `Markdown` draws: paragraphs, line
+ * breaks, lists, bold, italic, inline code and links. Other tags keep their text.
+ */
+export declare function htmlToMarkdown(html: string): string;
 /** Single-line flattening used for campaign cards and list snippets. */
 export declare function htmlToText(html: string): string;
 //# sourceMappingURL=html.d.ts.map

package/lib/typescript/module/ui/utils/html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW9C;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/C"}
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBnD;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/C"}

package/lib/typescript/module/ui/utils/image-load-queue.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Lets images load a few at a time, highest priority first. The chat runs its
+ * large images through it: Android holds a whole download in a memory pool
+ * capped at three quarters of the app's heap (192 MB on a 256 MB phone), so
+ * several 30–50 MB photos at once overflow it and every one of them fails.
+ *
+ * No `react-native` import on purpose: it stays testable in plain Node.
+ */
+export declare class ImageLoadQueue {
+    private readonly concurrency;
+    private readonly waiting;
+    private readonly loading;
+    private readonly done;
+    /** The images on screen; null until the list says, so all of them count. */
+    private onScreen;
+    private readonly listeners;
+    private scheduled;
+    constructor(concurrency: number);
+    /** Queues a mounted image; the returned cleanup gives up its place. */
+    add(key: string, priority: number): () => void;
+    /** Loaded or failed: it keeps showing, and the next image may start. */
+    finish(key: string): void;
+    canLoad: (key: string) => boolean;
+    subscribe: (listener: () => void) => (() => void);
+    /**
+     * The images now on screen. One that scrolls off before it has loaded
+     * gives up its place and waits, so it can't hold up the ones in view:
+     * Android detaches a row scrolled out of view, and a detached image never
+     * finishes loading. Only images on screen are started.
+     */
+    setOnScreen(keys: Iterable<string>): void;
+    /** Scrolled out of the list before it loaded: it queues again if it comes back. */
+    private remove;
+    /**
+     * Hands out places once the render that mounted an image is done, so all
+     * the images mounted together are queued first, whatever order they
+     * mounted in.
+     */
+    private schedule;
+    /** Starts what fits; true when anything started (listeners were told). */
+    private advance;
+    private notify;
+}
+//# sourceMappingURL=image-load-queue.d.ts.map

package/lib/typescript/module/ui/utils/image-load-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-load-queue.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/image-load-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,cAAc;IAUb,OAAO,CAAC,QAAQ,CAAC,WAAW;IARxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,SAAS,CAAS;gBAEG,WAAW,EAAE,MAAM;IAEhD,uEAAuE;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,IAAI;IAQ9C,wEAAwE;IACxE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzB,OAAO,GAAI,KAAK,MAAM,KAAG,OAAO,CAAgD;IAEhF,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAK9C;IAEF;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAYzC,mFAAmF;IACnF,OAAO,CAAC,MAAM;IAKd;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAShB,0EAA0E;IAC1E,OAAO,CAAC,OAAO;IAoBf,OAAO,CAAC,MAAM;CAGf"}

package/lib/typescript/module/ui/utils/inline-attachments.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Agent replies with images between their paragraphs. Workstation marks such
+ * images `inline` among the message's attachments and keeps an `<img>` for
+ * each in the HTML body, where the teammate put it. Same split as the web
+ * Messenger, so both show the text and images in the order they were written.
+ */
+import type { WidgetAttachment } from '../../types';
+/** Markdown for the bubble to draw, or one attachment. */
+export type MessagePart = {
+    text: string;
+} | {
+    attachment: WidgetAttachment;
+};
+/**
+ * The body and its inline images in order, plus the other attachments
+ * (`files`) that show after them. Null when nothing is inline: the bubble then
+ * shows the body, followed by every attachment.
+ *
+ * An `<img>` finds its attachment by the id in its URL. In a body whose
+ * images carry no ids, they take the attachments in order instead; in one
+ * that does, an image without an id (a logo, an emoji) isn't one of the files
+ * and takes nothing. One whose id names no remaining attachment (the same file
+ * twice) takes nothing either. Inline attachments with no `<img>` go at the end.
+ */
+export declare function splitInlineAttachments(body: string | null | undefined, attachments: WidgetAttachment[] | null | undefined): {
+    parts: MessagePart[];
+    files: WidgetAttachment[];
+} | null;
+//# sourceMappingURL=inline-attachments.d.ts.map

package/lib/typescript/module/ui/utils/inline-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-attachments.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/inline-attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,WAAW,EAAE,gBAAgB,EAAE,GAAG,IAAI,GAAG,SAAS,GACjD;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAAE,GAAG,IAAI,CA8B5D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repzo/widget-react-native",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Repzo chat widget for React Native",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",

package/src/api/client.ts

@@ -8,6 +8,7 @@
  * The token itself lives in `SecureStorage`.
  */
 
+import { measureFileSize } from '../attachments/file-size';
 import { SecureStorage, TOKEN_KEY } from '../storage';
 import type {
   AgentUiAction,
@@ -84,6 +85,60 @@ interface RequestOptions {
   authToken?: string | null;
 }
 
+/**
+ * Sends a local file as the request body straight from disk and resolves the
+ * HTTP status. React Native streams a `{ uri }` body natively; `fetch` would
+ * stringify it, so this goes through XMLHttpRequest.
+ */
+function sendFileFromDisk(
+  url: string,
+  method: string,
+  headers: Record<string, string>,
+  file: { uri: string; contentType: string },
+  signal?: AbortSignal
+): Promise<number> {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    const cancel = () => xhr.abort();
+    const settle = (finish: () => void) => {
+      signal?.removeEventListener('abort', cancel);
+      finish();
+    };
+    xhr.onload = () => settle(() => resolve(xhr.status));
+    xhr.onerror = () => settle(() => reject(new RepzoWidgetError('Network request failed', 0, 'network')));
+    xhr.ontimeout = xhr.onerror;
+    xhr.onabort = () => settle(() => reject(new RepzoWidgetError('Upload cancelled', 0, 'network')));
+    xhr.open(method, url);
+    Object.entries(headers).forEach(([name, value]) => xhr.setRequestHeader(name, value));
+    // Android refuses a `{ uri }` body without one.
+    if (!Object.keys(headers).some((name) => name.toLowerCase() === 'content-type')) {
+      xhr.setRequestHeader('Content-Type', file.contentType);
+    }
+    signal?.addEventListener('abort', cancel);
+    xhr.send({ uri: file.uri } as unknown as XMLHttpRequestBodyInit);
+  });
+}
+
+/**
+ * How long Workstation keeps an upload for a message to name, when its answer
+ * has no usable `expiresAt` (deployments without it, or a phone clock that
+ * reads it as already past).
+ */
+const UPLOAD_LIFETIME_MS = 60 * 60 * 1000;
+
+/** A file in storage, waiting for the message that names it. */
+export interface UploadedFile {
+  uploadToken: string;
+  /** When Workstation stops taking `uploadToken`, on this phone's clock (ms). */
+  expiresAt: number;
+}
+
+function uploadExpiry(expiresAt: unknown, now: number): number {
+  const at =
+    typeof expiresAt === 'string' ? Date.parse(expiresAt) : typeof expiresAt === 'number' ? expiresAt : NaN;
+  return at > now ? at : now + UPLOAD_LIFETIME_MS;
+}
+
 export class WidgetApiClient {
   private baseUrl = '';
 
@@ -337,15 +392,106 @@ export class WidgetApiClient {
     conversationId?: string;
     forceNewConversation?: boolean;
     body: string;
-    /** `url` is a base64 data URL; max 5, each <= 1.5 MB decoded. */
-    attachments?: Array<{ name: string; url: string; contentType: string; size: number }>;
+    /**
+     * Max 5. Either inline (`url`, a base64 data URL, each <= 1.5 MB decoded)
+     * or uploaded first (`uploadToken`, from uploadAttachment).
+     */
+    attachments?: Array<
+      | { name: string; url: string; contentType: string; size: number }
+      | { name: string; uploadToken: string; contentType: string; size: number }
+    >;
     visitorName?: string;
     visitorEmail?: string;
     agentUiAction?: AgentUiAction;
+    /**
+     * Same on every retry of a message. Newer Workstation deployments store it
+     * once and echo it on the stored row; older ones don't read it.
+     */
+    clientMessageId?: string;
   }): Promise<{ messageId: string; conversationId: string; isNewConversation: boolean }> {
     return this.request('/api/widget/messages', { method: 'POST', body: data });
   }
 
+  /**
+   * Puts a local file in storage ahead of the message, which then names it by
+   * the returned upload token. The target is presigned storage, or a path on
+   * the server where its storage can't presign. The upload URL is signed for
+   * exactly the size asked for: a `file://` file whose size `expo-file-system`
+   * can read streams from disk, anything else is read as a native blob and
+   * measured. `signal` cancels the transfer (the visitor removed the file, or
+   * left the conversation). Resolves the token and when it expires.
+   */
+  async uploadAttachment(
+    file: {
+      uri: string;
+      name: string;
+      contentType: string;
+      size: number;
+    },
+    signal?: AbortSignal
+  ): Promise<UploadedFile> {
+    // A file removed early is never read, nor given a slot in storage.
+    const stopIfCancelled = () => {
+      if (signal?.aborted) throw new RepzoWidgetError('Upload cancelled', 0, 'network');
+    };
+    stopIfCancelled();
+    // Streaming matters on Android: React Native also copies a blob it reads
+    // into a Base64 string for its network inspector, so a file past ~30 MB
+    // runs the app out of memory. Only file:// gives an exact Content-Length.
+    const streamedSize = urlScheme(file.uri) === 'file:' ? await measureFileSize(file.uri) : null;
+    let blob: Blob | null = null;
+    if (streamedSize === null) {
+      try {
+        blob = await (await fetch(file.uri, { signal })).blob();
+      } catch (error) {
+        throw new RepzoWidgetError(
+          error instanceof Error ? error.message : 'Could not read the file',
+          0,
+          'network'
+        );
+      }
+    }
+    stopIfCancelled();
+    const target = await this.request<{
+      uploadUrl: string;
+      method?: string;
+      headers?: Record<string, string>;
+      uploadToken: string;
+      expiresAt?: string | number;
+    }>('/api/widget/uploads', {
+      method: 'POST',
+      body: {
+        fileName: file.name,
+        contentType: file.contentType,
+        size: streamedSize ?? (blob?.size || file.size),
+      },
+    });
+    // Counted from when the token was issued, not from when the file is up.
+    const expiresAt = uploadExpiry(target.expiresAt, Date.now());
+    const uploadUrl = this.resolveUrl(target.uploadUrl);
+    if (!uploadUrl) throw new RepzoWidgetError('Invalid upload target', 0, 'http');
+    stopIfCancelled();
+
+    const method = target.method ?? 'PUT';
+    const headers = target.headers ?? { 'Content-Type': file.contentType };
+    let status: number;
+    if (blob) {
+      try {
+        status = (await fetch(uploadUrl, { method, headers, body: blob, signal })).status;
+      } catch (error) {
+        throw new RepzoWidgetError(
+          error instanceof Error ? error.message : 'Upload failed',
+          0,
+          'network'
+        );
+      }
+    } else {
+      status = await sendFileFromDisk(uploadUrl, method, headers, file, signal);
+    }
+    if (status < 200 || status >= 300) throw new RepzoWidgetError('Upload failed', status, 'http');
+    return { uploadToken: target.uploadToken, expiresAt };
+  }
+
   listConversations(): Promise<{ data: Conversation[] }> {
     return this.request('/api/widget/conversations');
   }

package/src/attachments/file-size.ts

@@ -0,0 +1,42 @@
+/**
+ * Local file sizes from the host's `expo-file-system` (optional, like the
+ * pickers): read from the file's metadata, never from its contents. Shared by
+ * the pickers and the upload client, so the client doesn't pull in pickers.
+ *
+ * No `react-native` import on purpose: it stays testable in plain Node.
+ */
+
+let fileSystem: any = null;
+try {
+  fileSystem = require('expo-file-system') ?? null;
+} catch {
+  fileSystem = null;
+}
+
+/** A positive, finite byte count, or null. */
+export function validSize(size: unknown): number | null {
+  return typeof size === 'number' && Number.isFinite(size) && size > 0 ? size : null;
+}
+
+/**
+ * A local file's exact size in bytes, from its metadata without reading it.
+ * Null without `expo-file-system`, or when it can't tell.
+ */
+export async function measureFileSize(uri: string): Promise<number | null> {
+  if (typeof fileSystem?.File === 'function') {
+    try {
+      const size = validSize(new fileSystem.File(uri).size);
+      if (size !== null) return size;
+    } catch {
+      // Fall through to the next reader.
+    }
+  }
+  if (typeof fileSystem?.getInfoAsync === 'function') {
+    try {
+      return validSize((await fileSystem.getInfoAsync(uri, { size: true }))?.size);
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}

package/src/attachments/local-previews.ts

@@ -0,0 +1,32 @@
+/**
+ * The phone's copy of each file the visitor sent, by the URL of the stored
+ * copy that replaced it in the thread. Right after a send the stored copy
+ * may not load yet (Workstation can still be storing it), so a photo keeps
+ * showing from the phone instead of turning into a file row. Kept in memory
+ * only: a later session shows the stored copy.
+ */
+
+const MAX_PREVIEWS = 50;
+const previews = new Map<string, string>();
+
+export function rememberLocalPreview(storedUrl: string, localUrl: string): void {
+  if (!storedUrl || !localUrl) return;
+  previews.delete(storedUrl);
+  previews.set(storedUrl, localUrl);
+  // Oldest first: a Map iterates in insertion order.
+  if (previews.size > MAX_PREVIEWS) previews.delete(previews.keys().next().value as string);
+}
+
+export function localPreviewFor(storedUrl: string): string | null {
+  return (storedUrl && previews.get(storedUrl)) || null;
+}
+
+/** One that failed to load (the OS cleared the picker's cache): every view moves to the stored copy. */
+export function forgetLocalPreview(storedUrl: string): void {
+  previews.delete(storedUrl);
+}
+
+/** Signing out forgets them: the next visitor on the phone doesn't inherit the paths. */
+export function clearLocalPreviews(): void {
+  previews.clear();
+}