@linktr.ee/messaging-react 1.30.0 → 1.31.0-rc-1776677746

package/dist/Visitor-DyJTWB2_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Visitor-DyJTWB2_.js","sources":["../src/components/LockedAttachment/components/Visitor.tsx"],"sourcesContent":["import {\n  CheckCircleIcon,\n  DownloadSimpleIcon,\n  LockOpenIcon,\n  LockSimpleIcon,\n} from '@phosphor-icons/react'\nimport React, { useCallback, useEffect, useState } from 'react'\n\nimport type { LockedAttachmentBaseProps, LockedAttachmentSource, PaymentStatus } from '../types'\nimport { renderTypeIcon } from '../utils/icons'\nimport { getSourceType } from '../utils/mimeType'\n\nimport MediaPlayer from './MediaPlayer'\n\nexport interface VisitorCardProps extends LockedAttachmentBaseProps {\n  /** \n   * Called when the visitor clicks Unlock. Omit to hide the Unlock button. \n  */\n  onUnlockClick?: () => void\n  /** \n   * Called when the visitor clicks Download on an unlocked card. \n   * Omit to hide the Download button.\n   */\n  onDownloadClick?: () => void\n  /**\n   * Returns current unlock state — sourceUrl (for playback) and redeemUrl (for download).\n   * Bound to the message by the host before being passed down,\n   * so this component receives no Stream Chat types.\n   */\n  onUnlocked?: () => LockedAttachmentSource\n}\n\nconst getLockIcon = (paymentStatus?: PaymentStatus): React.ElementType => {\n  return paymentStatus === 'paid' ? LockOpenIcon : LockSimpleIcon\n}\n\ninterface LockOverlayProps {\n  icon: React.ElementType\n}\n\nconst LockOverlay: React.FC<LockOverlayProps> = (props) => {\n  const { icon: Icon } = props\n  return (\n    <div className=\"absolute inset-0 bg-black/30\">\n      <div className=\"absolute left-3 top-3 flex size-8 items-center justify-center rounded-full bg-black/60\">\n        <Icon className=\"size-4 text-white\" weight=\"fill\" />\n      </div>\n    </div>\n  )\n}\n\ninterface LockedPreviewProps {\n  thumbnailUrl?: string\n  mimeType: string\n  LockIcon: React.ElementType\n}\n\nconst LockedPreview: React.FC<LockedPreviewProps> = (props) => {\n  const { thumbnailUrl, mimeType, LockIcon } = props\n  return (\n    <div className=\"relative aspect-video overflow-hidden bg-black/5\">\n      {thumbnailUrl ? (\n        <img\n          src={thumbnailUrl}\n          alt=\"\"\n          className=\"absolute inset-0 h-full w-full object-cover\"\n        />\n      ) : (\n        <div className=\"absolute inset-0 flex items-center justify-center\">\n          {renderTypeIcon(mimeType, {\n            className: 'size-12 text-black/20',\n            weight: 'regular',\n          })}\n        </div>\n      )}\n      <LockOverlay icon={LockIcon} />\n    </div>\n  )\n}\n\ninterface ImagePreviewProps {\n  sourceUrl?: string\n  thumbnailUrl?: string\n  mimeType: string\n  title?: string\n  paymentStatus?: PaymentStatus\n  isLocked: boolean\n}\n\nconst ImagePreview: React.FC<ImagePreviewProps> = (props) => {\n  const { sourceUrl, thumbnailUrl, mimeType, title, paymentStatus, isLocked } = props\n  const [sourceReady, setSourceReady] = useState(false)\n\n  if (isLocked) {\n    return (\n      <LockedPreview\n        thumbnailUrl={thumbnailUrl}\n        mimeType={mimeType}\n        LockIcon={getLockIcon(paymentStatus)}\n      />\n    )\n  }\n\n  return (\n    <div className=\"relative overflow-hidden bg-black/5\">\n      <img\n        src={sourceUrl}\n        alt={title}\n        className={`block w-full transition-opacity duration-300 ${sourceReady ? 'opacity-100' : 'opacity-0'}`}\n        onLoad={() => setSourceReady(true)}\n      />\n    </div>\n  )\n}\n\ninterface DocumentPreviewProps {\n  thumbnailUrl?: string\n  mimeType: string\n  paymentStatus?: PaymentStatus\n  isLocked: boolean\n}\n\nconst DocumentPreview: React.FC<DocumentPreviewProps> = (props) => {\n  const { thumbnailUrl, mimeType, paymentStatus, isLocked } = props\n  return (\n    <div className=\"relative aspect-video overflow-hidden bg-black/5\">\n      {thumbnailUrl ? (\n        <img\n          src={thumbnailUrl}\n          alt=\"\"\n          className=\"absolute inset-0 h-full w-full object-cover\"\n        />\n      ) : (\n        <div className=\"absolute inset-0 flex items-center justify-center\">\n          {renderTypeIcon(mimeType, {\n            className: 'size-12 text-black/20',\n            weight: 'regular',\n          })}\n        </div>\n      )}\n      {isLocked && <LockOverlay icon={getLockIcon(paymentStatus)} />}\n    </div>\n  )\n}\n\ninterface MediaPreviewProps {\n  sourceUrl?: string\n  thumbnailUrl?: string\n  mimeType: string\n  paymentStatus?: PaymentStatus\n  isLocked: boolean\n}\n\nconst MediaPreview: React.FC<MediaPreviewProps> = (props) => {\n  const { sourceUrl, thumbnailUrl, mimeType, paymentStatus, isLocked } = props\n  if (isLocked) {\n    return (\n      <LockedPreview\n        thumbnailUrl={thumbnailUrl}\n        mimeType={mimeType}\n        LockIcon={getLockIcon(paymentStatus)}\n      />\n    )\n  }\n  return (\n    <MediaPlayer\n      source={sourceUrl!}\n      mimeType={mimeType}\n      poster={thumbnailUrl}\n    />\n  )\n}\n\nconst LoadingDots = () => (\n  <span className=\"flex items-center gap-1\">\n    <span className=\"size-1 rounded-full bg-white animate-bounce [animation-delay:-0.3s]\" />\n    <span className=\"size-1 rounded-full bg-white animate-bounce [animation-delay:-0.15s]\" />\n    <span className=\"size-1 rounded-full bg-white animate-bounce\" />\n  </span>\n)\n\ninterface CardActionsProps {\n  isLocked: boolean\n  isUnlocking?: boolean\n  sourceUrl?: string\n  redeemUrl?: string\n  onUnlockClicked?: () => void\n  onDownloadClicked?: () => void\n}\n\nconst CardActions: React.FC<CardActionsProps> = (props) => {\n  const {\n    isLocked,\n    isUnlocking,\n    sourceUrl,\n    redeemUrl,\n    onUnlockClicked,\n    onDownloadClicked,\n  } = props\n\n  if (isLocked && onUnlockClicked) {\n    return (\n      <button\n        type=\"button\"\n        onClick={onUnlockClicked}\n        disabled={isUnlocking}\n        className=\"mt-3 inline-flex h-10 w-full items-center justify-center gap-2 rounded-full bg-[#121110] px-4 text-sm font-medium leading-none text-white hover:bg-[#2a2928] disabled:opacity-70\"\n      >\n        {isUnlocking ? (\n          <LoadingDots />\n        ) : (\n          <>\n            <LockSimpleIcon className=\"size-4\" weight=\"fill\" />\n            Unlock\n          </>\n        )}\n      </button>\n    )\n  }\n\n  if (!isLocked && onDownloadClicked && sourceUrl) {\n    return (\n      <a\n        href={redeemUrl ?? sourceUrl}\n        target=\"_blank\"\n        rel=\"noopener noreferrer\"\n        onClick={onDownloadClicked}\n        className=\"mt-3 inline-flex h-10 w-full items-center justify-center gap-2 rounded-full bg-[#121110] px-4 text-sm font-medium leading-none !text-white hover:bg-[#2a2928]\"\n      >\n        <DownloadSimpleIcon className=\"size-4\" weight=\"bold\" />\n        Download\n      </a>\n    )\n  }\n\n  return null\n}\n\nconst VisitorCard: React.FC<VisitorCardProps> = (props) => {\n  const {\n    title,\n    amountText,\n    thumbnailUrl,\n    mimeType = 'application/octet-stream',\n    detail,\n    onUnlocked,\n    onUnlockClick,\n    onDownloadClick,\n    paymentStatus,\n  } = props\n\n  const { sourceUrl, redeemUrl } = onUnlocked?.() ?? {}\n  const [isUnlocking, setUnlocking] = useState(false)\n\n  const isLocked = sourceUrl === undefined\n  const sourceType = getSourceType(mimeType)\n\n  useEffect(() => {\n    if (sourceUrl !== undefined) {\n      setUnlocking(false)\n    }\n  }, [sourceUrl])\n\n  const onUnlockClicked = useCallback(() => {\n    if (onUnlockClick) {\n      setUnlocking(true)\n      onUnlockClick()\n    }\n  }, [onUnlockClick])\n\n  let mediaPreview: React.ReactNode\n  if (sourceType === 'image') {\n    mediaPreview = (\n      <ImagePreview\n        key={sourceUrl}\n        sourceUrl={sourceUrl}\n        thumbnailUrl={thumbnailUrl}\n        mimeType={mimeType}\n        title={title}\n        paymentStatus={paymentStatus}\n        isLocked={isLocked}\n      />\n    )\n  } else if (sourceType === 'document') {\n    mediaPreview = (\n      <DocumentPreview\n        thumbnailUrl={thumbnailUrl}\n        mimeType={mimeType}\n        paymentStatus={paymentStatus}\n        isLocked={isLocked}\n      />\n    )\n  } else {\n    mediaPreview = (\n      <MediaPreview\n        key={sourceUrl}\n        sourceUrl={sourceUrl}\n        thumbnailUrl={thumbnailUrl}\n        mimeType={mimeType}\n        paymentStatus={paymentStatus}\n        isLocked={isLocked}\n      />\n    )\n  }\n\n  return (\n    <div className=\"w-[280px] select-none overflow-hidden rounded-[24px] bg-white shadow-[0_0_0_1px_rgba(0,0,0,0.04),0_4px_8px_rgba(0,0,0,0.06)]\">\n      {mediaPreview}\n      <div className=\"px-4 pb-3 pt-3\">\n        <p className=\"mb-1.5 truncate text-base font-medium text-black\">\n          {title}\n        </p>\n        <div className=\"flex items-center gap-1\">\n          {renderTypeIcon(mimeType, {\n            className: 'size-5 shrink-0 text-black/55',\n            weight: 'regular',\n          })}\n          {detail && (\n            <span className=\"text-xs font-medium text-black/55\">{detail}</span>\n          )}\n          {paymentStatus === 'paid' ? (\n            <React.Fragment>\n              <span className=\"text-xs font-medium text-black/55\">•</span>\n              <span className=\"text-xs font-medium text-[#008236]\">\n                Purchased\n              </span>\n              <CheckCircleIcon\n                className=\"size-4 text-[#008236]\"\n                weight=\"bold\"\n              />\n            </React.Fragment>\n          ) : (\n            amountText && (\n              <React.Fragment>\n                <span className=\"text-xs font-medium text-black/55\">•</span>\n                <span className=\"text-xs font-medium text-black/55\">\n                  {amountText}\n                </span>\n              </React.Fragment>\n            )\n          )}\n        </div>\n        <CardActions\n          isLocked={isLocked}\n          isUnlocking={isUnlocking}\n          sourceUrl={sourceUrl}\n          redeemUrl={redeemUrl}\n          onUnlockClicked={onUnlockClicked}\n          onDownloadClicked={onDownloadClick}\n        />\n      </div>\n    </div>\n  )\n}\n\nexport default VisitorCard\n"],"names":["getLockIcon","paymentStatus","LockOpenIcon","LockSimpleIcon","LockOverlay","props","Icon","jsx","LockedPreview","thumbnailUrl","mimeType","LockIcon","jsxs","ImagePreview","sourceUrl","title","isLocked","sourceReady","setSourceReady","useState","DocumentPreview","MediaPreview","MediaPlayer","LoadingDots","CardActions","isUnlocking","redeemUrl","onUnlockClicked","onDownloadClicked","Fragment","DownloadSimpleIcon","VisitorCard","amountText","detail","onUnlocked","onUnlockClick","onDownloadClick","setUnlocking","sourceType","getSourceType","useEffect","useCallback","mediaPreview","renderTypeIcon","React","CheckCircleIcon"],"mappings":"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"}

package/dist/index.d.ts

@@ -111,7 +111,7 @@ export declare const ChannelView: default_2.NamedExoticComponent<ChannelViewProp
  * Props that MessagingShell passes through to ChannelView.
  * ChannelViewProps is the source of truth for these props.
  */
-declare type ChannelViewPassthroughProps = Pick<ChannelViewProps, 'renderMessageInputActions' | 'renderConversationFooter' | 'CustomChannelEmptyState' | 'onDeleteConversationClick' | 'onBlockParticipantClick' | 'onReportParticipantClick' | 'dmAgentEnabled' | 'messageMetadata' | 'onMessageSent' | 'showStarButton' | 'chatbotVotingEnabled' | 'renderChannelBanner' | 'customProfileContent' | 'customChannelActions' | 'renderMessage' | 'onAttachmentUnlock' | 'onAttachmentDownload'>;
+declare type ChannelViewPassthroughProps = Pick<ChannelViewProps, 'renderMessageInputActions' | 'renderConversationFooter' | 'CustomChannelEmptyState' | 'onDeleteConversationClick' | 'onBlockParticipantClick' | 'onReportParticipantClick' | 'dmAgentEnabled' | 'messageMetadata' | 'onMessageSent' | 'showStarButton' | 'chatbotVotingEnabled' | 'renderChannelBanner' | 'customProfileContent' | 'customChannelActions' | 'renderMessage' | 'onAttachmentUnlockClick' | 'onAttachmentDownloadClick' | 'onAttachmentUnlocked'>;
 
 /**
  * ChannelView component props
@@ -217,22 +217,27 @@ export declare interface ChannelViewProps {
      */
     renderMessage?: (messageNode: React.ReactElement, message: LocalMessage) => React.ReactNode;
     /**
-     * Called when the visitor clicks Unlock on a locked attachment message.
-     * Receives the message and channel. Show checkout, confirm payment, fetch
-     * the unlocked URL. `attachment_source` must NOT be stored on the Stream message metadata.
-     * The card shows a loading state for the full duration of the promise.
+     * Called when the visitor clicks Unlock on a locked attachment card.
+     * Fire-and-forget; host is responsible for opening checkout and tracking unlock state.
      */
-    onAttachmentUnlock?: (message: LocalMessage, channel: Channel) => Promise<LockedAttachmentSource>;
+    onAttachmentUnlockClick?: (message: LocalMessage, channel: Channel) => void;
     /**
-     * Called when the visitor clicks Download on an unlocked attachment message.
+     * Called when the visitor clicks Download on an unlocked attachment card.
      */
-    onAttachmentDownload?: (message: LocalMessage, channel: Channel) => void;
+    onAttachmentDownloadClick?: (message: LocalMessage, channel: Channel) => void;
+    /**
+     * Returns the current unlock state for a given message ID.
+     * Called by CustomMessage on each render to drive controlled props on LockedAttachment.
+     * Host owns sourceUrl / redeemUrl state.
+     */
+    onAttachmentUnlocked?: (message: LocalMessage, channel: Channel) => LockedAttachmentSource;
 }
 
 declare interface CreatorCardProps extends LockedAttachmentBaseProps {
     isPreview?: boolean;
     placeholderTitle?: string;
     placeholderAmountText?: string;
+    sourceUrl?: string;
     onDismiss?: () => void;
 }
 
@@ -276,19 +281,21 @@ export declare const formatRelativeTime: (date: Date) => string;
 export declare const LockedAttachment: (props: LockedAttachmentProps) => JSX_2.Element;
 
 declare interface LockedAttachmentBaseProps {
+    mimeType: string;
     title?: string;
-    mimeType?: string;
-    thumbnail?: string;
-    source?: string;
+    thumbnailUrl?: string;
     detail?: string;
     amountText?: string;
     paymentStatus?: PaymentStatus;
 }
 
-export declare type LockedAttachmentProps = (CreatorCardProps & Never<VisitorCardProps, 'onUnlock' | 'onDownload'>) | (VisitorCardProps & Never<CreatorCardProps, 'isPreview' | 'placeholderTitle' | 'placeholderAmountText' | 'onDismiss'>);
+export declare type LockedAttachmentProps = (CreatorCardProps & Never<VisitorCardProps, 'onUnlockClick' | 'onDownloadClick' | 'onUnlocked'>) | (VisitorCardProps & Never<CreatorCardProps, 'isPreview' | 'placeholderTitle' | 'placeholderAmountText' | 'sourceUrl' | 'onDismiss'>);
 
 export declare interface LockedAttachmentSource {
-    source: string;
+    /** Proxied URL used by the media player for in-app playback. */
+    sourceUrl: string;
+    /** URL opened when the visitor clicks Download — may be a file or a web destination. */
+    redeemUrl?: string;
 }
 
 declare type MessageCustomType = 'MESSAGE_TIP' | 'MESSAGE_PAID' | 'MESSAGE_CHATBOT' | 'MESSAGE_ATTACHMENT' | AgeSafetySystemType | DmAgentSystemType;
@@ -519,13 +526,20 @@ export declare const useParticipants: (participantSource: ParticipantSource, opt
 
 declare interface VisitorCardProps extends LockedAttachmentBaseProps {
     /**
-     * Called when the visitor clicks Unlock. Return the resolved source URL.
-     * The component manages loading state and sets source internally on resolution.
-     * Omit to hide the Unlock button.
+     * Called when the visitor clicks Unlock. Omit to hide the Unlock button.
+     */
+    onUnlockClick?: () => void;
+    /**
+     * Called when the visitor clicks Download on an unlocked card.
+     * Omit to hide the Download button.
+     */
+    onDownloadClick?: () => void;
+    /**
+     * Returns current unlock state — sourceUrl (for playback) and redeemUrl (for download).
+     * Bound to the message by the host before being passed down,
+     * so this component receives no Stream Chat types.
      */
-    onUnlock?: () => Promise<LockedAttachmentSource>;
-    /** Called when the visitor clicks Download on an unlocked card. */
-    onDownload?: () => void;
+    onUnlocked?: () => LockedAttachmentSource;
 }
 
 export declare type VoteSelection = 'up' | 'down' | null;