fix(website): guard tweet entity arrays

Author: moonrailgun

website/src/components/ui/tweet-card.tsx

@@ -9,6 +9,7 @@ import {
 import { getTweet, type Tweet } from 'react-tweet/api';
 
 import { cn } from '../../lib/utils';
+import { normalizeTweetForReactTweet } from './tweet-utils';
 
 interface TwitterIconProps {
   className?: string;
@@ -231,7 +232,7 @@ export const MagicTweet = ({
   components?: TwitterComponents;
   className?: string;
 }) => {
-  const enrichedTweet = enrichTweet(tweet);
+  const enrichedTweet = enrichTweet(normalizeTweetForReactTweet(tweet));
   return (
     <div
       className={cn(

website/src/components/ui/tweet-utils.test.ts

@@ -0,0 +1,57 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import type { Tweet } from 'react-tweet/api';
+import { enrichTweet } from '../../../node_modules/react-tweet/dist/utils.js';
+
+import { normalizeTweetForReactTweet } from './tweet-utils';
+
+const tweetWithSparseEntities = {
+  __typename: 'Tweet',
+  favorite_count: 5,
+  lang: 'en',
+  possibly_sensitive: false,
+  created_at: '2025-01-08T13:21:01.000Z',
+  display_text_range: [0, 24],
+  entities: {
+    urls: [
+      {
+        display_url: 'example.com',
+        expanded_url: 'https://example.com',
+        indices: [13, 24],
+        url: 'https://t.co/example',
+      },
+    ],
+  },
+  id_str: '1876982441312751667',
+  text: 'Tianji works https://t.co/example',
+  user: {
+    id_str: '95831222',
+    name: 'Tianji User',
+    screen_name: 'tianji_user',
+    is_blue_verified: false,
+    profile_image_shape: 'Circle',
+    verified: false,
+    profile_image_url_https: 'https://example.com/avatar.jpg',
+  },
+  edit_control: {
+    edit_tweet_ids: ['1876982441312751667'],
+    editable_until_msecs: '1736346061000',
+    edits_remaining: '5',
+    is_edit_eligible: false,
+  },
+  mediaDetails: [],
+  conversation_count: 2,
+  news_action_type: 'conversation',
+  isEdited: false,
+  isStaleEdit: false,
+} as unknown as Tweet;
+
+test('fills missing tweet entity arrays before react-tweet enrichment', () => {
+  const normalized = normalizeTweetForReactTweet(tweetWithSparseEntities);
+
+  assert.doesNotThrow(() => enrichTweet(normalized));
+  assert.deepEqual(normalized.entities.hashtags, []);
+  assert.deepEqual(normalized.entities.user_mentions, []);
+  assert.deepEqual(normalized.entities.symbols, []);
+  assert.equal('media' in normalized.entities, false);
+});

website/src/components/ui/tweet-utils.ts

@@ -0,0 +1,34 @@
+import type { Tweet, TweetEntities } from 'react-tweet/api';
+
+export function normalizeTweetForReactTweet<T extends Tweet>(tweet: T): T {
+  return {
+    ...tweet,
+    entities: normalizeTweetEntities(tweet.entities),
+    quoted_tweet: tweet.quoted_tweet
+      ? {
+          ...tweet.quoted_tweet,
+          entities: normalizeTweetEntities(tweet.quoted_tweet.entities),
+        }
+      : tweet.quoted_tweet,
+  };
+}
+
+function normalizeTweetEntities(
+  entities: Partial<TweetEntities> = {}
+): TweetEntities {
+  const media =
+    Array.isArray(entities.media) && entities.media.length > 0
+      ? entities.media
+      : undefined;
+
+  return {
+    ...entities,
+    hashtags: Array.isArray(entities.hashtags) ? entities.hashtags : [],
+    urls: Array.isArray(entities.urls) ? entities.urls : [],
+    user_mentions: Array.isArray(entities.user_mentions)
+      ? entities.user_mentions
+      : [],
+    symbols: Array.isArray(entities.symbols) ? entities.symbols : [],
+    ...(media ? { media } : {}),
+  };
+}