@linktr.ee/messaging-react 3.3.10-rc-1781610191 → 3.3.10-rc-1781645401

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-B_8de68T.cjs");exports.ActionButton=e.ActionButton;exports.Avatar=e.Avatar;exports.ChannelEmptyState=e.ChannelEmptyState;exports.ChannelList=e.ChannelList;exports.ChannelView=e.ChannelView;exports.CustomMessageProvider=e.CustomMessageProvider;exports.FaqList=e.FaqList;exports.FaqListItem=e.FaqListItem;exports.LinkAttachment=e.LinkAttachment;exports.LockedAttachment=e.LockedAttachment;exports.MediaMessage=e.MediaMessage;exports.MessageAttachment=e.MessageAttachment;exports.MessageVoteButtons=e.MessageVoteButtons;exports.MessagingProvider=e.MessagingProvider;exports.MessagingShell=e.MessagingShell;exports.buildCompactMetaLabel=e.buildCompactMetaLabel;exports.formatFileSize=e.formatFileSize;exports.formatRelativeTime=e.formatRelativeTime;exports.getFileExtensionLabel=e.getFileExtensionLabel;exports.getMessageDisplayText=e.getMessageDisplayText;exports.isLinkAttachment=e.isLinkAttachment;exports.isUuidLike=e.isUuidLike;exports.messageAttachmentGroupPositionFromStream=e.bubbleGroupPositionFromStream;exports.normalizeLanguageCode=e.normalizeLanguageCode;exports.resolveLinkAttachment=e.resolveLinkAttachment;exports.resolveMediaFromMessage=e.resolveMediaFromMessage;exports.resolveParticipantDisplayName=e.resolveParticipantDisplayName;exports.useCustomMessage=e.useCustomMessage;exports.useMessageVote=e.useMessageVote;exports.useMessaging=e.useMessaging;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-3GF2ZDV8.cjs");exports.ActionButton=e.ActionButton;exports.Avatar=e.Avatar;exports.ChannelEmptyState=e.ChannelEmptyState;exports.ChannelList=e.ChannelList;exports.ChannelView=e.ChannelView;exports.CustomMessageProvider=e.CustomMessageProvider;exports.FaqList=e.FaqList;exports.FaqListItem=e.FaqListItem;exports.LinkAttachment=e.LinkAttachment;exports.LockedAttachment=e.LockedAttachment;exports.MediaMessage=e.MediaMessage;exports.MessageAttachment=e.MessageAttachment;exports.MessageVoteButtons=e.MessageVoteButtons;exports.MessagingProvider=e.MessagingProvider;exports.MessagingShell=e.MessagingShell;exports.buildCompactMetaLabel=e.buildCompactMetaLabel;exports.captionDuplicatesLinkUrl=e.captionDuplicatesLinkUrl;exports.formatFileSize=e.formatFileSize;exports.formatRelativeTime=e.formatRelativeTime;exports.getFileExtensionLabel=e.getFileExtensionLabel;exports.getMessageDisplayText=e.getMessageDisplayText;exports.isLinkAttachment=e.isLinkAttachment;exports.isUuidLike=e.isUuidLike;exports.linkAttachmentPropsFromStreamAttachment=e.linkAttachmentPropsFromStreamAttachment;exports.messageAttachmentGroupPositionFromStream=e.bubbleGroupPositionFromStream;exports.normalizeLanguageCode=e.normalizeLanguageCode;exports.normalizeLinkUrl=e.normalizeLinkUrl;exports.resolveLinkAttachment=e.resolveLinkAttachment;exports.resolveMediaFromMessage=e.resolveMediaFromMessage;exports.resolveParticipantDisplayName=e.resolveParticipantDisplayName;exports.resolveStreamLinkUrl=e.resolveStreamLinkUrl;exports.useCustomMessage=e.useCustomMessage;exports.useMessageVote=e.useMessageVote;exports.useMessaging=e.useMessaging;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -84,6 +84,15 @@ export declare interface AvatarProps {
  */
 export declare function buildCompactMetaLabel(mimeType?: string, filename?: string, fileSize?: number): string | undefined;
 
+/**
+ * True when `caption` is *nothing but* the link URL (plus surrounding
+ * punctuation / whitespace), so it can be dropped as redundant with the card's
+ * own URL footer. A caption that adds real words — e.g. `"<url>\n\nhello
+ * there"` — returns false so that text is preserved rather than dropped along
+ * with the redundant URL.
+ */
+export declare function captionDuplicatesLinkUrl(caption: string | undefined, url: string | undefined): boolean;
+
 /**
  * Empty state component shown when a channel has no messages
  * Returns null to show nothing - the LoadingIndicator handles the loading state
@@ -624,6 +633,24 @@ export declare interface LinkAttachmentCta {
  */
 export declare type LinkAttachmentLayout = 'featured' | 'classic';
 
+/**
+ * Maps a Stream `Attachment` (a scraped link / OG preview) to the props for a
+ * `LinkAttachment.Sent` / `LinkAttachment.Received` card — the single source
+ * of truth so the admin and visitor surfaces render link shares identically.
+ */
+export declare function linkAttachmentPropsFromStreamAttachment(attachment: Attachment, options?: LinkAttachmentPropsOptions): StreamLinkAttachmentProps;
+
+export declare interface LinkAttachmentPropsOptions {
+    /**
+     * Hook to transform the raw hero image URL — e.g. apply a CDN size preset or
+     * drop unreliable hosts. Returning a falsy value drops the hero and the card
+     * falls back to the classic (text-only) layout. Defaults to passing the raw
+     * URL through unchanged. App-specific CDN logic belongs here, not in the
+     * shared mapping.
+     */
+    resolveThumbnailUrl?: (raw: string | undefined) => string | undefined;
+}
+
 export declare interface LinkAttachmentReceivedCardProps extends LinkAttachmentBaseProps {
     /**
      * Fired when the recipient activates the card. Behavior depends on how
@@ -1222,6 +1249,9 @@ export declare interface MessagingShellProps extends ChannelViewPassthroughProps
 
 export declare function normalizeLanguageCode(language?: string): string | undefined;
 
+/** Normalize a URL for caption comparison: strip protocol + trailing slash, lowercase. */
+export declare function normalizeLinkUrl(url: string): string;
+
 /**
  * Action intents supported by Linktree official CTA attachments.
  */
@@ -1334,6 +1364,14 @@ export declare function resolveMediaFromMessage(message: LocalMessage): MediaMes
  */
 export declare function resolveParticipantDisplayName(user?: ParticipantDisplayUser | null): string;
 
+/**
+ * Navigation target for a scraped-link attachment. Stream exposes both
+ * `og_scrape_url` (the enriched URL) and `title_link`; prefer the former and
+ * fall back to the latter, ignoring empty / whitespace-only values so they
+ * never produce an empty `href`.
+ */
+export declare function resolveStreamLinkUrl(attachment: Attachment): string | undefined;
+
 export declare interface SentCardProps extends LockedAttachmentBaseProps {
     /** Placeholder shown in the title slot when no title is set. */
     placeholderTitle?: string;
@@ -1347,6 +1385,22 @@ export declare interface SentCardProps extends LockedAttachmentBaseProps {
     onFetchSource?: () => Promise<LockedAttachmentSource | void>;
 }
 
+/**
+ * Props derived from a Stream `Attachment` for rendering a
+ * `LinkAttachment.Sent` / `LinkAttachment.Received` card. The shared mapping
+ * both the admin (mfe-messaging) and visitor (profiles) surfaces use so a
+ * scraped-link attachment renders identically across them, rather than each
+ * app re-deriving these props and drifting apart.
+ */
+export declare interface StreamLinkAttachmentProps {
+    title?: string;
+    description?: string;
+    url?: string;
+    thumbnailUrl?: string;
+    mimeType?: string;
+    layout: LinkAttachmentLayout;
+}
+
 export declare function useCustomMessage<K extends keyof CustomMessageRegistry>(key: K): CustomMessageRegistry[K];
 
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as e, b as t, C as i, c as n, d as o, e as m, F as g, f as l, L as r, h as M, M as u, i as L, j as c, k as h, l as d, m as p, n as v, o as A, p as C, q as F, s as k, t as b, u as f, v as x, w as y, x as P, y as S, z as q, B as z, D as B } from "./index-DGVCJzwy.js";
+import { a as e, b as t, C as i, c as n, d as o, e as m, F as r, f as l, L as g, h as c, M as L, i as M, j as h, k as u, l as p, m as k, n as A, o as d, p as v, q as C, s as F, t as S, u as P, v as b, w as f, x, y, z, B as D, D as U, E as q, G as B, H as E, I as V } from "./index-XXoPu3F3.js";
 export {
   e as ActionButton,
   t as Avatar,
@@ -6,29 +6,33 @@ export {
   n as ChannelList,
   o as ChannelView,
   m as CustomMessageProvider,
-  g as FaqList,
+  r as FaqList,
   l as FaqListItem,
-  r as LinkAttachment,
-  M as LockedAttachment,
-  u as MediaMessage,
-  L as MessageAttachment,
-  c as MessageVoteButtons,
-  h as MessagingProvider,
-  d as MessagingShell,
-  p as buildCompactMetaLabel,
-  v as formatFileSize,
-  A as formatRelativeTime,
+  g as LinkAttachment,
+  c as LockedAttachment,
+  L as MediaMessage,
+  M as MessageAttachment,
+  h as MessageVoteButtons,
+  u as MessagingProvider,
+  p as MessagingShell,
+  k as buildCompactMetaLabel,
+  A as captionDuplicatesLinkUrl,
+  d as formatFileSize,
+  v as formatRelativeTime,
   C as getFileExtensionLabel,
   F as getMessageDisplayText,
-  k as isLinkAttachment,
-  b as isUuidLike,
+  S as isLinkAttachment,
+  P as isUuidLike,
+  b as linkAttachmentPropsFromStreamAttachment,
   f as messageAttachmentGroupPositionFromStream,
   x as normalizeLanguageCode,
-  y as resolveLinkAttachment,
-  P as resolveMediaFromMessage,
-  S as resolveParticipantDisplayName,
-  q as useCustomMessage,
-  z as useMessageVote,
-  B as useMessaging
+  y as normalizeLinkUrl,
+  z as resolveLinkAttachment,
+  D as resolveMediaFromMessage,
+  U as resolveParticipantDisplayName,
+  q as resolveStreamLinkUrl,
+  B as useCustomMessage,
+  E as useMessageVote,
+  V as useMessaging
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/messaging-react",
-  "version": "3.3.10-rc-1781610191",
+  "version": "3.3.10-rc-1781645401",
   "description": "React messaging components built on messaging-core for web applications",
   "type": "module",
   "main": "dist/index.cjs",

package/src/index.ts

@@ -45,6 +45,16 @@ export {
   isUuidLike,
 } from './utils/resolveParticipantDisplayName'
 export type { ParticipantDisplayUser } from './utils/resolveParticipantDisplayName'
+export {
+  linkAttachmentPropsFromStreamAttachment,
+  resolveStreamLinkUrl,
+  captionDuplicatesLinkUrl,
+  normalizeLinkUrl,
+} from './utils/linkAttachmentFromStream'
+export type {
+  StreamLinkAttachmentProps,
+  LinkAttachmentPropsOptions,
+} from './utils/linkAttachmentFromStream'
 
 // Types
 export type {

package/src/utils/linkAttachmentFromStream.test.ts

@@ -0,0 +1,99 @@
+import type { Attachment } from 'stream-chat'
+import { describe, expect, it } from 'vitest'
+
+import {
+  captionDuplicatesLinkUrl,
+  linkAttachmentPropsFromStreamAttachment,
+  normalizeLinkUrl,
+  resolveStreamLinkUrl,
+} from './linkAttachmentFromStream'
+
+const scraped = {
+  title: 'Classic Jazz Albums',
+  text: 'A handpicked set',
+  og_scrape_url: 'https://tr.ee/2DKKNv',
+  image_url: 'https://example.test/cover.jpg',
+  thumb_url: 'https://example.test/thumb.jpg',
+  mime_type: 'text/html',
+} as unknown as Attachment
+
+describe('resolveStreamLinkUrl', () => {
+  it('prefers og_scrape_url over title_link', () => {
+    expect(
+      resolveStreamLinkUrl({
+        og_scrape_url: 'https://tr.ee/a',
+        title_link: 'https://tr.ee/b',
+      } as unknown as Attachment)
+    ).toBe('https://tr.ee/a')
+  })
+
+  it('falls back to title_link', () => {
+    expect(
+      resolveStreamLinkUrl({ title_link: 'https://tr.ee/b' } as unknown as Attachment)
+    ).toBe('https://tr.ee/b')
+  })
+
+  it('ignores empty / whitespace-only values', () => {
+    expect(
+      resolveStreamLinkUrl({ og_scrape_url: '   ' } as unknown as Attachment)
+    ).toBeUndefined()
+  })
+})
+
+describe('linkAttachmentPropsFromStreamAttachment', () => {
+  it('maps title, description, url and a featured layout', () => {
+    expect(linkAttachmentPropsFromStreamAttachment(scraped)).toEqual({
+      title: 'Classic Jazz Albums',
+      description: 'A handpicked set',
+      url: 'https://tr.ee/2DKKNv',
+      thumbnailUrl: 'https://example.test/cover.jpg',
+      mimeType: 'text/html',
+      layout: 'featured',
+    })
+  })
+
+  it('uses the classic layout when there is no hero image', () => {
+    const props = linkAttachmentPropsFromStreamAttachment({
+      title: 'No image',
+      og_scrape_url: 'https://tr.ee/x',
+    } as unknown as Attachment)
+    expect(props.thumbnailUrl).toBeUndefined()
+    expect(props.layout).toBe('classic')
+  })
+
+  it('applies resolveThumbnailUrl and drops the hero when it returns falsy', () => {
+    const props = linkAttachmentPropsFromStreamAttachment(scraped, {
+      resolveThumbnailUrl: () => undefined,
+    })
+    expect(props.thumbnailUrl).toBeUndefined()
+    expect(props.layout).toBe('classic')
+  })
+})
+
+describe('captionDuplicatesLinkUrl', () => {
+  it('is true when the caption is just the URL (any protocol/slash form)', () => {
+    expect(captionDuplicatesLinkUrl('tr.ee/abc', 'https://tr.ee/abc/')).toBe(true)
+  })
+
+  it('is true for a URL-only caption with surrounding punctuation', () => {
+    expect(captionDuplicatesLinkUrl('https://tr.ee/abc !', 'https://tr.ee/abc')).toBe(true)
+  })
+
+  it('keeps a multi-line caption that contains the URL plus real text', () => {
+    expect(
+      captionDuplicatesLinkUrl('https://getsewn.com/\n\nhello there', 'https://getsewn.com/')
+    ).toBe(false)
+  })
+
+  it('is false for an unrelated caption and for empty inputs', () => {
+    expect(captionDuplicatesLinkUrl('Check this out', 'https://tr.ee/abc')).toBe(false)
+    expect(captionDuplicatesLinkUrl('', 'https://tr.ee/abc')).toBe(false)
+    expect(captionDuplicatesLinkUrl('hi', undefined)).toBe(false)
+  })
+})
+
+describe('normalizeLinkUrl', () => {
+  it('strips protocol + trailing slash and lowercases', () => {
+    expect(normalizeLinkUrl('HTTPS://Tr.ee/ABC/')).toBe('tr.ee/abc')
+  })
+})

package/src/utils/linkAttachmentFromStream.ts

@@ -0,0 +1,112 @@
+import type { Attachment } from 'stream-chat'
+
+import type { LinkAttachmentLayout } from '../components/LinkAttachment/types'
+
+/**
+ * Props derived from a Stream `Attachment` for rendering a
+ * `LinkAttachment.Sent` / `LinkAttachment.Received` card. The shared mapping
+ * both the admin (mfe-messaging) and visitor (profiles) surfaces use so a
+ * scraped-link attachment renders identically across them, rather than each
+ * app re-deriving these props and drifting apart.
+ */
+export interface StreamLinkAttachmentProps {
+  title?: string
+  description?: string
+  url?: string
+  thumbnailUrl?: string
+  mimeType?: string
+  layout: LinkAttachmentLayout
+}
+
+type ScrapedAttachment = Attachment & {
+  title?: string
+  text?: string
+  og_scrape_url?: string
+  title_link?: string
+  image_url?: string
+  thumb_url?: string
+  mime_type?: string
+}
+
+/**
+ * Navigation target for a scraped-link attachment. Stream exposes both
+ * `og_scrape_url` (the enriched URL) and `title_link`; prefer the former and
+ * fall back to the latter, ignoring empty / whitespace-only values so they
+ * never produce an empty `href`.
+ */
+export function resolveStreamLinkUrl(attachment: Attachment): string | undefined {
+  const a = attachment as ScrapedAttachment
+  const raw = [a.og_scrape_url, a.title_link].find(
+    (value): value is string => typeof value === 'string'
+  )
+  return raw && raw.trim() !== '' ? raw : undefined
+}
+
+export interface LinkAttachmentPropsOptions {
+  /**
+   * Hook to transform the raw hero image URL — e.g. apply a CDN size preset or
+   * drop unreliable hosts. Returning a falsy value drops the hero and the card
+   * falls back to the classic (text-only) layout. Defaults to passing the raw
+   * URL through unchanged. App-specific CDN logic belongs here, not in the
+   * shared mapping.
+   */
+  resolveThumbnailUrl?: (raw: string | undefined) => string | undefined
+}
+
+/**
+ * Maps a Stream `Attachment` (a scraped link / OG preview) to the props for a
+ * `LinkAttachment.Sent` / `LinkAttachment.Received` card — the single source
+ * of truth so the admin and visitor surfaces render link shares identically.
+ */
+export function linkAttachmentPropsFromStreamAttachment(
+  attachment: Attachment,
+  options?: LinkAttachmentPropsOptions
+): StreamLinkAttachmentProps {
+  const a = attachment as ScrapedAttachment
+  const rawThumbnail = a.image_url ?? a.thumb_url
+  const thumbnailUrl =
+    (options?.resolveThumbnailUrl
+      ? options.resolveThumbnailUrl(rawThumbnail)
+      : rawThumbnail) || undefined
+
+  return {
+    title: a.title,
+    description: a.text,
+    url: resolveStreamLinkUrl(attachment),
+    thumbnailUrl,
+    mimeType: a.mime_type,
+    layout: thumbnailUrl ? 'featured' : 'classic',
+  }
+}
+
+/** Normalize a URL for caption comparison: strip protocol + trailing slash, lowercase. */
+export function normalizeLinkUrl(url: string): string {
+  return url
+    .trim()
+    .replace(/^https?:\/\//i, '')
+    .replace(/\/+$/, '')
+    .toLowerCase()
+}
+
+/**
+ * True when `caption` is *nothing but* the link URL (plus surrounding
+ * punctuation / whitespace), so it can be dropped as redundant with the card's
+ * own URL footer. A caption that adds real words — e.g. `"<url>\n\nhello
+ * there"` — returns false so that text is preserved rather than dropped along
+ * with the redundant URL.
+ */
+export function captionDuplicatesLinkUrl(
+  caption: string | undefined,
+  url: string | undefined
+): boolean {
+  if (!caption?.trim() || !url?.trim()) return false
+
+  const normalizedCaption = normalizeLinkUrl(caption)
+  const normalizedUrl = normalizeLinkUrl(url)
+
+  if (normalizedCaption === normalizedUrl) return true
+  if (!normalizedCaption.includes(normalizedUrl)) return false
+
+  const remainder = normalizedCaption.split(normalizedUrl).join('')
+  return !/[\p{L}\p{N}]/u.test(remainder)
+}