Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
import type { Price } from '@spree/admin-sdk'
import { formatMoney } from '@spree/core'
import { parseISO } from 'date-fns'
import { formatInTimeZone } from 'date-fns-tz'
import i18n from 'i18next'
export { formatMoney }
/**
* A price's amount in its currency, in the admin's own number format. A unit
* price keeps a fraction of a cent. `display_amount` is accepted and ignored
* so callers built against the old shape keep compiling.
*/
export function formatPrice(
price: (Pick<Price, 'amount' | 'currency'> & { display_amount?: string | null }) | null,
locale: string = i18n.language || 'en',
) {
if (!price?.amount || !price.currency) return '—'
return formatMoney(price.amount, price.currency, locale, { unitPrice: true })
}
/**
* Formats an API amount (a decimal string) in its currency, or answers
* `fallback` when either is missing or `Intl` cannot format the pair.
*/
export function formatAmount(
amount: string | null | undefined,
currency: string | null | undefined,
locale?: string,
fallback = '—',
): string {
if (!currency) return fallback
return formatMoney(amount, currency, locale) || fallback
}
export function formatStoreDateTime(iso: string, timezone: string) {
return formatInTimeZone(parseISO(iso), timezone, 'PPP p')
}
export function formatStoreDate(iso: string, timezone: string) {
return formatInTimeZone(parseISO(iso), timezone, 'PP')
}
export function getInitials(fullName: string | null | undefined, fallback: string): string {
const parts = (fullName ?? '').trim().split(/\s+/).filter(Boolean)
if (parts.length === 0) return fallback.charAt(0)
if (parts.length === 1) return parts[0].charAt(0)
return parts[0].charAt(0) + parts[parts.length - 1].charAt(0)
}