npm - @tracked/emails - Versions diffs - 0.1.0 - Mend

@tracked/emails 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

package/LICENSE +21 -0
package/README.md +211 -0
package/dist/emails/bodyweight-goal-reached.d.ts +14 -0
package/dist/emails/bodyweight-goal-reached.d.ts.map +1 -0
package/dist/emails/bodyweight-goal-reached.js +177 -0
package/dist/emails/bodyweight-goal-reached.js.map +1 -0
package/dist/emails/client-accepted-invitation.d.ts +10 -0
package/dist/emails/client-accepted-invitation.d.ts.map +1 -0
package/dist/emails/client-accepted-invitation.js +99 -0
package/dist/emails/client-accepted-invitation.js.map +1 -0
package/dist/emails/coach-invite.d.ts +10 -0
package/dist/emails/coach-invite.d.ts.map +1 -0
package/dist/emails/coach-invite.js +126 -0
package/dist/emails/coach-invite.js.map +1 -0
package/dist/emails/coach-removed-client.d.ts +8 -0
package/dist/emails/coach-removed-client.d.ts.map +1 -0
package/dist/emails/coach-removed-client.js +80 -0
package/dist/emails/coach-removed-client.js.map +1 -0
package/dist/emails/direct-message.d.ts +11 -0
package/dist/emails/direct-message.d.ts.map +1 -0
package/dist/emails/direct-message.js +103 -0
package/dist/emails/direct-message.js.map +1 -0
package/dist/emails/feature-discovery.d.ts +11 -0
package/dist/emails/feature-discovery.d.ts.map +1 -0
package/dist/emails/feature-discovery.js +121 -0
package/dist/emails/feature-discovery.js.map +1 -0
package/dist/emails/first-workout-assigned.d.ts +10 -0
package/dist/emails/first-workout-assigned.d.ts.map +1 -0
package/dist/emails/first-workout-assigned.js +98 -0
package/dist/emails/first-workout-assigned.js.map +1 -0
package/dist/emails/first-workout-completed.d.ts +11 -0
package/dist/emails/first-workout-completed.d.ts.map +1 -0
package/dist/emails/first-workout-completed.js +129 -0
package/dist/emails/first-workout-completed.js.map +1 -0
package/dist/emails/index.d.ts +7 -0
package/dist/emails/index.d.ts.map +1 -0
package/dist/emails/index.js +7 -0
package/dist/emails/index.js.map +1 -0
package/dist/emails/new-follower.d.ts +11 -0
package/dist/emails/new-follower.d.ts.map +1 -0
package/dist/emails/new-follower.js +98 -0
package/dist/emails/new-follower.js.map +1 -0
package/dist/emails/subscription-canceled.d.ts +10 -0
package/dist/emails/subscription-canceled.d.ts.map +1 -0
package/dist/emails/subscription-canceled.js +131 -0
package/dist/emails/subscription-canceled.js.map +1 -0
package/dist/emails/support-email.d.ts +8 -0
package/dist/emails/support-email.d.ts.map +1 -0
package/dist/emails/support-email.js +40 -0
package/dist/emails/support-email.js.map +1 -0
package/dist/emails/team-invite.d.ts +11 -0
package/dist/emails/team-invite.d.ts.map +1 -0
package/dist/emails/team-invite.js +100 -0
package/dist/emails/team-invite.js.map +1 -0
package/dist/emails/team-member-removed-email.d.ts +8 -0
package/dist/emails/team-member-removed-email.d.ts.map +1 -0
package/dist/emails/team-member-removed-email.js +97 -0
package/dist/emails/team-member-removed-email.js.map +1 -0
package/dist/emails/tracked-magic-link-activate.d.ts +7 -0
package/dist/emails/tracked-magic-link-activate.d.ts.map +1 -0
package/dist/emails/tracked-magic-link-activate.js +93 -0
package/dist/emails/tracked-magic-link-activate.js.map +1 -0
package/dist/emails/tracked-magic-link.d.ts +7 -0
package/dist/emails/tracked-magic-link.d.ts.map +1 -0
package/dist/emails/tracked-magic-link.js +101 -0
package/dist/emails/tracked-magic-link.js.map +1 -0
package/dist/emails/week-one-checkin.d.ts +10 -0
package/dist/emails/week-one-checkin.d.ts.map +1 -0
package/dist/emails/week-one-checkin.js +141 -0
package/dist/emails/week-one-checkin.js.map +1 -0
package/dist/emails/welcome.d.ts +8 -0
package/dist/emails/welcome.d.ts.map +1 -0
package/dist/emails/welcome.js +146 -0
package/dist/emails/welcome.js.map +1 -0
package/dist/index.d.ts +22 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +24 -0
package/dist/index.js.map +1 -0
package/dist/utils/email-validation.d.ts +48 -0
package/dist/utils/email-validation.d.ts.map +1 -0
package/dist/utils/email-validation.js +72 -0
package/dist/utils/email-validation.js.map +1 -0
package/dist/utils/index.d.ts +8 -0
package/dist/utils/index.d.ts.map +1 -0
package/dist/utils/index.js +8 -0
package/dist/utils/index.js.map +1 -0
package/dist/utils/username-validation.d.ts +54 -0
package/dist/utils/username-validation.d.ts.map +1 -0
package/dist/utils/username-validation.js +76 -0
package/dist/utils/username-validation.js.map +1 -0
package/package.json +78 -0
package/src/emails/bodyweight-goal-reached.tsx +396 -0
package/src/emails/client-accepted-invitation.tsx +258 -0
package/src/emails/coach-invite.tsx +270 -0
package/src/emails/coach-removed-client.tsx +212 -0
package/src/emails/direct-message.tsx +249 -0
package/src/emails/feature-discovery.tsx +289 -0
package/src/emails/first-workout-assigned.tsx +255 -0
package/src/emails/first-workout-completed.tsx +312 -0
package/src/emails/index.tsx +6 -0
package/src/emails/new-follower.tsx +260 -0
package/src/emails/subscription-canceled.tsx +311 -0
package/src/emails/support-email.tsx +80 -0
package/src/emails/team-invite.tsx +262 -0
package/src/emails/team-member-removed-email.tsx +240 -0
package/src/emails/tracked-magic-link-activate.tsx +252 -0
package/src/emails/tracked-magic-link.tsx +264 -0
package/src/emails/week-one-checkin.tsx +353 -0
package/src/emails/welcome.tsx +341 -0
package/src/index.ts +57 -0
package/src/utils/email-validation.test.ts +78 -0
package/src/utils/email-validation.ts +80 -0
package/src/utils/index.ts +13 -0
package/src/utils/username-validation.test.ts +118 -0
package/src/utils/username-validation.ts +89 -0
package/static/tracked-logo.png +0 -0

package/src/emails/welcome.tsx ADDED Viewed

@@ -0,0 +1,341 @@
+import React from "react";
+import {
+  Body,
+  Button,
+  Column,
+  Container,
+  Head,
+  Hr,
+  Html,
+  Img,
+  Link,
+  Preview,
+  Row,
+  Section,
+  Text,
+} from "@react-email/components";
+interface WelcomeEmailProps {
+  userName: string;
+  appUrl: string;
+  websiteUrl: string;
+}
+const baseUrl = "https://tracked.gg/android-chrome-192x192.png";
+export const WelcomeEmail = ({
+  userName,
+  appUrl,
+  websiteUrl = "https://tracked.gg",
+}: WelcomeEmailProps) => {
+  return (
+    <Html>
+      <Head>
+        <meta name="color-scheme" content="light only" />
+        <meta name="supported-color-schemes" content="light only" />
+      </Head>
+      <Preview>Welcome to Tracked - Let's start your fitness journey!</Preview>
+      <Body style={main}>
+        <Container style={container}>
+          <Section style={box}>
+            <Row style={{ marginBottom: "8px" }}>
+              <Column style={{ width: "auto", verticalAlign: "middle" }}>
+                <Img src={`${baseUrl}`} width="28" height="28" alt="Tracked" />
+              </Column>
+              <Column
+                style={{
+                  width: "auto",
+                  verticalAlign: "middle",
+                  paddingLeft: "4px",
+                }}
+              >
+                <Text
+                  style={{
+                    fontSize: "28px",
+                    fontWeight: "900",
+                    fontFamily:
+                      "Raleway, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+                    color: "#020617",
+                    margin: "0",
+                    lineHeight: "32px",
+                    letterSpacing: "0.5px",
+                  }}
+                >
+                  TRACKED
+                </Text>
+              </Column>
+            </Row>
+            <Hr style={hr} />
+            <Text style={heading}>Welcome to Tracked!</Text>
+            <Text style={paragraph}>
+              Hi {userName}, we're excited to have you join our community.
+              Tracked is here to help you achieve your training goals with
+              powerful tracking tools.
+            </Text>
+            <Section style={featureBox}>
+              <Text style={featureHeading}>What you can do with Tracked:</Text>
+              <ul style={featureList}>
+                <li style={featureItem}>
+                  <strong>Track Workouts:</strong> Log your exercises, sets, and
+                  reps with the best tracking tools on the market.
+                </li>
+                <li style={featureItem}>
+                  <strong>Monitor Progress:</strong> Visualize your strength
+                  gains and workout history
+                </li>
+                <li style={featureItem}>
+                  <strong>Stay Accountable:</strong> Share your journey with the
+                  community
+                </li>
+              </ul>
+            </Section>
+            <div
+              style={{
+                marginTop: "24px",
+                marginBottom: "24px",
+                textAlign: "left" as const,
+              }}
+            >
+              <a
+                href={appUrl}
+                style={{
+                  backgroundColor: "#0f172a",
+                  borderRadius: "8px",
+                  fontSize: "16px",
+                  fontWeight: "bold",
+                  textDecoration: "none",
+                  padding: "12px 32px",
+                  display: "inline-block",
+                }}
+              >
+                <span style={{ color: "#ffffff", textDecoration: "none" }}>
+                  Open the App
+                </span>
+              </a>
+            </div>
+            <Section style={tipBox}>
+              <Text style={tipHeading}>Tip:</Text>
+              <Text style={tipText}>
+                Consistency is key to seeing results, and we make it easy to
+                track your progress every step of the way. Try your best to STAY
+                IN THE GREEN!
+              </Text>
+            </Section>
+            <Row style={row}>
+              <Column style={column}>
+                <Button
+                  style={appButton}
+                  href="https://apps.apple.com/app/tracked-training/id6450913418"
+                >
+                  <Img
+                    src="https://cdn.trckd.ca/assets/app-store-black.png"
+                    alt="Download on the App Store"
+                    style={img}
+                  />
+                </Button>
+              </Column>
+              <Column style={column}>
+                <Button
+                  style={appButton}
+                  href="https://play.google.com/store/apps/details?id=com.tracked.mobile"
+                >
+                  <Img
+                    src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png"
+                    alt="Google Play"
+                    style={img}
+                  />
+                </Button>
+              </Column>
+            </Row>
+            <div
+              style={{
+                textAlign: "left" as const,
+                margin: "24px 0",
+              }}
+            >
+              <a
+                href="https://www.discord.gg/trackedgg"
+                style={{
+                  backgroundColor: "#5865F2",
+                  borderRadius: "8px",
+                  fontSize: "16px",
+                  fontWeight: "bold",
+                  textDecoration: "none",
+                  padding: "12px 32px",
+                  display: "inline-block",
+                }}
+              >
+                <span style={{ color: "#ffffff", textDecoration: "none" }}>
+                  Join our Discord Community
+                </span>
+              </a>
+            </div>
+            <Hr style={hr} />
+            <Text style={footer}>
+              Copyright © Tracked Training Platform Inc. <br /> 9101 Horne
+              Street, Vancouver, BC
+            </Text>
+            <Container>
+              <Link
+                href={`${websiteUrl}/terms`}
+                style={{ ...footer, paddingRight: 10 }}
+              >
+                Terms
+              </Link>
+              <Link style={{ ...footer, paddingRight: 10 }}> | </Link>
+              <Link
+                href={`${websiteUrl}/privacy`}
+                style={{ ...footer, paddingRight: 10 }}
+              >
+                Privacy
+              </Link>
+              <Link style={{ ...footer, paddingRight: 10 }}> | </Link>
+              <Link
+                href={`${websiteUrl}/support`}
+                style={{ ...footer, paddingRight: 10 }}
+              >
+                Support
+              </Link>
+            </Container>
+            <Text style={footer}>
+              This is a service notification by the Tracked Training Platform.
+            </Text>
+          </Section>
+        </Container>
+      </Body>
+    </Html>
+  );
+};
+const main = {
+  backgroundColor: "#020617", // slate-950
+  fontFamily:
+    '-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Ubuntu,sans-serif',
+};
+const container = {
+  backgroundColor: "#020617", // slate-950
+  margin: "0 auto",
+  padding: "20px 0 48px",
+  marginBottom: "64px",
+  borderRadius: "8px",
+};
+const box = {
+  padding: "0 24px",
+};
+const hr = {
+  borderColor: "#4ade80", // green-400
+  margin: "24px 0",
+  borderWidth: "1px",
+};
+const paragraph = {
+  color: "#ffffff", // white
+  fontSize: "16px",
+  lineHeight: "24px",
+  textAlign: "left" as const,
+};
+const heading = {
+  color: "#ffffff", // white
+  fontSize: "24px",
+  lineHeight: "32px",
+  fontWeight: "bold",
+  marginBottom: "16px",
+};
+const featureBox = {
+  backgroundColor: "#1e293b",
+  padding: "16px 24px",
+  borderRadius: "8px",
+  margin: "24px 0",
+};
+const featureHeading = {
+  color: "#ffffff",
+  fontSize: "16px",
+  fontWeight: "bold",
+  marginBottom: "12px",
+};
+const featureList = {
+  margin: "0",
+  paddingLeft: "20px",
+};
+const featureItem = {
+  color: "#e2e8f0",
+  fontSize: "14px",
+  lineHeight: "24px",
+  marginBottom: "8px",
+};
+const tipBox = {
+  backgroundColor: "#1e293b",
+  padding: "16px 24px",
+  borderRadius: "8px",
+  margin: "24px 0",
+  borderLeft: "4px solid #4ade80",
+};
+const tipHeading = {
+  color: "#4ade80",
+  fontSize: "14px",
+  fontWeight: "bold",
+};
+const tipText = {
+  color: "#e2e8f0",
+  fontSize: "14px",
+  lineHeight: "20px",
+};
+const row = {
+  display: "flex",
+  flexDirection: "row" as const,
+};
+const column = {
+  flex: "0 0 48%",
+  "@media (maxWidth: 600px)": {
+    flex: "0 0 100%",
+    marginBottom: "10px",
+  },
+};
+const img = {
+  maxWidth: "100%",
+  height: "auto",
+};
+const appButton = {
+  backgroundColor: "transparent",
+  borderRadius: "8px",
+  color: "#ffffff", // white
+  fontSize: "16px",
+  fontWeight: "bold",
+  textDecoration: "none",
+  textAlign: "center" as const,
+  display: "block",
+  width: "100%",
+  maxWidth: "150px",
+};
+const footer = {
+  color: "#94a3b8", // slate-400 for subtle footer text
+  fontSize: "12px",
+  lineHeight: "16px",
+};
+export default WelcomeEmail;

package/src/index.ts ADDED Viewed

@@ -0,0 +1,57 @@
+import { BodyweightGoalReachedEmail } from "./emails/bodyweight-goal-reached.js";
+import { ClientAcceptedInvitationEmail } from "./emails/client-accepted-invitation.js";
+import { CoachInviteEmail } from "./emails/coach-invite.js";
+import { CoachRemovedClientEmail } from "./emails/coach-removed-client.js";
+import { DirectMessageEmail } from "./emails/direct-message.js";
+import { FeatureDiscoveryEmail } from "./emails/feature-discovery.js";
+import { FirstWorkoutAssignedEmail } from "./emails/first-workout-assigned.js";
+import { FirstWorkoutCompletedEmail } from "./emails/first-workout-completed.js";
+import { NewFollowerEmail } from "./emails/new-follower.js";
+import { SubscriptionCanceledEmail } from "./emails/subscription-canceled.js";
+import { SupportEmail } from "./emails/support-email.js";
+import { TeamInviteEmail } from "./emails/team-invite.js";
+import { TeamMemberRemovedEmail } from "./emails/team-member-removed-email.js";
+import { TrackedMagicLink } from "./emails/tracked-magic-link.js";
+import { TrackedMagicLinkActivate } from "./emails/tracked-magic-link-activate.js";
+import { WeekOneCheckinEmail } from "./emails/week-one-checkin.js";
+import { WelcomeEmail } from "./emails/welcome.js";
+// Import validation utilities
+import {
+  isPrivateRelayEmail,
+  isValidEmailFormat,
+  shouldSendEmailTo,
+} from "./utils/email-validation.js";
+import {
+  isAnonymousUsername,
+  getSafeDisplayName,
+} from "./utils/username-validation.js";
+export {
+  BodyweightGoalReachedEmail,
+  ClientAcceptedInvitationEmail,
+  CoachInviteEmail,
+  CoachRemovedClientEmail,
+  DirectMessageEmail,
+  FeatureDiscoveryEmail,
+  FirstWorkoutAssignedEmail,
+  FirstWorkoutCompletedEmail,
+  NewFollowerEmail,
+  SubscriptionCanceledEmail,
+  SupportEmail,
+  TeamInviteEmail,
+  TeamMemberRemovedEmail,
+  TrackedMagicLink,
+  TrackedMagicLinkActivate,
+  WeekOneCheckinEmail,
+  WelcomeEmail,
+};
+// Export validation utilities
+export {
+  isPrivateRelayEmail,
+  isValidEmailFormat,
+  shouldSendEmailTo,
+  isAnonymousUsername,
+  getSafeDisplayName,
+};

package/src/utils/email-validation.test.ts ADDED Viewed

@@ -0,0 +1,78 @@
+import { describe, it, expect } from 'vitest';
+import {
+  isPrivateRelayEmail,
+  isValidEmailFormat,
+  shouldSendEmailTo,
+} from './email-validation';
+describe('email-validation', () => {
+  describe('isPrivateRelayEmail', () => {
+    it('should detect Apple private relay emails', () => {
+      expect(isPrivateRelayEmail('6g65mj8rd5@privaterelay.appleid.com')).toBe(
+        true
+      );
+      expect(
+        isPrivateRelayEmail('randomstring@privaterelay.appleid.com')
+      ).toBe(true);
+    });
+    it('should allow normal emails', () => {
+      expect(isPrivateRelayEmail('user@gmail.com')).toBe(false);
+      expect(isPrivateRelayEmail('john@example.com')).toBe(false);
+      expect(isPrivateRelayEmail('test@company.co.uk')).toBe(false);
+    });
+    it('should be case insensitive', () => {
+      expect(isPrivateRelayEmail('TEST@PRIVATERELAY.APPLEID.COM')).toBe(true);
+      expect(isPrivateRelayEmail('Test@PrivateRelay.AppleID.com')).toBe(true);
+    });
+  });
+  describe('isValidEmailFormat', () => {
+    it('should validate correct email formats', () => {
+      expect(isValidEmailFormat('user@example.com')).toBe(true);
+      expect(isValidEmailFormat('test.user@company.co.uk')).toBe(true);
+      expect(isValidEmailFormat('name+tag@domain.com')).toBe(true);
+      expect(isValidEmailFormat('123@numbers.net')).toBe(true);
+    });
+    it('should reject invalid email formats', () => {
+      expect(isValidEmailFormat('notanemail')).toBe(false);
+      expect(isValidEmailFormat('missing@domain')).toBe(false);
+      expect(isValidEmailFormat('@nodomain.com')).toBe(false);
+      expect(isValidEmailFormat('noat.com')).toBe(false);
+      expect(isValidEmailFormat('spaces in@email.com')).toBe(false);
+      expect(isValidEmailFormat('')).toBe(false);
+    });
+  });
+  describe('shouldSendEmailTo', () => {
+    it('should allow valid emails', () => {
+      expect(shouldSendEmailTo('user@example.com')).toBe(true);
+      expect(shouldSendEmailTo('valid.email@company.co.uk')).toBe(true);
+    });
+    it('should reject null/undefined emails', () => {
+      expect(shouldSendEmailTo(null)).toBe(false);
+      expect(shouldSendEmailTo(undefined)).toBe(false);
+    });
+    it('should reject private relay emails', () => {
+      expect(
+        shouldSendEmailTo('randomstring@privaterelay.appleid.com')
+      ).toBe(false);
+    });
+    it('should reject invalid email formats', () => {
+      expect(shouldSendEmailTo('notanemail')).toBe(false);
+      expect(shouldSendEmailTo('missing@domain')).toBe(false);
+      expect(shouldSendEmailTo('')).toBe(false);
+    });
+    it('should handle edge cases', () => {
+      expect(shouldSendEmailTo('   ')).toBe(false);
+      expect(shouldSendEmailTo('valid@email.com ')).toBe(false); // trailing space fails regex
+      expect(shouldSendEmailTo('valid@email.com')).toBe(true); // properly formatted email works
+    });
+  });
+});

package/src/utils/email-validation.ts ADDED Viewed

@@ -0,0 +1,80 @@
+/**
+ * Email Validation Utilities
+ *
+ * Handles validation for email addresses to determine if we should send emails.
+ * This includes filtering out private relay emails and validating email formats.
+ */
+/**
+ * Check if email is from a private relay service
+ *
+ * Apple's "Hide My Email" feature creates forwarding addresses like:
+ * - 6g65mj8rd5@privaterelay.appleid.com
+ * - user@icloud.com (when using Hide My Email)
+ *
+ * Note: These emails ARE technically deliverable (Apple forwards them),
+ * but we may want to skip them for privacy/marketing reasons.
+ *
+ * @param email - The email address to check
+ * @returns true if the email is from a private relay service
+ */
+export function isPrivateRelayEmail(email: string): boolean {
+  const privateRelayPatterns = [
+    "@privaterelay.appleid.com",
+    // Note: @icloud.com can be real emails, only filter if it's clearly a relay
+  ];
+  return privateRelayPatterns.some((pattern) =>
+    email.toLowerCase().includes(pattern),
+  );
+}
+/**
+ * Validate basic email format
+ *
+ * @param email - The email address to validate
+ * @returns true if the email has a valid format
+ */
+export function isValidEmailFormat(email: string): boolean {
+  // Basic email regex: something@something.something
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return emailRegex.test(email);
+}
+/**
+ * Determine if we should send emails to this address
+ *
+ * This is the main function to use when deciding whether to send an email.
+ * It checks for:
+ * - Null/undefined emails
+ * - Private relay emails (Apple Hide My Email)
+ * - Invalid email formats
+ *
+ * @param email - The email address to check
+ * @returns true if we should send emails to this address
+ *
+ * @example
+ * ```typescript
+ * if (shouldSendEmailTo(user.email)) {
+ *   await sendWelcomeEmail(user.email);
+ * }
+ * ```
+ */
+export function shouldSendEmailTo(email: string | null | undefined): boolean {
+  // No email provided
+  if (!email) {
+    return false;
+  }
+  // Skip private relay emails
+  if (isPrivateRelayEmail(email)) {
+    return false;
+  }
+  // Validate email format
+  if (!isValidEmailFormat(email)) {
+    return false;
+  }
+  return true;
+}

package/src/utils/index.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * Email and Username Validation Utilities
+ *
+ * Export all validation utilities for use across the application.
+ */
+export {
+  isPrivateRelayEmail,
+  isValidEmailFormat,
+  shouldSendEmailTo,
+} from "./email-validation";
+export { isAnonymousUsername, getSafeDisplayName } from "./username-validation";

package/src/utils/username-validation.test.ts ADDED Viewed

@@ -0,0 +1,118 @@
+import { describe, it, expect } from 'vitest';
+import { isAnonymousUsername, getSafeDisplayName } from './username-validation';
+describe('username-validation', () => {
+  describe('isAnonymousUsername', () => {
+    it('should detect UUIDs as anonymous', () => {
+      expect(isAnonymousUsername('01944f9e-8e64-7a78-9e1e-3daba7b13e9f')).toBe(
+        true
+      );
+      expect(isAnonymousUsername('550e8400-e29b-41d4-a716-446655440000')).toBe(
+        true
+      );
+      expect(isAnonymousUsername('123e4567-e89b-12d3-a456-426614174000')).toBe(
+        true
+      );
+    });
+    it('should allow real usernames', () => {
+      expect(isAnonymousUsername('john_doe')).toBe(false);
+      expect(isAnonymousUsername('user123')).toBe(false);
+      expect(isAnonymousUsername('Jane-Smith')).toBe(false);
+      expect(isAnonymousUsername('athlete2024')).toBe(false);
+    });
+    it('should treat null/undefined as anonymous', () => {
+      expect(isAnonymousUsername(null)).toBe(true);
+      expect(isAnonymousUsername(undefined)).toBe(true);
+    });
+    it('should be case insensitive for UUIDs', () => {
+      expect(isAnonymousUsername('01944F9E-8E64-7A78-9E1E-3DABA7B13E9F')).toBe(
+        true
+      );
+      expect(isAnonymousUsername('01944f9E-8e64-7A78-9E1e-3dAbA7b13E9f')).toBe(
+        true
+      );
+    });
+    it('should handle empty strings', () => {
+      expect(isAnonymousUsername('')).toBe(true);
+    });
+  });
+  describe('getSafeDisplayName', () => {
+    it('should prefer real username over other names', () => {
+      expect(
+        getSafeDisplayName('john_doe', 'John', 'John Doe Smith')
+      ).toBe('john_doe');
+      expect(getSafeDisplayName('athlete123', 'Jane', 'Jane Smith')).toBe(
+        'athlete123'
+      );
+    });
+    it('should fall back to given name when username is UUID', () => {
+      const uuid = '01944f9e-8e64-7a78-9e1e-3daba7b13e9f';
+      expect(getSafeDisplayName(uuid, 'John', 'John Doe Smith')).toBe('John');
+      expect(getSafeDisplayName(uuid, 'Jane', 'Jane Smith')).toBe('Jane');
+    });
+    it('should fall back to full name when no given name', () => {
+      const uuid = '01944f9e-8e64-7a78-9e1e-3daba7b13e9f';
+      expect(getSafeDisplayName(uuid, null, 'John Doe Smith')).toBe(
+        'John Doe Smith'
+      );
+      expect(getSafeDisplayName(uuid, undefined, 'Jane Smith')).toBe(
+        'Jane Smith'
+      );
+    });
+    it('should use default fallback when no names available', () => {
+      const uuid = '01944f9e-8e64-7a78-9e1e-3daba7b13e9f';
+      expect(getSafeDisplayName(uuid, null, null)).toBe('there');
+      expect(getSafeDisplayName(null, null, null)).toBe('there');
+      expect(getSafeDisplayName(undefined, undefined, undefined)).toBe('there');
+    });
+    it('should use custom fallback when provided', () => {
+      const uuid = '01944f9e-8e64-7a78-9e1e-3daba7b13e9f';
+      expect(getSafeDisplayName(uuid, null, null, 'friend')).toBe('friend');
+      expect(getSafeDisplayName(null, null, null, 'athlete')).toBe('athlete');
+    });
+    it('should handle whitespace-only names', () => {
+      const uuid = '01944f9e-8e64-7a78-9e1e-3daba7b13e9f';
+      expect(getSafeDisplayName(uuid, '   ', '  ', 'friend')).toBe('friend');
+      expect(getSafeDisplayName(uuid, '', '', 'athlete')).toBe('athlete');
+    });
+    it('should trim whitespace from valid names', () => {
+      expect(getSafeDisplayName('john_doe', '  John  ', 'John Doe')).toBe(
+        'john_doe'
+      );
+      const uuid = '01944f9e-8e64-7a78-9e1e-3daba7b13e9f';
+      expect(getSafeDisplayName(uuid, '  John  ', 'John Doe')).toBe('  John  '); // Note: function doesn't trim, just checks length
+    });
+    it('should handle complex scenarios', () => {
+      // User with username
+      expect(getSafeDisplayName('athlete_pro', 'Mike', 'Mike Johnson')).toBe(
+        'athlete_pro'
+      );
+      // New user with UUID, given name
+      const uuid = '01944f9e-8e64-7a78-9e1e-3daba7b13e9f';
+      expect(getSafeDisplayName(uuid, 'Sarah', 'Sarah Williams')).toBe(
+        'Sarah'
+      );
+      // User with only full name
+      expect(getSafeDisplayName(uuid, null, 'Robert Brown')).toBe(
+        'Robert Brown'
+      );
+      // Completely anonymous
+      expect(getSafeDisplayName(uuid, null, null, 'coach')).toBe('coach');
+    });
+  });
+});