@tuturuuu/utils 0.0.3 → 0.6.0

package/src/calendar-utils.ts

@@ -0,0 +1,91 @@
+import type { CalendarEvent } from '@tuturuuu/types/primitives/calendar-event';
+import dayjs from 'dayjs';
+import timezone from 'dayjs/plugin/timezone';
+import utc from 'dayjs/plugin/utc';
+
+dayjs.extend(timezone);
+dayjs.extend(utc);
+
+export function isAllDayEvent(
+  event: Pick<CalendarEvent, 'start_at' | 'end_at'>
+): boolean {
+  const start = dayjs(event.start_at);
+  const end = dayjs(event.end_at);
+
+  const durationMs = end.diff(start, 'millisecond');
+  const isMultipleOf24Hours = durationMs % (24 * 60 * 60 * 1000) === 0;
+
+  return durationMs > 0 && isMultipleOf24Hours;
+}
+
+// Helper function to convert Google Calendar all-day events to proper timezone
+export function convertGoogleAllDayEvent(
+  startDate: string | undefined,
+  endDate: string | undefined,
+  userTimezone?: string
+): { start_at: string; end_at: string } {
+  // Check if this is a date-only format (all-day event from Google)
+  const isDateOnly = (dateStr: string) => /^\d{4}-\d{2}-\d{2}$/.test(dateStr);
+
+  if (!startDate || !endDate) {
+    const now = dayjs();
+    return {
+      start_at: now.toISOString(),
+      end_at: now.add(1, 'hour').toISOString(),
+    };
+  }
+
+  // If both are date-only (Google all-day event), convert to user's timezone midnight
+  if (isDateOnly(startDate) && isDateOnly(endDate)) {
+    const tz =
+      userTimezone === 'auto'
+        ? typeof window !== 'undefined'
+          ? Intl.DateTimeFormat().resolvedOptions().timeZone
+          : undefined
+        : userTimezone;
+
+    const startAtMidnight = tz
+      ? dayjs.tz(`${startDate}T00:00:00`, tz)
+      : dayjs(`${startDate}T00:00:00`);
+
+    const endAtMidnight = tz
+      ? dayjs.tz(`${endDate}T00:00:00`, tz)
+      : dayjs(`${endDate}T00:00:00`);
+
+    return {
+      start_at: startAtMidnight.toISOString(),
+      end_at: endAtMidnight.toISOString(),
+    };
+  }
+
+  // Otherwise, use the dates as-is (they're already dateTime format)
+  return {
+    start_at: startDate,
+    end_at: endDate,
+  };
+}
+
+// Helper to create an all-day event in user's timezone
+export function createAllDayEvent(
+  date: Date,
+  userTimezone?: string,
+  durationDays: number = 1
+): { start_at: string; end_at: string } {
+  const tz =
+    userTimezone === 'auto'
+      ? typeof window !== 'undefined'
+        ? Intl.DateTimeFormat().resolvedOptions().timeZone
+        : undefined
+      : userTimezone;
+
+  const startAtMidnight = tz
+    ? dayjs.tz(date, tz).startOf('day')
+    : dayjs(date).startOf('day');
+
+  const endAtMidnight = startAtMidnight.add(durationDays, 'day');
+
+  return {
+    start_at: startAtMidnight.toISOString(),
+    end_at: endAtMidnight.toISOString(),
+  };
+}

package/src/color-helper.ts

@@ -0,0 +1,110 @@
+export const getEventStyles = (
+  color: string
+): {
+  bg: string;
+  border: string;
+  text: string;
+  dragBg: string;
+  syncingBg: string;
+  successBg: string;
+  errorBg: string;
+} => {
+  const colorStyles = {
+    BLUE: {
+      bg: 'bg-calendar-bg-blue hover:ring-dynamic-light-blue/80',
+      border: 'border-dynamic-light-blue/80',
+      text: 'text-dynamic-light-blue',
+      dragBg: 'bg-calendar-bg-blue',
+      syncingBg: 'bg-calendar-bg-blue',
+      successBg: 'bg-calendar-bg-blue',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    RED: {
+      bg: 'bg-calendar-bg-red hover:ring-dynamic-light-red/80',
+      border: 'border-dynamic-light-red/80',
+      text: 'text-dynamic-light-red',
+      dragBg: 'bg-calendar-bg-red',
+      syncingBg: 'bg-calendar-bg-red',
+      successBg: 'bg-calendar-bg-red',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    GREEN: {
+      bg: 'bg-calendar-bg-green hover:ring-dynamic-light-green/80',
+      border: 'border-dynamic-light-green/80',
+      text: 'text-dynamic-light-green',
+      dragBg: 'bg-calendar-bg-green',
+      syncingBg: 'bg-calendar-bg-green',
+      successBg: 'bg-calendar-bg-green',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    YELLOW: {
+      bg: 'bg-calendar-bg-yellow hover:ring-dynamic-light-yellow/80',
+      border: 'border-dynamic-light-yellow/80',
+      text: 'text-dynamic-light-yellow',
+      dragBg: 'bg-calendar-bg-yellow',
+      syncingBg: 'bg-calendar-bg-yellow',
+      successBg: 'bg-calendar-bg-yellow',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    PURPLE: {
+      bg: 'bg-calendar-bg-purple hover:ring-dynamic-light-purple/80',
+      border: 'border-dynamic-light-purple/80',
+      text: 'text-dynamic-light-purple',
+      dragBg: 'bg-calendar-bg-purple',
+      syncingBg: 'bg-calendar-bg-purple',
+      successBg: 'bg-calendar-bg-purple',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    PINK: {
+      bg: 'bg-calendar-bg-pink hover:ring-dynamic-light-pink/80',
+      border: 'border-dynamic-light-pink/80',
+      text: 'text-dynamic-light-pink',
+      dragBg: 'bg-calendar-bg-pink',
+      syncingBg: 'bg-calendar-bg-pink',
+      successBg: 'bg-calendar-bg-pink',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    ORANGE: {
+      bg: 'bg-calendar-bg-orange hover:ring-dynamic-light-orange/80',
+      border: 'border-dynamic-light-orange/80',
+      text: 'text-dynamic-light-orange',
+      dragBg: 'bg-calendar-bg-orange',
+      syncingBg: 'bg-calendar-bg-orange',
+      successBg: 'bg-calendar-bg-orange',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    INDIGO: {
+      bg: 'bg-calendar-bg-indigo hover:ring-dynamic-light-indigo/80',
+      border: 'border-dynamic-light-indigo/80',
+      text: 'text-dynamic-light-indigo',
+      dragBg: 'bg-calendar-bg-indigo',
+      syncingBg: 'bg-calendar-bg-indigo',
+      successBg: 'bg-calendar-bg-indigo',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    CYAN: {
+      bg: 'bg-calendar-bg-cyan hover:ring-dynamic-light-cyan/80',
+      border: 'border-dynamic-light-cyan/80',
+      text: 'text-dynamic-light-cyan',
+      dragBg: 'bg-calendar-bg-cyan',
+      syncingBg: 'bg-calendar-bg-cyan',
+      successBg: 'bg-calendar-bg-cyan',
+      errorBg: 'bg-calendar-bg-red',
+    },
+    GRAY: {
+      bg: 'bg-calendar-bg-gray hover:ring-dynamic-light-gray/80',
+      border: 'border-dynamic-light-gray/80',
+      text: 'text-dynamic-light-gray',
+      dragBg: 'bg-calendar-bg-gray',
+      syncingBg: 'bg-calendar-bg-gray',
+      successBg: 'bg-calendar-bg-gray',
+      errorBg: 'bg-calendar-bg-red',
+    },
+  } as const;
+
+  const normalizedColor = color?.toUpperCase() ?? 'BLUE';
+  const colorStyle = colorStyles[normalizedColor as keyof typeof colorStyles];
+
+  if (!colorStyle) return colorStyles.BLUE;
+  return colorStyle;
+};

package/src/common/nextjs.tsx

@@ -0,0 +1,99 @@
+import type { Metadata, Viewport } from 'next';
+import { Noto_Sans } from 'next/font/google';
+import { DEV_MODE } from '../constants';
+
+export const font = Noto_Sans({
+  subsets: ['latin', 'vietnamese'],
+  display: 'block',
+});
+
+interface MetadataProps {
+  config: {
+    name: string;
+    url: string;
+    ogImage: string;
+    keywords?: string[];
+    description: {
+      en: string;
+      vi?: string;
+    };
+  };
+  params: Promise<{
+    locale: string;
+  }>;
+}
+
+export async function generateCommonMetadata({
+  config,
+  params,
+}: MetadataProps): Promise<Metadata> {
+  const { locale } = await params;
+  const description =
+    locale === 'vi' ? config.description.vi : config.description.en;
+
+  return {
+    applicationName: config.name,
+    title: {
+      default: config.name,
+      template: `${DEV_MODE ? '[DEV] ' : ''} %s | ${config.name}`,
+    },
+    metadataBase: new URL(config.url),
+    description,
+    keywords: config.keywords ?? [
+      'React.js',
+      'Next.js',
+      'Tailwind CSS',
+      'TypeScript',
+      'Biome',
+    ],
+    appleWebApp: {
+      capable: true,
+      statusBarStyle: 'default',
+      title: config.name,
+    },
+    formatDetection: {
+      telephone: false,
+    },
+    openGraph: {
+      type: 'website',
+      locale,
+      url: config.url,
+      title: config.name,
+      description,
+      siteName: config.name,
+      images: [
+        {
+          url: config.ogImage,
+          width: 1200,
+          height: 630,
+          alt: config.name,
+        },
+      ],
+    },
+    twitter: {
+      card: 'summary_large_image',
+      title: config.name,
+      description,
+      images: [config.ogImage],
+      creator: '@tuturuuu',
+    },
+    icons: {
+      icon: '/favicon.ico',
+      shortcut: '/favicon-16x16.png',
+      apple: '/apple-touch-icon.png',
+    },
+    manifest: '/manifest.webmanifest',
+  };
+}
+
+export const viewport: Viewport = {
+  width: 'device-width',
+  initialScale: 1,
+  maximumScale: 5,
+  viewportFit: 'cover',
+  themeColor: [
+    { media: '(prefers-color-scheme: dark)', color: 'black' },
+    { media: '(prefers-color-scheme: light)', color: 'white' },
+  ],
+  colorScheme: 'dark light',
+};

package/src/common/scan.tsx

@@ -0,0 +1,15 @@
+import { DEV_MODE } from '../constants';
+
+const enabled = false;
+
+export const ReactScan = () => {
+  if (!DEV_MODE || !enabled) return null;
+  return (
+    <head>
+      <script
+        crossOrigin="anonymous"
+        src="//unpkg.com/react-scan/dist/auto.global.js"
+      />
+    </head>
+  );
+};

package/src/configs/reports.ts

@@ -0,0 +1,160 @@
+import type { WorkspaceConfig } from '@tuturuuu/types/primitives/WorkspaceConfig';
+
+// Report template configs
+export const reportConfigs: (WorkspaceConfig & {
+  defaultValue: string;
+})[] = [
+  {
+    id: 'BRAND_LOGO_URL',
+    type: 'URL',
+    defaultValue: '',
+  },
+  {
+    id: 'BRAND_NAME',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'BRAND_LOCATION',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'BRAND_PHONE_NUMBER',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_TITLE_PREFIX',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_TITLE_SUFFIX',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_DEFAULT_TITLE',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_INTRO',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_CONTENT_TEXT',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_SCORE_TEXT',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_FEEDBACK_TEXT',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_CONCLUSION',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'REPORT_CLOSING',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'ENABLE_REPORT_EXPORT_ONLY_APPROVED',
+    type: 'TEXT',
+    defaultValue: 'false',
+  },
+  {
+    id: 'ENABLE_REPORT_PENDING_WATERMARK',
+    type: 'TEXT',
+    defaultValue: 'false',
+  },
+];
+
+// Lead generation email template configs
+export const leadGenerationConfigs: (WorkspaceConfig & {
+  defaultValue: string;
+})[] = [
+  // Shared brand configs (already in report template)
+  {
+    id: 'BRAND_LOGO_URL',
+    type: 'URL',
+    defaultValue: '',
+  },
+  {
+    id: 'BRAND_NAME',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'BRAND_LOCATION',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'BRAND_PHONE_NUMBER',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  // Lead generation specific configs
+  {
+    id: 'LEAD_EMAIL_TITLE',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'LEAD_EMAIL_GREETING',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'LEAD_EMAIL_TABLE_HEADER_COMMENTS',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'LEAD_EMAIL_TABLE_HEADER_SCORE',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'LEAD_EMAIL_TABLE_SCORE_SCALE',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'LEAD_EMAIL_FOOTER',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'LEAD_EMAIL_SIGNATURE_TITLE',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+  {
+    id: 'LEAD_EMAIL_SIGNATURE_NAME',
+    type: 'TEXT',
+    defaultValue: '',
+  },
+];
+
+// Combined list for backward compatibility
+export const availableConfigs: (WorkspaceConfig & {
+  defaultValue: string;
+})[] = [
+  ...reportConfigs,
+  ...leadGenerationConfigs.filter(
+    (config) => !reportConfigs.some((rc) => rc.id === config.id)
+  ),
+];

package/src/constants.ts

@@ -0,0 +1,85 @@
+export const GITHUB_OWNER = 'tutur3u';
+export const GITHUB_REPO = 'platform';
+export const ROOT_WORKSPACE_ID = '00000000-0000-0000-0000-000000000000';
+export const INTERNAL_WORKSPACE_SLUG = 'internal';
+export const PERSONAL_WORKSPACE_SLUG = 'personal';
+
+// Workspace creation limits
+export const MAX_WORKSPACES_FOR_FREE_USERS = 10;
+
+export const resolveWorkspaceId = (identifier: string): string => {
+  if (!identifier) return identifier;
+
+  if (identifier.toLowerCase() === INTERNAL_WORKSPACE_SLUG) {
+    return ROOT_WORKSPACE_ID;
+  }
+
+  return identifier;
+};
+
+export const normalizeWorkspaceContextId = (identifier?: string | null) => {
+  const trimmed = identifier?.trim();
+  if (!trimmed) return PERSONAL_WORKSPACE_SLUG;
+
+  if (trimmed.toLowerCase() === PERSONAL_WORKSPACE_SLUG) {
+    return PERSONAL_WORKSPACE_SLUG;
+  }
+
+  return resolveWorkspaceId(trimmed);
+};
+
+export const toWorkspaceSlug = (
+  workspaceId: string,
+  { personal = false }: { personal?: boolean } = {}
+): string => {
+  if (personal) return PERSONAL_WORKSPACE_SLUG;
+  if (workspaceId === ROOT_WORKSPACE_ID) return INTERNAL_WORKSPACE_SLUG;
+  return workspaceId;
+};
+
+export const isInternalWorkspaceSlug = (
+  identifier?: string | null
+): boolean => {
+  if (!identifier) return false;
+  return identifier.toLowerCase() === INTERNAL_WORKSPACE_SLUG;
+};
+
+export const DEV_MODE = process.env.NODE_ENV === 'development';
+export const PROD_MODE = process.env.NODE_ENV === 'production';
+
+// ── Generic text field length tiers ──────────────────────────────────────────
+// Use these when a domain-specific constant below does not exist.
+export const MAX_CODE_LENGTH = 10; // locale codes, currency codes
+export const MAX_OTP_LENGTH = 20; // OTP / verification codes
+export const MAX_IP_LENGTH = 45; // IPv6 addresses
+export const MAX_COLOR_LENGTH = 50; // CSS color values, hex strings
+export const MAX_DATE_STRING_LENGTH = 50; // ISO date strings
+export const MAX_SHORT_TEXT_LENGTH = 100; // status, type, timezone, provider
+export const MAX_ID_LENGTH = 255; // non-UUID identifiers, slugs
+export const MAX_NAME_LENGTH = 255; // generic names, titles, labels
+export const MAX_SEARCH_LENGTH = 500; // search queries, reasons, subjects
+export const MAX_MEDIUM_TEXT_LENGTH = 1000; // notes, paths, config values
+export const MAX_URL_LENGTH = 2000; // URLs, tokens, long identifiers
+export const MAX_LONG_TEXT_LENGTH = 10000; // descriptions, content, messages
+export const MAX_RICH_TEXT_LENGTH = 50000; // HTML content, rich text
+
+// ── Domain-specific field limits ─────────────────────────────────────────────
+export const MAX_DISPLAY_NAME_LENGTH = 100;
+export const MAX_FULL_NAME_LENGTH = 100;
+export const MAX_BIO_LENGTH = 1000;
+export const MAX_EMAIL_LENGTH = 320; // Based on RFC 5321 (64 for local-part + 1 for @ + 255 for domain)
+
+// Payload limits
+export const MAX_PAYLOAD_SIZE = 512 * 1024; // 512KB
+export const MAX_REQUEST_BODY_BYTES = 512 * 1024; // 512KB — global limit for non-file-upload API routes
+export const MAX_TEXT_FIELD_BYTES = 64000;
+// 40KB — covers 10K emoji chars (4 bytes each)
+export const MAX_WORKSPACE_NAME_LENGTH = 100;
+export const MAX_TASK_NAME_LENGTH = 1024;
+export const MAX_TASK_DESCRIPTION_LENGTH = 100000;
+export const MAX_CHAT_MESSAGE_LENGTH = 10000;
+export const MAX_SUPPORT_INQUIRY_LENGTH = 5000;
+export const MAX_CALENDAR_EVENT_TITLE_LENGTH = 255;
+export const MAX_CALENDAR_EVENT_DESCRIPTION_LENGTH = 10000;
+export const MAX_NOTE_TITLE_LENGTH = 255;
+export const MAX_NOTE_CONTENT_LENGTH = 50000;

package/src/crypto.ts

@@ -0,0 +1,21 @@
+import crypto from 'node:crypto';
+
+export function generateSalt() {
+  return crypto.randomBytes(10).toString('hex');
+}
+
+export async function hashPassword(password: string, salt: string) {
+  // concatenate the password and salt
+  const passwordWithSalt = password + salt;
+
+  // use native crypto to hash the password
+  const hashedPassword = await crypto.subtle.digest(
+    'SHA-256',
+    new TextEncoder().encode(passwordWithSalt)
+  );
+
+  // convert the hashed password to a hex string
+  return Array.from(new Uint8Array(hashedPassword))
+    .map((b) => b.toString(16).padStart(2, '0'))
+    .join('');
+}

package/src/currencies.ts

@@ -0,0 +1,97 @@
+/**
+ * Centralized currency configuration
+ *
+ * This module provides a single source of truth for all supported currencies.
+ * The `SupportedCurrency` type is automatically derived from the array,
+ * ensuring type safety without manual maintenance of union types.
+ *
+ * To add a new currency:
+ * 1. Add an entry to SUPPORTED_CURRENCIES below
+ * 2. Add translations in apps/web/messages/{en,vi}.json under ws-finance-settings
+ */
+
+/**
+ * All supported currencies with their locale mappings.
+ * Sorted alphabetically by currency code.
+ */
+export const SUPPORTED_CURRENCIES = [
+  { code: 'AED', locale: 'ar-AE', name: 'UAE Dirham' },
+  { code: 'AUD', locale: 'en-AU', name: 'Australian Dollar' },
+  { code: 'BRL', locale: 'pt-BR', name: 'Brazilian Real' },
+  { code: 'CAD', locale: 'en-CA', name: 'Canadian Dollar' },
+  { code: 'CHF', locale: 'de-CH', name: 'Swiss Franc' },
+  { code: 'CNY', locale: 'zh-CN', name: 'Chinese Yuan' },
+  { code: 'CZK', locale: 'cs-CZ', name: 'Czech Koruna' },
+  { code: 'DKK', locale: 'da-DK', name: 'Danish Krone' },
+  { code: 'EUR', locale: 'de-DE', name: 'Euro' },
+  { code: 'GBP', locale: 'en-GB', name: 'British Pound' },
+  { code: 'HKD', locale: 'zh-HK', name: 'Hong Kong Dollar' },
+  { code: 'HUF', locale: 'hu-HU', name: 'Hungarian Forint' },
+  { code: 'IDR', locale: 'id-ID', name: 'Indonesian Rupiah' },
+  { code: 'INR', locale: 'hi-IN', name: 'Indian Rupee' },
+  { code: 'JPY', locale: 'ja-JP', name: 'Japanese Yen' },
+  { code: 'KRW', locale: 'ko-KR', name: 'South Korean Won' },
+  { code: 'MXN', locale: 'es-MX', name: 'Mexican Peso' },
+  { code: 'MYR', locale: 'ms-MY', name: 'Malaysian Ringgit' },
+  { code: 'NOK', locale: 'nb-NO', name: 'Norwegian Krone' },
+  { code: 'NZD', locale: 'en-NZ', name: 'New Zealand Dollar' },
+  { code: 'PHP', locale: 'en-PH', name: 'Philippine Peso' },
+  { code: 'PLN', locale: 'pl-PL', name: 'Polish Zloty' },
+  { code: 'SAR', locale: 'ar-SA', name: 'Saudi Riyal' },
+  { code: 'SEK', locale: 'sv-SE', name: 'Swedish Krona' },
+  { code: 'SGD', locale: 'en-SG', name: 'Singapore Dollar' },
+  { code: 'THB', locale: 'th-TH', name: 'Thai Baht' },
+  { code: 'TWD', locale: 'zh-TW', name: 'Taiwan Dollar' },
+  { code: 'USD', locale: 'en-US', name: 'US Dollar' },
+  { code: 'VND', locale: 'vi-VN', name: 'Vietnamese Dong' },
+  { code: 'ZAR', locale: 'en-ZA', name: 'South African Rand' },
+] as const;
+
+/**
+ * Type representing all supported currency codes.
+ * Automatically derived from SUPPORTED_CURRENCIES array.
+ */
+export type SupportedCurrency = (typeof SUPPORTED_CURRENCIES)[number]['code'];
+
+/**
+ * Type for a single currency configuration entry.
+ */
+export type CurrencyConfig = (typeof SUPPORTED_CURRENCIES)[number];
+
+/**
+ * Get the locale for a specific currency.
+ * Falls back to 'en-US' for unknown currencies.
+ *
+ * @param currency - The currency code (e.g., 'USD', 'EUR', 'VND')
+ * @returns The BCP 47 locale string for the currency
+ */
+export function getCurrencyLocale(currency = 'VND'): string {
+  const found = SUPPORTED_CURRENCIES.find(
+    (c) => c.code === currency.toUpperCase()
+  );
+  return found?.locale ?? 'en-US';
+}
+
+/**
+ * Check if a currency code is supported.
+ *
+ * @param currency - The currency code to check
+ * @returns True if the currency is supported
+ */
+export function isSupportedCurrency(
+  currency: string
+): currency is SupportedCurrency {
+  return SUPPORTED_CURRENCIES.some((c) => c.code === currency.toUpperCase());
+}
+
+/**
+ * Get the full configuration for a currency.
+ *
+ * @param currency - The currency code
+ * @returns The currency configuration or undefined if not found
+ */
+export function getCurrencyConfig(
+  currency: string
+): CurrencyConfig | undefined {
+  return SUPPORTED_CURRENCIES.find((c) => c.code === currency.toUpperCase());
+}