@braintwopoint0/playback-commons 0.1.21 → 0.2.1

package/dist/email/index.d.ts

@@ -0,0 +1,44 @@
+import { Resend } from 'resend';
+
+interface SendEmailResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Returns a memoized Resend client for the given API key. Callers should hold the
+ * returned client at module scope so one instance is reused across requests within
+ * a Next.js runtime.
+ */
+declare function createResendClient(apiKey: string | undefined): Resend | null;
+type AudienceSyncOptions = {
+    role?: string | null;
+    source?: string | null;
+    firstName?: string | null;
+    lastName?: string | null;
+};
+/**
+ * Adds a subscriber to a Resend audience. Returns the Resend contact id on success,
+ * null on any failure (misconfigured / API error / network). Callers should persist
+ * success/failure and rely on a reconciliation job to retry nulls.
+ *
+ * Intentionally does NOT throw — failures are operational, not business logic, and
+ * the caller's primary persistence (Supabase row) is already successful by the time
+ * this is invoked.
+ */
+declare function syncToResendAudience(params: {
+    client: Resend | null;
+    audienceId: string | undefined;
+    email: string;
+    options?: AudienceSyncOptions;
+}): Promise<string | null>;
+/**
+ * Remove a contact from a Resend audience (e.g. on unsubscribe). Returns true on
+ * success; false if not configured or the call fails. Safe to retry.
+ */
+declare function removeFromResendAudience(params: {
+    client: Resend | null;
+    audienceId: string | undefined;
+    contactId: string;
+}): Promise<boolean>;
+
+export { type AudienceSyncOptions, type SendEmailResult, createResendClient, removeFromResendAudience, syncToResendAudience };

package/dist/email/index.js

@@ -0,0 +1,46 @@
+// src/email/index.ts
+import { Resend } from "resend";
+var clientCache = /* @__PURE__ */ new Map();
+function createResendClient(apiKey) {
+  if (!apiKey) return null;
+  const cached = clientCache.get(apiKey);
+  if (cached) return cached;
+  const client = new Resend(apiKey);
+  clientCache.set(apiKey, client);
+  return client;
+}
+async function syncToResendAudience(params) {
+  const { client, audienceId, email, options } = params;
+  if (!client || !audienceId) return null;
+  try {
+    const res = await client.contacts.create({
+      audienceId,
+      email,
+      unsubscribed: false,
+      ...options?.firstName ? { firstName: options.firstName } : {},
+      ...options?.lastName ? { lastName: options.lastName } : {}
+    });
+    const id = res.data?.id ?? res.id ?? null;
+    return id;
+  } catch (err) {
+    console.error("[commons/email] audience sync failed", err);
+    return null;
+  }
+}
+async function removeFromResendAudience(params) {
+  const { client, audienceId, contactId } = params;
+  if (!client || !audienceId) return false;
+  try {
+    await client.contacts.remove({ audienceId, id: contactId });
+    return true;
+  } catch (err) {
+    console.error("[commons/email] audience remove failed", err);
+    return false;
+  }
+}
+export {
+  createResendClient,
+  removeFromResendAudience,
+  syncToResendAudience
+};
+//# sourceMappingURL=index.js.map

package/dist/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/email/index.ts"],"sourcesContent":["// Shared email primitives for PLAYBACK and PLAYHUB.\n//\n// Transactional templates (welcome, invoice, admin invite, etc.) stay in each app's\n// `src/lib/email/` — they're brand/context specific. What lives here are the pieces\n// that both apps need identically:\n//\n// - Resend client factory (memoized per API key)\n// - Marketing-list audience sync (for footer signups, campaign lists)\n// - Shared result type\n//\n// `escapeHtml` for safe interpolation already lives in `@braintwopoint0/playback-commons/security`.\n\nimport { Resend } from 'resend'\n\nexport interface SendEmailResult {\n  success: boolean\n  error?: string\n}\n\nconst clientCache = new Map<string, Resend>()\n\n/**\n * Returns a memoized Resend client for the given API key. Callers should hold the\n * returned client at module scope so one instance is reused across requests within\n * a Next.js runtime.\n */\nexport function createResendClient(apiKey: string | undefined): Resend | null {\n  if (!apiKey) return null\n  const cached = clientCache.get(apiKey)\n  if (cached) return cached\n  const client = new Resend(apiKey)\n  clientCache.set(apiKey, client)\n  return client\n}\n\nexport type AudienceSyncOptions = {\n  role?: string | null\n  source?: string | null\n  firstName?: string | null\n  lastName?: string | null\n}\n\n/**\n * Adds a subscriber to a Resend audience. Returns the Resend contact id on success,\n * null on any failure (misconfigured / API error / network). Callers should persist\n * success/failure and rely on a reconciliation job to retry nulls.\n *\n * Intentionally does NOT throw — failures are operational, not business logic, and\n * the caller's primary persistence (Supabase row) is already successful by the time\n * this is invoked.\n */\nexport async function syncToResendAudience(params: {\n  client: Resend | null\n  audienceId: string | undefined\n  email: string\n  options?: AudienceSyncOptions\n}): Promise<string | null> {\n  const { client, audienceId, email, options } = params\n  if (!client || !audienceId) return null\n\n  try {\n    const res = await client.contacts.create({\n      audienceId,\n      email,\n      unsubscribed: false,\n      ...(options?.firstName ? { firstName: options.firstName } : {}),\n      ...(options?.lastName ? { lastName: options.lastName } : {}),\n    })\n    // Resend's typing varies across versions — defensively read the id.\n    const id =\n      (res as { data?: { id?: string } }).data?.id ??\n      (res as { id?: string }).id ??\n      null\n    return id\n  } catch (err) {\n    console.error('[commons/email] audience sync failed', err)\n    return null\n  }\n}\n\n/**\n * Remove a contact from a Resend audience (e.g. on unsubscribe). Returns true on\n * success; false if not configured or the call fails. Safe to retry.\n */\nexport async function removeFromResendAudience(params: {\n  client: Resend | null\n  audienceId: string | undefined\n  contactId: string\n}): Promise<boolean> {\n  const { client, audienceId, contactId } = params\n  if (!client || !audienceId) return false\n  try {\n    await client.contacts.remove({ audienceId, id: contactId })\n    return true\n  } catch (err) {\n    console.error('[commons/email] audience remove failed', err)\n    return false\n  }\n}\n"],"mappings":";AAYA,SAAS,cAAc;AAOvB,IAAM,cAAc,oBAAI,IAAoB;AAOrC,SAAS,mBAAmB,QAA2C;AAC5E,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,SAAS,YAAY,IAAI,MAAM;AACrC,MAAI,OAAQ,QAAO;AACnB,QAAM,SAAS,IAAI,OAAO,MAAM;AAChC,cAAY,IAAI,QAAQ,MAAM;AAC9B,SAAO;AACT;AAkBA,eAAsB,qBAAqB,QAKhB;AACzB,QAAM,EAAE,QAAQ,YAAY,OAAO,QAAQ,IAAI;AAC/C,MAAI,CAAC,UAAU,CAAC,WAAY,QAAO;AAEnC,MAAI;AACF,UAAM,MAAM,MAAM,OAAO,SAAS,OAAO;AAAA,MACvC;AAAA,MACA;AAAA,MACA,cAAc;AAAA,MACd,GAAI,SAAS,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;AAAA,MAC7D,GAAI,SAAS,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,IAC5D,CAAC;AAED,UAAM,KACH,IAAmC,MAAM,MACzC,IAAwB,MACzB;AACF,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,YAAQ,MAAM,wCAAwC,GAAG;AACzD,WAAO;AAAA,EACT;AACF;AAMA,eAAsB,yBAAyB,QAI1B;AACnB,QAAM,EAAE,QAAQ,YAAY,UAAU,IAAI;AAC1C,MAAI,CAAC,UAAU,CAAC,WAAY,QAAO;AACnC,MAAI;AACF,UAAM,OAAO,SAAS,OAAO,EAAE,YAAY,IAAI,UAAU,CAAC;AAC1D,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,YAAQ,MAAM,0CAA0C,GAAG;AAC3D,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/ui/index.d.ts

@@ -404,6 +404,116 @@ declare function FadeIn({ children, className, delay, direction, ...props }: Fad
 
 declare function LumaSpin(): react_jsx_runtime.JSX.Element;
 
-declare function Footer(): react_jsx_runtime.JSX.Element;
+type FooterLinkDef = {
+    label: string;
+    href: string;
+    external?: boolean;
+};
+type FooterColumnDef = {
+    title: string;
+    links: FooterLinkDef[];
+};
+type FooterSocialDef = {
+    label: string;
+    href: string;
+    src: string;
+};
+type FooterProps = {
+    columns?: FooterColumnDef[];
+    socials?: FooterSocialDef[];
+    newsletter?: boolean;
+    tagline?: string;
+    showTagline?: boolean;
+    logoSrc?: string;
+    logoAlt?: string;
+    siteName?: string;
+    creditHref?: string;
+    creditLabel?: string;
+    newsletterAction?: (email: string) => void | Promise<void>;
+    className?: string;
+};
+declare function Footer({ columns, socials, newsletter, tagline, showTagline, logoSrc, logoAlt, siteName, creditHref, creditLabel, newsletterAction, className, }?: FooterProps): react_jsx_runtime.JSX.Element;
+
+type FooterSocialLink = {
+    label: string;
+    href: string;
+    src: string;
+};
+type FooterCreditsBarProps = {
+    /**
+     * Social links to render on the left. Defaults to the PLAYBACK brand socials.
+     * Note: `src` paths are resolved by the consuming app's Next.js static file
+     * server, so the assets must exist in the app's /public directory.
+     */
+    socials?: FooterSocialLink[];
+    /**
+     * Company name used in the copyright line. Defaults to "PLAYBACK".
+     */
+    companyName?: string;
+    /**
+     * Credit link href. Defaults to BRAIN2.0's homepage.
+     */
+    creditHref?: string;
+    /**
+     * Show the "Built by BRAIN2.0" credit next to the socials. Defaults to true.
+     * The credit uses the Averta Semibold + Thin split-weight wordmark for
+     * "BRAIN2.0". Those @font-face declarations must be loaded by the consuming
+     * app's globals.css (AvertaStd-Semibold.ttf + AvertaStd-Thin.ttf).
+     */
+    showCredit?: boolean;
+    /**
+     * Starting year for the copyright range. Defaults to current year.
+     */
+    copyrightYear?: number;
+    /**
+     * Additional classes on the outer container.
+     */
+    className?: string;
+};
+/**
+ * Shared footer bottom-bar: social icons + BRAIN2.0 credit on the left,
+ * copyright right-aligned on desktop and centered on mobile.
+ *
+ * Use inside an existing footer container. Provides its own top hairline.
+ */
+declare function FooterCreditsBar({ socials, companyName, creditHref, showCredit, copyrightYear, className, }?: FooterCreditsBarProps): react_jsx_runtime.JSX.Element;
+
+type NewsletterFormProps = {
+    /**
+     * Endpoint the form POSTs to. Default: /api/newsletter/subscribe.
+     * Must accept `{ email, source, website }` and return 200/400/429/500.
+     */
+    endpoint?: string;
+    /**
+     * Identifier for which surface the signup came from. Server uses this to route
+     * into segmentation (e.g. 'footer', 'hero', 'clubs-form').
+     */
+    source?: string;
+    /**
+     * Optional role hint (parent / player / club / coach / press). Server must allowlist.
+     */
+    role?: string;
+    /**
+     * Placeholder for the email input.
+     */
+    placeholder?: string;
+    /**
+     * Accessible label for the form.
+     */
+    ariaLabel?: string;
+    /**
+     * Submit button label.
+     */
+    submitLabel?: string;
+    /**
+     * Copy shown while the request is in flight.
+     */
+    sendingLabel?: string;
+    /**
+     * Optional className on the outer <form>.
+     */
+    className?: string;
+};
+declare function NewsletterForm({ endpoint, source, role, placeholder, ariaLabel, submitLabel, sendingLabel, className, }: NewsletterFormProps): react_jsx_runtime.JSX.Element;
 
-export { AnimatedTooltip, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, Calendar, CalendarDayButton, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, DataRow, type DataRowProps, DatePicker, DateTimePicker, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, EmptyState, type EmptyStateProps, FadeIn, type FadeInProps, FlipWords, Footer, HeroHighlight, Highlight, HoverCard, HoverCardDescription, HoverCardTitle, HoverEffect, Input, type InputProps, Label, LumaSpin, PageShell, type PageShellProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, SearchBar, type SearchBarProps, SectionCard, type SectionCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type StatItem, StatsGrid, type StatsGridProps, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, TimePicker, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, easeSmooth, fadeInDown, fadeInUp, hoverLift, hoverScale, pageTransition, springBounce, staggerContainer, staggerItem };
+export { AnimatedTooltip, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, Calendar, CalendarDayButton, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, DataRow, type DataRowProps, DatePicker, DateTimePicker, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, EmptyState, type EmptyStateProps, FadeIn, type FadeInProps, FlipWords, Footer, type FooterColumnDef, FooterCreditsBar, type FooterCreditsBarProps, type FooterLinkDef, type FooterProps, type FooterSocialDef, type FooterSocialLink, HeroHighlight, Highlight, HoverCard, HoverCardDescription, HoverCardTitle, HoverEffect, Input, type InputProps, Label, LumaSpin, NewsletterForm, type NewsletterFormProps, PageShell, type PageShellProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, SearchBar, type SearchBarProps, SectionCard, type SectionCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type StatItem, StatsGrid, type StatsGridProps, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, TimePicker, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, easeSmooth, fadeInDown, fadeInUp, hoverLift, hoverScale, pageTransition, springBounce, staggerContainer, staggerItem };