Python
// ConnectorMessageCard — renders a connector-delivered inbound message (§3.3) as a structured card:
// a brand-tinted header (ConnectorBadge + channel/sender names + relative time + "via {label}") over
// the raw message body, with a brand-colored left edge. Pure presentational; generalizes to any
// connector via the Phase-1 registry — no Slack special-casing.
//
// Brand color/logo: the message `source` (§3.1) carries only the `connector` id, not visuals. The
// logo + label resolve from the connector registry by that id (FALLBACK plug glyph for unknown ids);
// the brand color isn't in the source, so it comes from an optional `brandColor` prop and otherwise
// falls back to the registry's neutral gray (the descriptor's `brand_color` is the source of truth,
// so callers that have the connector list can thread the real color through later).
//
// Id-on-hover swap: hovering (or focusing) the header replaces the resolved names with
// `channel_id · sender_id`. Driven by React state (not CSS :hover) so the swap is testable and works
// for keyboard focus too; the ids are also mirrored into the header `title` for quick reference.
import { useState, type CSSProperties } from "react";
import { useTranslation } from "react-i18next";
import type { MessageSource } from "../api";
import { ConnectorBadge, hexToRgba, NEUTRAL } from "../connectors/ConnectorIcon";
import { resolveConnector } from "../connectors/registry";
/** Coarse relative time from epoch seconds: "just now" / "5m ago" / "2h ago" / "3d ago" / a date. */
export function relativeTime(tsSeconds: number, t: (key: string, opts?: any) => string): string {
if (!tsSeconds || !isFinite(tsSeconds)) return "";
const then = tsSeconds * 1000;
const diff = Date.now() - then;
if (diff < 0) return t("inbox.rel_just_now");
if (diff < 45_000) return t("inbox.rel_just_now");
const mins = Math.round(diff / 60_000);
if (mins < 60) return t("inbox.rel_minutes_ago", { count: mins });
const hrs = Math.round(diff / 3_600_000);
if (hrs < 24) return t("inbox.rel_hours_ago", { count: hrs });
const days = Math.round(diff / 86_400_000);
if (days < 7) return t("inbox.rel_days_ago", { count: days });
return new Date(then).toLocaleDateString();
}
/** Absolute clock time (for the time element's title), e.g. "2:14 PM". */
function clockTime(tsSeconds: number): string {
if (!tsSeconds || !isFinite(tsSeconds)) return "";
return new Date(tsSeconds * 1000).toLocaleTimeString([], { hour: "numeric", minute: "2-digit" });
}
export function ConnectorMessageCard({
source,
brandColor,
}: {
source: MessageSource;
brandColor?: string;
}) {
const [showIds, setShowIds] = useState(false);
const { t } = useTranslation();
const { key, entry } = resolveConnector(source.connector);
const color = (brandColor || "").trim() || NEUTRAL;
const soft = hexToRgba(color, 0.12) || "var(--line)";
// Only the brand custom props on the article (NOT `color`, so the body keeps normal text color);
// the header/channel pull `var(--brand)` and the badge computes its own tint from the prop.
const styleVars = { ["--brand"]: color, ["--brand-soft"]: soft } as CSSProperties;
const ids = `${source.channel_id} · ${source.sender_id}`;
const reveal = () => setShowIds(true);
const hide = () => setShowIds(false);
return (
<article
className="connector-card rounded-xl2 border border-line bg-panel overflow-hidden"
data-brand={key}
style={styleVars}
>
<header
className="connector-card-head flex items-center gap-2 px-3.5 py-2 border-b border-line outline-none"
tabIndex={0}
onMouseEnter={reveal}
onMouseLeave={hide}
onFocus={reveal}
onBlur={hide}
title={ids}
style={{ background: "var(--brand-soft)" }}
>
<ConnectorBadge connector={{ logo: source.connector, brand_color: color }} size={20} title={entry.label} />
{showIds ? (
<span className="font-mono text-meta text-faint">{ids}</span>
) : (
<>
<span className="text-ui font-semibold" style={{ color: "var(--brand)" }}>
{source.channel_name}
</span>
<span className="text-faint">·</span>
<span className="text-ui font-medium">{source.sender_name}</span>
<span className="text-label text-faint ml-0.5">{t("inbox.connector_via", { label: entry.label })}</span>
</>
)}
<time className="ml-auto text-label text-faint whitespace-nowrap" title={clockTime(source.ts)}>
{relativeTime(source.ts, t)}
</time>
</header>
<div className="px-3.5 py-2.5 text-body leading-relaxed whitespace-pre-wrap">{source.text}</div>
</article>
);
}