@appsupportkit/support-sdk 0.1.2 → 0.3.0

package/src/components/screens/ThreadScreen.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useRef, useState } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 import {
   KeyboardAvoidingView,
   Platform,
@@ -7,26 +7,206 @@ import {
   TextInput,
   View,
 } from 'react-native';
+import type { Translator } from '../../i18n';
 import type { SupportTheme } from '../../theme';
-import type { Thread } from '../../types';
+import type { Thread, ThreadMessage } from '../../types';
 import { USER_MESSAGE_MAX, USER_MESSAGE_MIN } from '../../types';
-import { formatDate, relativeTime } from '../../utils';
-import { Chevron } from '../icons';
+import { dayLabel, formatDate, formatTime, isSameDay, relativeTime } from '../../utils';
+import { ArrowUpIcon, Chevron } from '../icons';
 import {
-  PressableRow,
-  PrimaryButton,
+  IconButton,
   StatusIndicator,
   textStyles,
   TypeChipView,
 } from '../primitives';
 
+/** Consecutive messages from one sender inside this window form a group. */
+const GROUP_WINDOW_MS = 5 * 60 * 1000;
+/** The counter only appears once the limit is actually in play. */
+const COUNTER_VISIBLE_FROM = USER_MESSAGE_MAX - 60;
+
+interface Row {
+  message: ThreadMessage;
+  firstInGroup: boolean;
+  lastInGroup: boolean;
+  /** Date separator to draw above this message, if any. */
+  day: string | null;
+  /** "New" separator above the first message the user hasn't seen. */
+  startsUnread: boolean;
+}
+
+function buildRows(
+  messages: ThreadMessage[],
+  unreadCount: number,
+  strings: Translator,
+): Row[] {
+  // Unread messages are always the newest admin ones, so the divider goes
+  // above the Nth-from-last admin message.
+  let remaining = unreadCount;
+  let firstUnreadId: string | null = null;
+  for (let i = messages.length - 1; i >= 0 && remaining > 0; i -= 1) {
+    const candidate = messages[i];
+    if (candidate === undefined || candidate.sender !== 'admin') continue;
+    remaining -= 1;
+    firstUnreadId = candidate.id;
+  }
+
+  return messages.map((message, i) => {
+    const previous = i > 0 ? (messages[i - 1] ?? null) : null;
+    const next = i < messages.length - 1 ? (messages[i + 1] ?? null) : null;
+    // Grouped by sender alone. Two replies from two different admins are two
+    // messages from "Support" as far as this side is concerned, so breaking
+    // the group between them would be a visible seam with no visible cause.
+    const withinGroup = (a: ThreadMessage | null, b: ThreadMessage) =>
+      a !== null &&
+      a.sender === b.sender &&
+      Math.abs(Date.parse(b.created_at) - Date.parse(a.created_at)) <
+        GROUP_WINDOW_MS;
+
+    const day =
+      previous === null || !isSameDay(previous.created_at, message.created_at)
+        ? dayLabel(message.created_at, strings)
+        : null;
+    const startsUnread = message.id === firstUnreadId;
+
+    return {
+      message,
+      // A separator always breaks a group.
+      firstInGroup: day !== null || startsUnread || !withinGroup(previous, message),
+      lastInGroup:
+        next === null ||
+        next.id === firstUnreadId ||
+        !isSameDay(next.created_at, message.created_at) ||
+        !withinGroup(next, message),
+      day,
+      startsUnread,
+    };
+  });
+}
+
+function Separator({
+  label,
+  theme,
+  tone = 'muted',
+}: {
+  label: string;
+  theme: SupportTheme;
+  tone?: 'muted' | 'accent';
+}) {
+  const color =
+    tone === 'accent' ? theme.colors.accent : theme.colors.textTertiary;
+  return (
+    <View
+      style={{
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap: 10,
+        paddingVertical: 6,
+      }}
+    >
+      <View
+        style={{
+          flex: 1,
+          height: 1,
+          backgroundColor:
+            tone === 'accent' ? theme.colors.accentMuted : theme.colors.border,
+        }}
+      />
+      <Text
+        style={{
+          fontSize: 11,
+          fontWeight: '600',
+          letterSpacing: 0.3,
+          color,
+        }}
+      >
+        {label}
+      </Text>
+      <View
+        style={{
+          flex: 1,
+          height: 1,
+          backgroundColor:
+            tone === 'accent' ? theme.colors.accentMuted : theme.colors.border,
+        }}
+      />
+    </View>
+  );
+}
+
+function MessageBubble({
+  row,
+  theme,
+  strings,
+}: {
+  row: Row;
+  theme: SupportTheme;
+  strings: Translator;
+}) {
+  const { message, firstInGroup, lastInGroup } = row;
+  const own = message.sender === 'user';
+  const round = theme.radii.bubble;
+  const tight = theme.radii.bubbleTail;
+
+  return (
+    <View
+      style={{
+        maxWidth: '86%',
+        alignSelf: own ? 'flex-end' : 'flex-start',
+        alignItems: own ? 'flex-end' : 'flex-start',
+        marginTop: firstInGroup ? 10 : 2,
+        gap: 4,
+      }}
+    >
+      {!own && firstInGroup && (
+        <Text style={[textStyles.meta(theme), { paddingHorizontal: 4 }]}>
+          {strings.t('thread.support')}
+        </Text>
+      )}
+      <View
+        style={{
+          paddingHorizontal: 14,
+          paddingVertical: 10,
+          backgroundColor: own ? theme.colors.accent : theme.colors.surface,
+          borderWidth: own ? 0 : 1,
+          borderColor: theme.colors.border,
+          borderTopLeftRadius: own || firstInGroup ? round : tight,
+          borderBottomLeftRadius: own || lastInGroup ? round : tight,
+          borderTopRightRadius: !own || firstInGroup ? round : tight,
+          borderBottomRightRadius: !own || lastInGroup ? round : tight,
+        }}
+      >
+        <Text
+          style={[
+            textStyles.body(theme),
+            own && { color: theme.colors.accentForeground },
+          ]}
+        >
+          {message.body}
+        </Text>
+      </View>
+      {lastInGroup && (
+        <Text style={[textStyles.meta(theme), { paddingHorizontal: 4 }]}>
+          {/* A reply whose translation is still in flight says so, rather
+              than showing English that changes under the reader. */}
+          {message.translation_pending
+            ? strings.t('thread.translating')
+            : formatTime(message.created_at, strings)}
+        </Text>
+      )}
+    </View>
+  );
+}
+
 export function ThreadScreen({
   theme,
+  strings,
   thread,
   onBack,
   onSend,
 }: {
   theme: SupportTheme;
+  strings: Translator;
   thread: Thread;
   onBack: () => void;
   /** Resolves null on success, or a user-facing error message. */
@@ -36,11 +216,20 @@ export function ThreadScreen({
   const [sending, setSending] = useState(false);
   const [failedMessage, setFailedMessage] = useState<string | null>(null);
   const scrollRef = useRef<ScrollView>(null);
+  // Captured once: opening the thread marks it read within a tick, but the
+  // "New" divider should stay put while the user is reading.
+  const [unreadOnOpen] = useState(thread.unread_count);
 
   const resolved = thread.status === 'resolved';
   const trimmed = draft.trim();
   const valid =
     trimmed.length >= USER_MESSAGE_MIN && trimmed.length <= USER_MESSAGE_MAX;
+  const tooShort = trimmed.length > 0 && trimmed.length < USER_MESSAGE_MIN;
+
+  const rows = useMemo(
+    () => buildRows(thread.messages, unreadOnOpen, strings),
+    [thread.messages, unreadOnOpen, strings],
+  );
 
   useEffect(() => {
     scrollRef.current?.scrollToEnd({ animated: false });
@@ -66,25 +255,25 @@ export function ThreadScreen({
         style={{
           flexDirection: 'row',
           alignItems: 'center',
-          gap: 8,
+          gap: 10,
           paddingHorizontal: 12,
-          paddingBottom: 10,
+          paddingBottom: 12,
           borderBottomWidth: 1,
           borderBottomColor: theme.colors.border,
         }}
       >
-        <PressableRow
+        <IconButton
           onPress={onBack}
           theme={theme}
-          accessibilityLabel="Back"
-          style={{ padding: 6, borderRadius: theme.radii.control }}
+          accessibilityLabel={strings.t('compose.back')}
+          size={32}
         >
           <Chevron color={theme.colors.textSecondary} direction="left" size={12} />
-        </PressableRow>
-        <TypeChipView type={thread.type} theme={theme} />
-        <StatusIndicator status={thread.status} theme={theme} />
+        </IconButton>
+        <TypeChipView type={thread.type} theme={theme} strings={strings} />
+        <StatusIndicator status={thread.status} theme={theme} strings={strings} />
         <Text style={[textStyles.meta(theme), { marginLeft: 'auto' }]}>
-          {relativeTime(thread.created_at)}
+          {relativeTime(thread.created_at, strings)}
         </Text>
       </View>
 
@@ -92,54 +281,34 @@ export function ThreadScreen({
       <ScrollView
         ref={scrollRef}
         style={{ flex: 1 }}
-        contentContainerStyle={{ padding: 16, gap: 10 }}
+        contentContainerStyle={{ paddingHorizontal: 16, paddingVertical: 12 }}
+        keyboardShouldPersistTaps="handled"
+        onContentSizeChange={() =>
+          scrollRef.current?.scrollToEnd({ animated: false })
+        }
       >
-        {thread.messages.map((m) => {
-          const own = m.sender === 'user';
-          return (
-            <View
-              key={m.id}
-              style={{
-                maxWidth: '85%',
-                alignSelf: own ? 'flex-end' : 'flex-start',
-                alignItems: own ? 'flex-end' : 'flex-start',
-                gap: 3,
-              }}
-            >
-              {!own && (
-                <Text style={textStyles.meta(theme)}>
-                  {m.admin_name ?? 'Support'}
-                </Text>
-              )}
-              <View
-                style={{
-                  borderRadius: theme.radii.card,
-                  paddingHorizontal: 12,
-                  paddingVertical: 8,
-                  backgroundColor: own
-                    ? theme.colors.accentMuted
-                    : theme.colors.surface,
-                  borderWidth: own ? 0 : 1,
-                  borderColor: theme.colors.border,
-                }}
-              >
-                <Text style={textStyles.body(theme)}>{m.body}</Text>
-              </View>
-              <Text style={textStyles.meta(theme)}>
-                {relativeTime(m.created_at)}
-              </Text>
-            </View>
-          );
-        })}
-
-        {resolved && thread.resolved_at && (
-          <View style={{ flexDirection: 'row', alignItems: 'center', gap: 10, marginVertical: 6 }}>
-            <View style={{ flex: 1, height: 1, backgroundColor: theme.colors.border }} />
-            <Text style={textStyles.meta(theme)}>
-              Resolved by {thread.resolved_by_name ?? 'support'} ·{' '}
-              {formatDate(thread.resolved_at)}
-            </Text>
-            <View style={{ flex: 1, height: 1, backgroundColor: theme.colors.border }} />
+        {rows.map((row) => (
+          <View key={row.message.id}>
+            {row.day !== null && <Separator label={row.day} theme={theme} />}
+            {row.startsUnread && (
+              <Separator
+                label={strings.t('thread.new')}
+                theme={theme}
+                tone="accent"
+              />
+            )}
+            <MessageBubble row={row} theme={theme} strings={strings} />
+          </View>
+        ))}
+
+        {resolved && thread.resolved_at !== null && (
+          <View style={{ marginTop: 16 }}>
+            <Separator
+              label={strings.t('thread.resolvedAt', {
+                date: formatDate(thread.resolved_at, strings),
+              })}
+              theme={theme}
+            />
           </View>
         )}
       </ScrollView>
@@ -151,74 +320,102 @@ export function ThreadScreen({
           borderTopColor: theme.colors.border,
           paddingHorizontal: 16,
           paddingTop: 10,
+          paddingBottom: 4,
         }}
       >
         {resolved ? (
-          <Text
-            style={[
-              textStyles.meta(theme),
-              { textAlign: 'center', paddingVertical: 8 },
-            ]}
+          <View
+            style={{
+              alignItems: 'center',
+              paddingVertical: 10,
+              borderRadius: theme.radii.control,
+              backgroundColor: theme.colors.surface,
+            }}
           >
-            This thread is resolved and read-only
-          </Text>
+            <Text style={textStyles.secondary(theme)}>
+              {strings.t('thread.readOnly')}
+            </Text>
+          </View>
         ) : (
           <>
-            <TextInput
-              value={draft}
-              onChangeText={(v) => {
-                setDraft(v);
-                setFailedMessage(null);
-              }}
-              multiline
-              placeholder="Reply"
-              placeholderTextColor={theme.colors.textTertiary}
-              style={{
-                minHeight: 60,
-                maxHeight: 120,
-                borderWidth: 1,
-                borderColor: theme.colors.border,
-                borderRadius: theme.radii.control,
-                backgroundColor: theme.colors.surface,
-                color: theme.colors.textPrimary,
-                fontSize: 14,
-                lineHeight: 20,
-                padding: 10,
-                textAlignVertical: 'top',
-              }}
-            />
-            <View
-              style={{
-                flexDirection: 'row',
-                alignItems: 'center',
-                gap: 12,
-                paddingVertical: 8,
-              }}
-            >
-              <Text
-                style={[
-                  textStyles.meta(theme),
-                  draft.length > USER_MESSAGE_MAX && {
-                    color: theme.colors.statusDanger,
-                  },
-                ]}
+            <View style={{ flexDirection: 'row', alignItems: 'flex-end', gap: 10 }}>
+              <TextInput
+                value={draft}
+                onChangeText={(v) => {
+                  setDraft(v);
+                  setFailedMessage(null);
+                }}
+                multiline
+                editable={!sending}
+                placeholder={strings.t('thread.placeholder')}
+                placeholderTextColor={theme.colors.textTertiary}
+                style={{
+                  flex: 1,
+                  minHeight: 44,
+                  maxHeight: 120,
+                  borderWidth: 1,
+                  borderColor: theme.colors.border,
+                  borderRadius: theme.radii.cardLg,
+                  backgroundColor: theme.colors.surface,
+                  color: theme.colors.textPrimary,
+                  fontSize: 15,
+                  lineHeight: 20,
+                  paddingHorizontal: 14,
+                  paddingTop: 12,
+                  paddingBottom: 12,
+                  textAlignVertical: 'top',
+                }}
+              />
+              <IconButton
+                onPress={handleSend}
+                theme={theme}
+                tone="accent"
+                size={44}
+                disabled={!valid || sending}
+                accessibilityLabel={strings.t(
+                  sending ? 'thread.sendingA11y' : 'thread.sendA11y',
+                )}
               >
-                {draft.length}/{USER_MESSAGE_MAX}
-              </Text>
-              {failedMessage !== null && (
-                <Text style={{ fontSize: 11, color: theme.colors.statusDanger }}>
-                  {failedMessage}
-                </Text>
-              )}
-              <View style={{ marginLeft: 'auto' }}>
-                <PrimaryButton
-                  label={sending ? 'Sending…' : 'Send'}
-                  onPress={handleSend}
-                  disabled={!valid || sending}
-                  theme={theme}
-                />
-              </View>
+                <ArrowUpIcon color={theme.colors.accentForeground} size={19} />
+              </IconButton>
             </View>
+
+            {(tooShort ||
+              draft.length >= COUNTER_VISIBLE_FROM ||
+              failedMessage !== null) && (
+              <View
+                style={{
+                  flexDirection: 'row',
+                  alignItems: 'center',
+                  gap: 10,
+                  paddingTop: 8,
+                  paddingHorizontal: 4,
+                }}
+              >
+                {failedMessage !== null ? (
+                  <Text style={{ fontSize: 12, color: theme.colors.statusDanger }}>
+                    {failedMessage}
+                  </Text>
+                ) : tooShort ? (
+                  <Text style={textStyles.meta(theme)}>
+                    {strings.t('compose.minChars', { count: USER_MESSAGE_MIN })}
+                  </Text>
+                ) : null}
+                {draft.length >= COUNTER_VISIBLE_FROM && (
+                  <Text
+                    style={[
+                      textStyles.meta(theme),
+                      { marginLeft: 'auto' },
+                      draft.length > USER_MESSAGE_MAX && {
+                        color: theme.colors.statusDanger,
+                      },
+                    ]}
+                  >
+                    {draft.length}/{USER_MESSAGE_MAX}
+                  </Text>
+                )}
+              </View>
+            )}
           </>
         )}
       </View>

package/src/i18n/index.ts

@@ -0,0 +1,81 @@
+// UI copy, in the user's language.
+//
+// Message bodies are translated by the backend at write time; the sheet's own
+// chrome is not — it is a fixed set of strings that never changes, so it ships
+// as a bundled table. A model call to render the word "Send" would be absurd,
+// and it would also mean the SDK couldn't draw its own UI offline.
+
+import { DEFAULT_LANGUAGE, type Language } from './languages';
+import { en, type StringKey, type StringTable } from './strings/en';
+import { de } from './strings/de';
+import { es } from './strings/es';
+import { fr } from './strings/fr';
+import { hi } from './strings/hi';
+import { it } from './strings/it';
+import { ja } from './strings/ja';
+import { ko } from './strings/ko';
+import { nl } from './strings/nl';
+import { pl } from './strings/pl';
+import { pt } from './strings/pt';
+import { ru } from './strings/ru';
+import { tr } from './strings/tr';
+import { zh } from './strings/zh';
+
+const TABLES: Record<Language, StringTable> = {
+  en,
+  es,
+  fr,
+  de,
+  nl,
+  pt,
+  it,
+  pl,
+  tr,
+  ru,
+  ja,
+  ko,
+  zh,
+  hi,
+};
+
+/** Fills `{name}` placeholders. Unknown tokens are left alone, not blanked. */
+function format(
+  template: string,
+  vars?: Record<string, string | number>,
+): string {
+  if (!vars) return template;
+  return template.replace(/\{(\w+)\}/g, (match, key: string) =>
+    key in vars ? String(vars[key]) : match,
+  );
+}
+
+export interface Translator {
+  language: Language;
+  /**
+   * BCP-47 tag for Intl — dates and times stay in the user's chosen language
+   * rather than the device's, so a sheet never mixes the two.
+   */
+  locale: string;
+  t: (key: StringKey, vars?: Record<string, string | number>) => string;
+}
+
+export function createTranslator(language: Language): Translator {
+  const table = TABLES[language] ?? TABLES[DEFAULT_LANGUAGE];
+  return {
+    language,
+    locale: language,
+    t: (key, vars) => format(table[key] ?? en[key], vars),
+  };
+}
+
+export type { StringKey, StringTable };
+export {
+  asLanguage,
+  baseLanguage,
+  DEFAULT_LANGUAGE,
+  deviceLanguage,
+  isSupportedLanguage,
+  LANGUAGE_LABELS,
+  SUPPORTED_LANGUAGES,
+  type Language,
+} from './languages';