@linktr.ee/messaging-react 2.2.0-rc-1778753733 → 2.2.2-rc-1779314025

package/src/utils/resolveParticipantDisplayName.ts

@@ -0,0 +1,40 @@
+const UUID_REGEX =
+  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i
+
+export type ParticipantDisplayUser = {
+  id?: string
+  name?: string | null
+  username?: string | null
+}
+
+export function isUuidLike(value: string): boolean {
+  return UUID_REGEX.test(value.trim())
+}
+
+function isUsableDisplayValue(
+  value: string | null | undefined,
+  userId?: string
+): value is string {
+  const trimmed = value?.trim()
+  if (!trimmed) return false
+  if (userId && trimmed === userId) return false
+  return !isUuidLike(trimmed)
+}
+
+/**
+ * Resolves a human-readable participant label from Stream user fields.
+ * Never falls back to user.id. UUID-like names are treated as missing.
+ */
+export function resolveParticipantDisplayName(
+  user?: ParticipantDisplayUser | null
+): string {
+  if (isUsableDisplayValue(user?.name, user?.id)) {
+    return user.name.trim()
+  }
+
+  if (isUsableDisplayValue(user?.username, user?.id)) {
+    return user.username.trim()
+  }
+
+  return 'Unknown member'
+}