stream-chat-react-native-core 9.11.3 → 9.12.0-beta.1

package/src/store/apis/__tests__/pollTranslations.test.ts

@@ -0,0 +1,136 @@
+import type { ChannelAPIResponse, PollResponse } from 'stream-chat';
+
+import { generateChannelResponse } from '../../../mock-builders/generator/channel';
+import { generateMessage } from '../../../mock-builders/generator/message';
+import { BetterSqlite } from '../../../test-utils/BetterSqlite';
+import { SqliteClient } from '../../SqliteClient';
+import { getChannels } from '../getChannels';
+import { upsertChannels } from '../upsertChannels';
+import { upsertPoll } from '../upsertPoll';
+
+const POLL_ID = 'poll-id';
+
+const translatedPoll = {
+  answers_count: 0,
+  created_at: '2026-10-27T10:00:00.000Z',
+  created_by: { id: 'other-user' },
+  created_by_id: 'other-user',
+  description: 'For the team dinner',
+  description_i18n: { es_text: 'Para la cena del equipo', language: 'en' },
+  enforce_unique_vote: true,
+  id: POLL_ID,
+  latest_answers: [],
+  latest_votes_by_option: {},
+  max_votes_allowed: 1,
+  name: 'Favourite colour?',
+  name_i18n: { es_text: '¿Color favorito?', language: 'en' },
+  options: [
+    {
+      id: 'option-red',
+      poll_id: POLL_ID,
+      text: 'Red',
+      text_i18n: { es_text: 'Rojo', language: 'en' },
+    },
+  ],
+  updated_at: '2026-10-27T10:00:00.000Z',
+  vote_count: 0,
+  vote_counts_by_option: {},
+} as unknown as PollResponse;
+
+/**
+ * The backend translates poll texts. The offline DB has to keep those translations, so a cold start
+ * offline shows the poll in the user's language, the same way message translations are kept.
+ */
+describe('poll translations in the offline DB', () => {
+  let cid: string;
+
+  beforeEach(async () => {
+    await SqliteClient.initializeDatabase();
+    await BetterSqlite.openDB();
+
+    const channelResponse = generateChannelResponse({ members: [], messages: [] });
+    cid = channelResponse.channel.cid as string;
+    channelResponse.messages = [
+      generateMessage({ cid, poll: translatedPoll, poll_id: POLL_ID, text: '' }),
+    ] as unknown as typeof channelResponse.messages;
+    await upsertChannels({
+      channels: [channelResponse] as unknown as ChannelAPIResponse[],
+      isLatestMessagesSet: true,
+    });
+  });
+
+  afterEach(() => {
+    BetterSqlite.dropAllTables();
+    BetterSqlite.closeDB();
+  });
+
+  const getStoredPoll = async () => {
+    const [channel] = await getChannels({ channelIds: [cid], currentUserId: 'some-user' });
+    return channel.messages[0].poll;
+  };
+
+  it("keeps the question's, description's and options' translations", async () => {
+    const poll = await getStoredPoll();
+
+    expect(poll?.name_i18n).toEqual(translatedPoll.name_i18n);
+    expect(poll?.description_i18n).toEqual(translatedPoll.description_i18n);
+    expect(poll?.options[0].text_i18n).toEqual(translatedPoll.options[0].text_i18n);
+  });
+
+  it('replaces the translations when the poll is stored again', async () => {
+    const name_i18n = { de_text: 'Lieblingsfarbe?', language: 'en' };
+    await upsertPoll({ poll: { ...translatedPoll, name_i18n } as PollResponse });
+
+    expect((await getStoredPoll())?.name_i18n).toEqual(name_i18n);
+  });
+
+  it('stores a poll without translations unchanged', async () => {
+    const {
+      description_i18n: _description_i18n,
+      name_i18n: _name_i18n,
+      ...untranslatedPoll
+    } = translatedPoll;
+    const untranslatedChannel = generateChannelResponse({ members: [], messages: [] });
+    const untranslatedCid = untranslatedChannel.channel.cid as string;
+    untranslatedChannel.messages = [
+      generateMessage({
+        cid: untranslatedCid,
+        poll: {
+          ...untranslatedPoll,
+          id: 'untranslated-poll-id',
+          options: [{ id: 'option-red', poll_id: 'untranslated-poll-id', text: 'Red' }],
+        } as unknown as PollResponse,
+        poll_id: 'untranslated-poll-id',
+        text: '',
+      }),
+    ] as unknown as typeof untranslatedChannel.messages;
+    await upsertChannels({
+      channels: [untranslatedChannel] as unknown as ChannelAPIResponse[],
+      isLatestMessagesSet: true,
+    });
+
+    const [channel] = await getChannels({
+      channelIds: [untranslatedCid],
+      currentUserId: 'some-user',
+    });
+    const poll = channel.messages[0].poll;
+
+    expect(poll?.name).toBe('Favourite colour?');
+    expect(poll?.description).toBe('For the team dinner');
+    expect(poll?.options).toEqual([
+      { id: 'option-red', poll_id: 'untranslated-poll-id', text: 'Red' },
+    ]);
+    expect(poll?.name_i18n).toBeUndefined();
+    expect(poll?.description_i18n).toBeUndefined();
+  });
+
+  it('clears translations that the poll no longer has', async () => {
+    await upsertPoll({
+      poll: { ...translatedPoll, description_i18n: undefined, name_i18n: undefined },
+    });
+
+    const poll = await getStoredPoll();
+    expect(poll?.name_i18n).toBeUndefined();
+    expect(poll?.description_i18n).toBeUndefined();
+  });
+});

package/src/store/mappers/mapPollToStorable.ts

@@ -13,6 +13,7 @@ export const mapPollToStorable = (poll: PollResponse): TableRow<'poll'> => {
     created_by,
     created_by_id,
     description,
+    description_i18n,
     enforce_unique_vote,
     id,
     is_closed,
@@ -20,6 +21,7 @@ export const mapPollToStorable = (poll: PollResponse): TableRow<'poll'> => {
     latest_votes_by_option,
     max_votes_allowed,
     name,
+    name_i18n,
     options,
     own_votes,
     updated_at,
@@ -36,6 +38,9 @@ export const mapPollToStorable = (poll: PollResponse): TableRow<'poll'> => {
     created_by: JSON.stringify(created_by), // decouple the users from the actual poll
     created_by_id,
     description,
+    // Always written (as `null` when absent): an upsert skips undefined columns, which would keep
+    // translations the server has since dropped, e.g. after the question was edited.
+    description_i18n: JSON.stringify(description_i18n ?? null),
     enforce_unique_vote,
     id,
     is_closed,
@@ -43,6 +48,7 @@ export const mapPollToStorable = (poll: PollResponse): TableRow<'poll'> => {
     latest_votes_by_option: JSON.stringify(latest_votes_by_option),
     max_votes_allowed,
     name,
+    name_i18n: JSON.stringify(name_i18n ?? null),
     options: JSON.stringify(options),
     own_votes: JSON.stringify(own_votes),
     updated_at,

package/src/store/mappers/mapStorableToPoll.ts

@@ -11,6 +11,7 @@ export const mapStorableToPoll = (pollRow: TableRow<'poll'>): PollResponse => {
     created_by,
     created_by_id,
     description,
+    description_i18n,
     enforce_unique_vote,
     id,
     is_closed,
@@ -18,6 +19,7 @@ export const mapStorableToPoll = (pollRow: TableRow<'poll'>): PollResponse => {
     latest_votes_by_option,
     max_votes_allowed,
     name,
+    name_i18n,
     options,
     own_votes,
     updated_at,
@@ -34,6 +36,7 @@ export const mapStorableToPoll = (pollRow: TableRow<'poll'>): PollResponse => {
     created_by: JSON.parse(created_by),
     created_by_id,
     description,
+    description_i18n: description_i18n ? (JSON.parse(description_i18n) ?? undefined) : undefined,
     enforce_unique_vote,
     id,
     is_closed,
@@ -41,6 +44,7 @@ export const mapStorableToPoll = (pollRow: TableRow<'poll'>): PollResponse => {
     latest_votes_by_option: JSON.parse(latest_votes_by_option),
     max_votes_allowed,
     name,
+    name_i18n: name_i18n ? (JSON.parse(name_i18n) ?? undefined) : undefined,
     options: JSON.parse(options),
     own_votes: own_votes ? JSON.parse(own_votes) : [],
     updated_at,

package/src/store/schema.ts

@@ -224,6 +224,7 @@ export const tables: Tables = {
       created_by: 'TEXT',
       created_by_id: 'TEXT',
       description: 'TEXT',
+      description_i18n: 'TEXT',
       enforce_unique_vote: 'BOOLEAN DEFAULT FALSE',
       id: 'TEXT NOT NULL',
       is_closed: 'BOOLEAN DEFAULT FALSE',
@@ -231,6 +232,7 @@ export const tables: Tables = {
       latest_votes_by_option: 'TEXT',
       max_votes_allowed: 'INTEGER DEFAULT 1',
       name: 'TEXT',
+      name_i18n: 'TEXT',
       options: 'TEXT',
       own_votes: 'TEXT',
       updated_at: 'TEXT',
@@ -459,7 +461,9 @@ export type Schema = {
     allow_answers?: boolean;
     allow_user_suggested_options?: boolean;
     description?: string;
+    description_i18n?: string;
     is_closed?: boolean;
+    name_i18n?: string;
     own_votes?: string;
     voting_visibility?: string;
   };

package/src/utils/i18n/__tests__/getTranslatedText.test.ts

@@ -0,0 +1,19 @@
+import type { TranslatedField } from 'stream-chat';
+
+import { getTranslatedText } from '../getTranslatedText';
+
+describe('getTranslatedText', () => {
+  const i18n = { de_text: 'Wie geht es?', language: 'en' } as TranslatedField;
+
+  it('returns the translation into the given language', () => {
+    expect(getTranslatedText(i18n, 'de')).toBe('Wie geht es?');
+  });
+
+  it('returns undefined when there is no translation into the given language', () => {
+    expect(getTranslatedText(i18n, 'fr')).toBeUndefined();
+  });
+
+  it('returns undefined when the text has no translations', () => {
+    expect(getTranslatedText(undefined, 'de')).toBeUndefined();
+  });
+});

package/src/utils/i18n/getTranslatedText.ts

@@ -0,0 +1,9 @@
+import type { TranslatedField, TranslationLanguages } from 'stream-chat';
+
+/**
+ * Returns the translation of a text into `language`, or undefined if there is none.
+ */
+export const getTranslatedText = (
+  i18n: TranslatedField | undefined,
+  language: TranslationLanguages,
+): string | undefined => i18n?.[`${language}_text` as `${TranslationLanguages}_text`];

package/src/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "9.11.3"
+  "version": "9.12.0-beta.1"
 }