@chatlychat/react-native 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,209 @@
-# Temporary Holding Version
+# @chatlychat/react-native
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React Native SDK for the Chatly live chat platform. Drop-in chat inbox, help
+center, and push-notification wiring for iOS and Android. Talks to the same
+`/v1/widget/*` REST surface and Socket.IO realtime channel as the web widget.
+
+## Install
+
+```sh
+npm install @chatlychat/react-native @react-native-async-storage/async-storage
+# or
+yarn add @chatlychat/react-native @react-native-async-storage/async-storage
+```
+
+`react`, `react-native`, and `@react-native-async-storage/async-storage` are
+peer dependencies. `socket.io-client` is bundled.
+
+For bare React Native apps, run `pod install` in `ios/` after installing
+AsyncStorage.
+
+## Quick start
+
+Wrap your app in `<ChatlyProvider>` and drop in `<ChatlyWidget />`.
+
+```tsx
+import { ChatlyProvider, ChatlyWidget, useChatly } from '@chatlychat/react-native';
+
+export default function App() {
+  return (
+    <ChatlyProvider config={{ publicId: 'pub_abc123', apiHost: 'api.chatly.com' }}>
+      <Support />
+    </ChatlyProvider>
+  );
+}
+
+function Support() {
+  const { unreadCount, identify, setPushToken } = useChatly();
+  return <ChatlyWidget />;
+}
+```
+
+## Identifying users
+
+Call `identify()` once you know who the user is. The SDK persists a visitor
+token under `chatly:vt:<publicId>` in AsyncStorage, so subsequent app launches
+re-attach to the same contact automatically.
+
+```tsx
+const { identify } = useChatly();
+
+await identify({
+  externalId: 'user-123',
+  email: 'alex@example.com',
+  name: 'Alex',
+  // HMAC-SHA256(externalId, workspace identity secret). Compute server-side.
+  userHash: 'a1b2c3…',
+});
+```
+
+`userHash` is optional but strongly recommended in production — without it,
+any client could impersonate any `externalId`.
+
+## Push notifications
+
+The SDK does not bundle a push provider — pick the one that suits your app:
+
+- Expo: `expo-notifications` → `getDevicePushTokenAsync()`
+- Bare RN: `@react-native-firebase/messaging` → `messaging().getToken()`
+- iOS APNs directly: `@react-native-community/push-notification-ios`
+
+Then forward the token to Chatly:
+
+```tsx
+import messaging from '@react-native-firebase/messaging';
+
+const { setPushToken } = useChatly();
+
+useEffect(() => {
+  (async () => {
+    const auth = await messaging().requestPermission();
+    if (auth) {
+      const token = await messaging().getToken();
+      await setPushToken({ platform: 'ios', token, bundleId: 'com.your.app' });
+    }
+  })();
+}, [setPushToken]);
+```
+
+On the native side you still need the standard setup for your provider:
+
+- iOS: enable Push Notifications + Background Modes (Remote notifications) in
+  Xcode, and configure an APNs key in the Chatly dashboard.
+- Android: add `google-services.json` and the FCM Sender ID in the dashboard.
+
+## Customization
+
+Pass a `theme` prop to override the defaults. Anything you omit falls back to
+the default palette (primary `#2563eb`, background `#ffffff`, foreground
+`#0f172a`).
+
+```tsx
+<ChatlyProvider
+  config={{ publicId: 'pub_abc123' }}
+  theme={{ colors: { primary: '#10b981', onPrimary: '#ffffff' } }}
+>
+  <App />
+</ChatlyProvider>
+```
+
+Need full control over rendering? Use the lower-level pieces directly:
+
+```tsx
+import { MessagesList, Composer, HelpCenter } from '@chatlychat/react-native';
+```
+
+## Rich blocks and card actions
+
+Bot replies can carry cards, a carousel, a price, quick replies and a status
+line. `MessageBubble` renders them, so you get them for free — and the buttons
+on them are real buttons, unlike the read-only rendering in the agent app.
+
+Four of the five action kinds are handled for you: a `url` opens a link, a
+`postback` sends a reply (invisibly, if the card asked), a `step` requests a
+canvas. The fifth is yours.
+
+### `host_event` — the one your app has to run
+
+A card saying **Pay $48.20** cannot run Stripe from inside a chat library. It
+has to happen in your app, with the buyer's real session and a native payment
+sheet. So the SDK does nothing for a `host_event` and calls you:
+
+```tsx
+<ChatlyProvider
+  config={{ publicId: 'pub_abc123' }}
+  onAction={async ({ event, data, conversationId, messageId, actionId }) => {
+    if (event !== 'pay' || conversationId === null) return;
+    try {
+      await presentNativePaymentSheet(data);
+      await rest.reportAction(conversationId, {
+        messageId,
+        actionId,
+        status: 'done',
+        text: 'Paid — thank you!',
+      });
+    } catch (err) {
+      await rest.reportAction(conversationId, { messageId, actionId, status: 'failed' });
+    }
+  }}
+>
+  <App />
+</ChatlyProvider>
+```
+
+**Report the outcome.** `reportAction` is what appends the visible line under
+the card and tells the bot what happened. Without it the shopper is looking at
+a card with nothing under it and the bot asks again.
+
+### Canvas steps
+
+A Tier 2 canvas is a form inside the bubble — a confirm step for a purchase,
+a return request. `MessageCanvas` renders it and submits it, and the step's
+answer replaces what is on screen: a changed total comes back as a **fresh
+step** rather than a charge.
+
+A step's answer may itself carry a host event (this is how 3-D Secure works on
+a phone), and that reaches the same `onAction`.
+
+A Tier 3 canvas — your own page in a sandboxed frame — is deliberately **not**
+rendered. There is no React Native equivalent of a sandbox attribute, and a
+WebView is the thing a native SDK exists to avoid. The SDK shows the step's
+title and leaves it to you.
+
+### Rendering blocks yourself
+
+Want your own card design, a real markdown renderer, a video player, a native
+clipboard? Read the envelope and render it:
+
+```tsx
+import { readBlocksEnvelope, formatMoney } from '@chatlychat/react-native';
+
+const envelope = readBlocksEnvelope(message.blocks);
+```
+
+`readBlocksEnvelope` applies the same refusals the rest of the product does —
+`https:` media only, an unreadable price dropped rather than rendered as
+`NaN`, an unknown block type dropped instead of throwing. Prices are **minor
+units**: `4820` is `$48.20` and also `¥4,820`. Use `formatMoney`; the divisor
+is not 100.
+
+## API surface
+
+| Export                                                    | Purpose                                            |
+| --------------------------------------------------------- | -------------------------------------------------- |
+| `ChatlyProvider`                                          | Bootstraps clients, restores session               |
+| `ChatlyWidget`                                            | Drop-in inbox + help center UI                     |
+| `useChatly()`                                             | Access session, identify, push token, refresh      |
+| `MessagesList`, `Composer`, `MessageBubble`, `HelpCenter` | Composable UI                                      |
+| `MessageBlocks`, `MessageCanvas`                          | Cards and canvas steps, rendered                   |
+| `onAction` on `ChatlyProvider`                            | `host_event` card actions, for your app to run     |
+| `RestClient`, `RealtimeClient`                            | Headless access                                    |
+| `rest.reportAction`                                       | Tell the thread and the bot what your app did      |
+| `readBlocksEnvelope`, `readCanvas`                        | Render blocks yourself, with the same refusals     |
+| `formatMoney`, `readMoney`                                | Minor-unit prices, formatted for the device locale |
+| `registerPushToken`                                       | Helper used by `setPushToken`                      |
+| `defaultTheme`, `ChatlyTheme`                             | Theming                                            |
+
+## License
+
+MIT

package/dist/ChatlyProvider.d.ts

@@ -0,0 +1,69 @@
+/**
+ * <ChatlyProvider /> bootstraps the REST + realtime clients, restores the
+ * persisted visitor token, fires `/v1/widget/init`, and exposes session state
+ * to descendants via the `useChatly` hook.
+ *
+ * The provider is intentionally state-light: the heavy lifting (message lists,
+ * composer state) lives in the components that use it. This keeps the public
+ * context surface stable as we add features.
+ */
+import React from 'react';
+import { RealtimeClient } from './client/RealtimeClient';
+import { RestClient } from './client/RestClient';
+import type { ChatlyConfig, ChatlyIdentity, ConversationSummary, InitResponse, PushTokenRegistration, SessionState } from './client/types';
+import type { ChatlyTheme } from './theme/ChatlyTheme';
+export interface ChatlyContextValue {
+    config: ChatlyConfig;
+    theme: ChatlyTheme;
+    rest: RestClient;
+    realtime: RealtimeClient;
+    session: SessionState | null;
+    init: InitResponse | null;
+    isReady: boolean;
+    error: Error | null;
+    unreadCount: number;
+    conversations: ConversationSummary[];
+    identify: (identity: ChatlyIdentity) => Promise<void>;
+    logout: () => Promise<void>;
+    setPushToken: (registration: PushTokenRegistration) => Promise<void>;
+    refresh: () => Promise<void>;
+    /**
+     * What the APP does about a `host_event` card action.
+     *
+     * The one feature a native SDK exists for. A card saying "Pay $48.20" has
+     * to run with the buyer's real session — a native payment sheet, the app's
+     * own cart, a screen push — and none of that can happen inside a chat
+     * library. So the renderer does nothing for a `host_event` and calls this.
+     *
+     * Report the outcome back with `rest.reportAction`, which appends the
+     * visible line under the card and tells the owning bot. Not reporting is a
+     * shopper looking at a card with nothing under it and a bot that asks
+     * again.
+     *
+     * `undefined` when the consumer did not supply one, and the renderer then
+     * draws the button and the tap does nothing — which is the right failure:
+     * a card that renders without its buttons would hide that the integrator
+     * has work to do.
+     */
+    onAction?: ((event: ChatlyActionEvent) => void) | undefined;
+}
+/** One `host_event` tap, with everything needed to report the outcome. */
+export interface ChatlyActionEvent {
+    /** The author's own event name, e.g. `add_to_cart`. */
+    readonly event: string;
+    readonly data: Record<string, unknown>;
+    readonly conversationId: string | null;
+    readonly messageId: string;
+    /** Pass this back to `reportAction` so the result lands under the card. */
+    readonly actionId: string;
+}
+export declare const ChatlyContext: React.Context<ChatlyContextValue | null>;
+export interface ChatlyProviderProps {
+    config: ChatlyConfig;
+    theme?: Partial<ChatlyTheme>;
+    children: React.ReactNode;
+    /** See `ChatlyContextValue.onAction`. */
+    onAction?: (event: ChatlyActionEvent) => void;
+}
+export declare function ChatlyProvider({ config, theme, children, onAction, }: ChatlyProviderProps): React.JSX.Element;
+//# sourceMappingURL=ChatlyProvider.d.ts.map

package/dist/ChatlyProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatlyProvider.d.ts","sourceRoot":"","sources":["../src/ChatlyProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAA2E,MAAM,OAAO,CAAC;AAEhG,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIjD,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,YAAY,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7D;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,aAAa,0CAAiD,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC/C;AAED,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6IzC"}

package/dist/ChatlyProvider.js

@@ -0,0 +1,146 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * <ChatlyProvider /> bootstraps the REST + realtime clients, restores the
+ * persisted visitor token, fires `/v1/widget/init`, and exposes session state
+ * to descendants via the `useChatly` hook.
+ *
+ * The provider is intentionally state-light: the heavy lifting (message lists,
+ * composer state) lives in the components that use it. This keeps the public
+ * context surface stable as we add features.
+ */
+import { createContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { RealtimeClient } from './client/RealtimeClient';
+import { RestClient } from './client/RestClient';
+import { registerPushToken } from './push/registerPushToken';
+import { defaultTheme } from './theme/defaultTheme';
+export const ChatlyContext = createContext(null);
+export function ChatlyProvider({ config, theme, children, onAction, }) {
+    const rest = useMemo(() => new RestClient(config), [config]);
+    const realtime = useMemo(() => new RealtimeClient(config), [config]);
+    const mergedTheme = useMemo(() => mergeTheme(defaultTheme, theme), [theme]);
+    const [session, setSession] = useState(null);
+    const [init, setInit] = useState(null);
+    const [error, setError] = useState(null);
+    const [conversations, setConversations] = useState([]);
+    const mounted = useRef(true);
+    const bootstrap = useCallback(async (identity) => {
+        try {
+            const result = await rest.init(identity);
+            if (!mounted.current) {
+                return;
+            }
+            setInit(result);
+            setSession(result.session);
+            realtime.connect(result.session, result.session.token);
+            realtime.subscribe([`contact:${result.session.contactId}`]);
+            try {
+                const list = await rest.listConversations();
+                if (mounted.current) {
+                    setConversations(list.conversations);
+                }
+            }
+            catch {
+                // Non-fatal: surface as zero conversations rather than blocking init.
+            }
+        }
+        catch (err) {
+            if (mounted.current) {
+                setError(err);
+            }
+        }
+    }, [rest, realtime]);
+    useEffect(() => {
+        mounted.current = true;
+        void bootstrap();
+        return () => {
+            mounted.current = false;
+            realtime.disconnect();
+        };
+    }, [bootstrap, realtime]);
+    // Refresh conversation summaries on inbound message events.
+    useEffect(() => {
+        const off = realtime.on('message.created', () => {
+            void rest
+                .listConversations()
+                .then((res) => {
+                if (mounted.current) {
+                    setConversations(res.conversations);
+                }
+            })
+                .catch(() => undefined);
+        });
+        return off;
+    }, [realtime, rest]);
+    const unreadCount = useMemo(() => conversations.reduce((acc, c) => acc + (c.unreadContactCount ?? 0), 0), [conversations]);
+    const identify = useCallback(async (identity) => {
+        await bootstrap(identity);
+    }, [bootstrap]);
+    const logout = useCallback(async () => {
+        realtime.disconnect();
+        await rest.clearToken();
+        setSession(null);
+        setInit(null);
+        setConversations([]);
+    }, [realtime, rest]);
+    const setPushToken = useCallback(async (registration) => {
+        await registerPushToken(rest, registration);
+    }, [rest]);
+    const refresh = useCallback(async () => {
+        try {
+            const res = await rest.listConversations();
+            if (mounted.current) {
+                setConversations(res.conversations);
+            }
+        }
+        catch (err) {
+            if (mounted.current) {
+                setError(err);
+            }
+        }
+    }, [rest]);
+    const value = useMemo(() => ({
+        config,
+        theme: mergedTheme,
+        rest,
+        realtime,
+        session,
+        init,
+        isReady: session !== null,
+        error,
+        unreadCount,
+        conversations,
+        identify,
+        logout,
+        setPushToken,
+        refresh,
+        onAction,
+    }), [
+        config,
+        mergedTheme,
+        rest,
+        realtime,
+        session,
+        init,
+        error,
+        unreadCount,
+        conversations,
+        identify,
+        logout,
+        setPushToken,
+        refresh,
+        onAction,
+    ]);
+    return _jsx(ChatlyContext.Provider, { value: value, children: children });
+}
+function mergeTheme(base, override) {
+    if (override === undefined) {
+        return base;
+    }
+    return {
+        colors: { ...base.colors, ...(override.colors ?? {}) },
+        radius: { ...base.radius, ...(override.radius ?? {}) },
+        spacing: { ...base.spacing, ...(override.spacing ?? {}) },
+        typography: { ...base.typography, ...(override.typography ?? {}) },
+    };
+}
+//# sourceMappingURL=ChatlyProvider.js.map

package/dist/ChatlyProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatlyProvider.js","sourceRoot":"","sources":["../src/ChatlyProvider.tsx"],"names":[],"mappings":"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"}

package/dist/ChatlyWidget.d.ts

@@ -0,0 +1,15 @@
+/**
+ * <ChatlyWidget /> — drop-in inbox surface. Renders the conversation list when
+ * none is selected, the message view + composer when one is, and (optionally)
+ * the help center via a tab toggle. Mirrors the "open the bubble, see your
+ * conversations" UX of Tawk.to / Intercom mobile SDKs.
+ */
+import React from 'react';
+export interface ChatlyWidgetProps {
+    /** Show the help-center tab. Defaults to true. */
+    enableHelpCenter?: boolean;
+    /** Pre-open a specific conversation. */
+    initialConversationId?: string;
+}
+export declare function ChatlyWidget({ enableHelpCenter, initialConversationId, }: ChatlyWidgetProps): React.JSX.Element;
+//# sourceMappingURL=ChatlyWidget.d.ts.map

package/dist/ChatlyWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatlyWidget.d.ts","sourceRoot":"","sources":["../src/ChatlyWidget.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA2C,MAAM,OAAO,CAAC;AAqBhE,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,YAAY,CAAC,EAC3B,gBAAuB,EACvB,qBAAqB,GACtB,EAAE,iBAAiB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmIvC"}

package/dist/ChatlyWidget.js

@@ -0,0 +1,122 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * <ChatlyWidget /> — drop-in inbox surface. Renders the conversation list when
+ * none is selected, the message view + composer when one is, and (optionally)
+ * the help center via a tab toggle. Mirrors the "open the bubble, see your
+ * conversations" UX of Tawk.to / Intercom mobile SDKs.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { ActivityIndicator, FlatList, Pressable, SafeAreaView, StyleSheet, Text, View, } from 'react-native';
+import { Composer } from './components/Composer';
+import { HelpCenter } from './components/HelpCenter';
+import { MessagesList } from './components/MessagesList';
+import { useChatly } from './useChatly';
+export function ChatlyWidget({ enableHelpCenter = true, initialConversationId, }) {
+    const { isReady, error, conversations, theme, refresh, init } = useChatly();
+    const [tab, setTab] = useState('messages');
+    const [selected, setSelected] = useState(initialConversationId ?? null);
+    useEffect(() => {
+        if (initialConversationId !== undefined) {
+            setSelected(initialConversationId);
+        }
+    }, [initialConversationId]);
+    const onSent = useCallback((conversationId) => {
+        setSelected(conversationId);
+        void refresh();
+    }, [refresh]);
+    if (error !== null) {
+        return (_jsx(SafeAreaView, { style: [styles.fill, { backgroundColor: theme.colors.background }], children: _jsx(View, { style: styles.center, children: _jsx(Text, { style: { color: theme.colors.danger, padding: theme.spacing.lg }, children: `Couldn't load chat: ${error.message}` }) }) }));
+    }
+    if (!isReady) {
+        return (_jsx(SafeAreaView, { style: [styles.fill, { backgroundColor: theme.colors.background }], children: _jsx(View, { style: styles.center, children: _jsx(ActivityIndicator, { color: theme.colors.primary }) }) }));
+    }
+    const header = (_jsxs(View, { style: [
+            styles.header,
+            {
+                borderBottomColor: theme.colors.border,
+                padding: theme.spacing.md,
+                backgroundColor: theme.colors.background,
+            },
+        ], children: [_jsx(Text, { style: {
+                    color: theme.colors.foreground,
+                    fontSize: theme.typography.sizeTitle,
+                    fontWeight: theme.typography.weightBold,
+                }, children: init?.workspace.name ?? 'Support' }), enableHelpCenter && (_jsxs(View, { style: styles.tabs, children: [_jsx(TabButton, { label: "Messages", active: tab === 'messages', onPress: () => setTab('messages') }), _jsx(TabButton, { label: "Help", active: tab === 'help', onPress: () => setTab('help') })] }))] }));
+    if (tab === 'help') {
+        return (_jsxs(SafeAreaView, { style: [styles.fill, { backgroundColor: theme.colors.background }], children: [header, _jsx(HelpCenter, {})] }));
+    }
+    if (selected !== null) {
+        return (_jsxs(SafeAreaView, { style: [styles.fill, { backgroundColor: theme.colors.background }], children: [_jsxs(View, { style: [
+                        styles.header,
+                        {
+                            borderBottomColor: theme.colors.border,
+                            padding: theme.spacing.md,
+                            backgroundColor: theme.colors.background,
+                            flexDirection: 'row',
+                            alignItems: 'center',
+                        },
+                    ], children: [_jsx(Pressable, { onPress: () => setSelected(null), accessibilityRole: "button", accessibilityLabel: "Back to conversation list", style: { paddingRight: theme.spacing.md }, children: _jsx(Text, { style: { color: theme.colors.primary, fontSize: theme.typography.sizeBody }, children: "\u2190" }) }), _jsx(Text, { style: {
+                                color: theme.colors.foreground,
+                                fontSize: theme.typography.sizeTitle,
+                                fontWeight: theme.typography.weightBold,
+                            }, children: "Conversation" })] }), _jsx(MessagesList, { conversationId: selected }), _jsx(Composer, { conversationId: selected, onSent: onSent })] }));
+    }
+    return (_jsxs(SafeAreaView, { style: [styles.fill, { backgroundColor: theme.colors.background }], children: [header, _jsx(ConversationList, { conversations: conversations, onOpen: setSelected }), _jsx(Composer, { conversationId: null, onSent: onSent, placeholder: "Start a new conversation\u2026" })] }));
+}
+function ConversationList({ conversations, onOpen, }) {
+    const { theme } = useChatly();
+    const renderItem = ({ item }) => (_jsxs(Pressable, { onPress: () => onOpen(item.id), accessibilityRole: "button", accessibilityLabel: `Open conversation ${item.subject ?? item.id}`, style: ({ pressed }) => [
+            {
+                padding: theme.spacing.md,
+                backgroundColor: pressed ? theme.colors.surface : theme.colors.background,
+                borderBottomColor: theme.colors.border,
+                borderBottomWidth: StyleSheet.hairlineWidth,
+                flexDirection: 'row',
+                alignItems: 'center',
+            },
+        ], children: [_jsxs(View, { style: { flex: 1 }, children: [_jsx(Text, { style: {
+                            color: theme.colors.foreground,
+                            fontWeight: theme.typography.weightMedium,
+                            fontSize: theme.typography.sizeBody,
+                        }, children: item.subject ?? 'Conversation' }), _jsx(Text, { style: {
+                            color: theme.colors.mutedForeground,
+                            fontSize: theme.typography.sizeSmall,
+                            marginTop: 2,
+                        }, numberOfLines: 1, children: item.lastMessagePreview ?? 'No messages yet.' })] }), item.unreadContactCount > 0 && (_jsx(View, { style: {
+                    backgroundColor: theme.colors.primary,
+                    borderRadius: 999,
+                    minWidth: 22,
+                    paddingHorizontal: 6,
+                    paddingVertical: 2,
+                    alignItems: 'center',
+                }, children: _jsx(Text, { style: {
+                        color: theme.colors.onPrimary,
+                        fontSize: theme.typography.sizeSmall,
+                        fontWeight: theme.typography.weightBold,
+                    }, children: item.unreadContactCount }) }))] }));
+    return (_jsx(FlatList, { data: conversations, keyExtractor: (c) => c.id, renderItem: renderItem, ListEmptyComponent: _jsx(Text, { style: {
+                color: theme.colors.mutedForeground,
+                textAlign: 'center',
+                padding: theme.spacing.lg,
+            }, children: "No conversations yet. Send a message to get started." }) }));
+}
+function TabButton({ label, active, onPress, }) {
+    const { theme } = useChatly();
+    return (_jsx(Pressable, { onPress: onPress, accessibilityRole: "tab", accessibilityState: { selected: active }, style: {
+            paddingHorizontal: theme.spacing.md,
+            paddingVertical: theme.spacing.xs,
+            borderBottomColor: active ? theme.colors.primary : 'transparent',
+            borderBottomWidth: 2,
+        }, children: _jsx(Text, { style: {
+                color: active ? theme.colors.primary : theme.colors.mutedForeground,
+                fontWeight: active ? theme.typography.weightBold : theme.typography.weightRegular,
+                fontSize: theme.typography.sizeBody,
+            }, children: label }) }));
+}
+const styles = StyleSheet.create({
+    fill: { flex: 1 },
+    center: { flex: 1, alignItems: 'center', justifyContent: 'center' },
+    header: { borderBottomWidth: StyleSheet.hairlineWidth },
+    tabs: { flexDirection: 'row', marginTop: 6 },
+});
+//# sourceMappingURL=ChatlyWidget.js.map

package/dist/ChatlyWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatlyWidget.js","sourceRoot":"","sources":["../src/ChatlyWidget.tsx"],"names":[],"mappings":"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"}

package/dist/blocks/money.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Money on a card, restated for the published package.
+ *
+ * ── Why this is a copy and not an import ───────────────────────────────
+ *
+ * The canonical implementation is `packages/shared/src/widget-blocks/money.ts`
+ * and this file is deliberately identical in behaviour. `@livechat/shared` is
+ * `private: true` — it is the monorepo's internal package with a hundred
+ * export paths — so a published npm package cannot depend on it. The same
+ * reason `client/types.ts` restates the realtime types rather than importing
+ * them.
+ *
+ * A copy is a drift risk, so it is pinned rather than trusted:
+ * `money.parity.spec.ts` imports BOTH this and the shared original and
+ * asserts they agree over a currency table that includes the cases a
+ * hand-rolled version gets wrong. `check-block-field-parity.mjs` knows about
+ * the second `Intl.NumberFormat` by name, with that spec as the reason.
+ *
+ * ── Minor units, never a float ─────────────────────────────────────────
+ *
+ * `amount` is an integer count of the currency's smallest unit: 4820 is
+ * $48.20, 4820 is also ¥4,820, and 4820 is 4.820 KWD.
+ *
+ * The DIVISOR IS NOT 100. Three currencies have no minor unit (JPY, KRW, VND)
+ * and four have three digits (KWD, BHD, JOD, OMR), so `(amount / 100)`
+ * renders ¥4,820 as "¥48" and 4.820 KWD as "48.200 KWD" — wrong by two orders
+ * of magnitude in opposite directions, and perfect in USD, which is why it
+ * would ship. The digit count is read off the formatter, so a currency added
+ * to CLDR after this was written is right with no table here.
+ *
+ * React Native ships a full ICU on iOS and, since 0.73 with Hermes
+ * `intl` enabled, on Android too. The `catch` below is what covers an engine
+ * without it: a card with an unrecognised currency still shows a price rather
+ * than taking the thread's render down.
+ */
+/** A price on a card. `amount` and `compareAt` are both MINOR units. */
+export interface Money {
+    readonly amount: number;
+    /** ISO 4217, upper case. */
+    readonly currency: string;
+    /** The was-price. Rendered only when above `amount`. */
+    readonly compareAt?: number;
+}
+/** Read a price off a stored card, or null. Refuses what cannot be drawn. */
+export declare function readMoney(raw: unknown): Money | null;
+/** The locale-free rendition, used as the fallback and for accessibility text. */
+export declare function moneyToPlainText(money: Money): string;
+/**
+ * Format one amount in the DEVICE's locale.
+ *
+ * `locale` undefined means "whatever this device is set to", which is the
+ * right default: the app runs on the shopper's phone and a German shopper
+ * reads `48,20 $`.
+ */
+export declare function formatMoney(money: Money, locale?: string): string;
+//# sourceMappingURL=money.d.ts.map

package/dist/blocks/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/blocks/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,wEAAwE;AACxE,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAOD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAepD;AAOD,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAUjE"}