Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

feat(billing): use Stripe AddressElement for billing address form (#44105)

Kanishk Dudejabe3737d9d028
diff --git a/apps/studio/components/interfaces/App/UpdateBillingAddressModal.tsx b/apps/studio/components/interfaces/App/UpdateBillingAddressModal.tsx
index ace56210779..bf55a3a2530 100644
--- a/apps/studio/components/interfaces/App/UpdateBillingAddressModal.tsx
+++ b/apps/studio/components/interfaces/App/UpdateBillingAddressModal.tsx
@@ -1,7 +1,24 @@
+import { Elements } from '@stripe/react-stripe-js'
+import { loadStripe, StripeAddressElement, StripeElementsOptions } from '@stripe/stripe-js'
import { PermissionAction } from '@supabase/shared-types/out/constants'
import { useQueryClient } from '@tanstack/react-query'
import { useFlag } from 'common'
-import { useMemo, useState } from 'react'
+import {
+ getAddressElementAppearanceOptions,
+ STRIPE_ELEMENT_FONTS,
+} from 'components/interfaces/Billing/Payment/Payment.utils'
+import { BillingCustomerDataForm } from 'components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerDataForm'
+import { useBillingCustomerDataForm } from 'components/interfaces/Organization/BillingSettings/BillingCustomerData/useBillingCustomerDataForm'
+import { useOrganizationCustomerProfileQuery } from 'data/organizations/organization-customer-profile-query'
+import { useOrganizationCustomerProfileUpdateMutation } from 'data/organizations/organization-customer-profile-update-mutation'
+import { useOrganizationTaxIdQuery } from 'data/organizations/organization-tax-id-query'
+import { useOrganizationTaxIdUpdateMutation } from 'data/organizations/organization-tax-id-update-mutation'
+import { invalidateOrganizationsQuery } from 'data/organizations/organizations-query'
+import { useAsyncCheckPermissions } from 'hooks/misc/useCheckPermissions'
+import { useSelectedOrganizationQuery } from 'hooks/misc/useSelectedOrganization'
+import { IS_PLATFORM, STRIPE_PUBLIC_KEY } from 'lib/constants'
+import { useTheme } from 'next-themes'
+import { useEffect, useMemo, useRef, useState } from 'react'
import { toast } from 'sonner'
import {
Button,
@@ -16,26 +33,15 @@ import {
} from 'ui'
import { ShimmeringLoader } from 'ui-patterns/ShimmeringLoader'
-import {
- BillingCustomerDataForm,
- type BillingCustomerDataFormValues,
-} from '@/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerDataForm'
-import { resolveStoredTaxId } from '@/components/interfaces/Organization/BillingSettings/BillingCustomerData/TaxID.utils'
-import { useBillingCustomerDataForm } from '@/components/interfaces/Organization/BillingSettings/BillingCustomerData/useBillingCustomerDataForm'
-import { useOrganizationCustomerProfileQuery } from '@/data/organizations/organization-customer-profile-query'
-import { useOrganizationCustomerProfileUpdateMutation } from '@/data/organizations/organization-customer-profile-update-mutation'
-import { useOrganizationTaxIdQuery } from '@/data/organizations/organization-tax-id-query'
-import { useOrganizationTaxIdUpdateMutation } from '@/data/organizations/organization-tax-id-update-mutation'
-import { invalidateOrganizationsQuery } from '@/data/organizations/organizations-query'
-import { useAsyncCheckPermissions } from '@/hooks/misc/useCheckPermissions'
-import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
-import { IS_PLATFORM } from '@/lib/constants'
+const stripePromise = loadStripe(STRIPE_PUBLIC_KEY)
export function UpdateBillingAddressModal() {
const queryClient = useQueryClient()
+ const { resolvedTheme } = useTheme()
const [dismissed, setDismissed] = useState(false)
const [isSubmitting, setIsSubmitting] = useState(false)
+ const addressElementRef = useRef<StripeAddressElement | null>(null)
const showMissingAddressModal = useFlag('enableBillingAddressModal')
const { data: org } = useSelectedOrganizationQuery()
@@ -86,55 +92,92 @@ export function UpdateBillingAddressModal() {
const open =
shouldShow && !dismissed && (!canManageBillingAddress || (!profileError && !taxIdError))
- const initialCustomerData = useMemo<Partial<BillingCustomerDataFormValues>>(
- () => ({
- city: customerProfile?.address?.city ?? undefined,
- country: customerProfile?.address?.country,
- line1: customerProfile?.address?.line1,
- line2: customerProfile?.address?.line2 ?? undefined,
- postal_code: customerProfile?.address?.postal_code ?? undefined,
- state: customerProfile?.address?.state ?? undefined,
- billing_name: customerProfile?.billing_name,
- tax_id_type: taxId?.type,
- tax_id_value: taxId?.value,
- tax_id_name: taxId
- ? (resolveStoredTaxId(taxId.type, taxId.country, customerProfile?.address?.country)?.name ??
- '')
- : '',
- }),
- [customerProfile, taxId]
- )
-
- const { mutateAsync: updateCustomerProfile } = useOrganizationCustomerProfileUpdateMutation()
- const { mutateAsync: updateTaxId } = useOrganizationTaxIdUpdateMutation()
+ const { mutateAsync: updateCustomerProfile } = useOrganizationCustomerProfileUpdateMutation({
+ onError: () => {},
+ })
+ const { mutateAsync: updateTaxId } = useOrganizationTaxIdUpdateMutation({ onError: () => {} })
- const { form, handleSubmit, isDirty } = useBillingCustomerDataForm({
- initialCustomerData,
+ const {
+ form,
+ handleSubmit,
+ isDirty,
+ resetKey,
+ onAddressChange,
+ applyAddressElementValue,
+ markCurrentValuesAsSaved,
+ addressCountry,
+ addressOptions,
+ } = useBillingCustomerDataForm({
+ customerProfile,
+ taxId,
onCustomerDataChange: async (data) => {
if (!slug) return
setIsSubmitting(true)
try {
- await updateCustomerProfile({
- slug,
- address: data.address,
- billing_name: data.billing_name,
- })
-
- await updateTaxId({ slug, taxId: data.tax_id })
-
- await invalidateOrganizationsQuery(queryClient)
+ try {
+ await updateCustomerProfile({
+ slug,
+ address: data.address,
+ billing_name: data.billing_name,
+ })
+ setDismissed(true)
+ await invalidateOrganizationsQuery(queryClient)
+ } catch (error: any) {
+ toast.error(`Failed to update billing address: ${error.message}`)
+ throw error
+ }
+
+ try {
+ await updateTaxId({ slug, taxId: data.tax_id })
+ } catch (error: any) {
+ toast.error(`Failed to update tax ID: ${error.message}`)
+ throw error
+ }
toast.success('Successfully updated billing address')
- setDismissed(true)
- } catch (error: any) {
- toast.error(`Failed to update billing address: ${error.message}`)
} finally {
setIsSubmitting(false)
}
},
})
+ useEffect(() => {
+ addressElementRef.current = null
+ }, [resetKey])
+
+ const onFormSubmit = async (e: React.FormEvent) => {
+ e.preventDefault()
+ try {
+ if (addressElementRef.current) {
+ const addressResult = await addressElementRef.current.getValue()
+ applyAddressElementValue(addressResult)
+ }
+ const result = await handleSubmit()
+ if (result.status === 'error') {
+ toast.error(result.message)
+ return
+ }
+ markCurrentValuesAsSaved(
+ result.submittedState.addressValue,
+ result.submittedState.taxIdValues
+ )
+ } catch {
+ // Save failure toasts are handled inside onCustomerDataChange.
+ }
+ }
+
+ const stripeElementsOptions: StripeElementsOptions = useMemo(
+ () =>
+ ({
+ mode: 'setup',
+ currency: 'usd',
+ appearance: getAddressElementAppearanceOptions(resolvedTheme),
+ fonts: STRIPE_ELEMENT_FONTS,
+ }) as any,
+ [resolvedTheme]
+ )
+
return (
<Dialog
open={open}
@@ -176,23 +219,34 @@ export function UpdateBillingAddressModal() {
</div>
</DialogSection>
) : (
- <Form {...form}>
- <form onSubmit={form.handleSubmit(handleSubmit)}>
- <DialogSection className="max-h-[60vh] overflow-y-auto">
- <BillingCustomerDataForm form={form} />
- </DialogSection>
- <DialogFooter>
- <Button
- type="primary"
- htmlType="submit"
- loading={isSubmitting}
- disabled={!isDirty || isSubmitting}
- >
- Save address
- </Button>
- </DialogFooter>
- </form>
- </Form>
+ <Elements stripe={stripePromise} options={stripeElementsOptions}>
+ <Form {...form}>
+ <form onSubmit={onFormSubmit}>
+ <DialogSection className="max-h-[60vh] overflow-y-auto">
+ <BillingCustomerDataForm
+ form={form}
+ addressOptions={addressOptions}
+ resetKey={resetKey}
+ onAddressChange={onAddressChange}
+ onAddressReady={(element) => {
+ addressElementRef.current = element
+ }}
+ addressCountry={addressCountry}
+ />
+ </DialogSection>
+ <DialogFooter>
+ <Button
+ type="primary"
+ htmlType="submit"
+ loading={isSubmitting}
+ disabled={!isDirty || isSubmitting}
+ >
+ Save address
+ </Button>
+ </DialogFooter>
+ </form>
+ </Form>
+ </Elements>
))}
</DialogContent>
</Dialog>
diff --git a/apps/studio/components/interfaces/Billing/Payment/Payment.utils.ts b/apps/studio/components/interfaces/Billing/Payment/Payment.utils.ts
index ff8b08bbc7d..82a66aa0d1b 100644
--- a/apps/studio/components/interfaces/Billing/Payment/Payment.utils.ts
+++ b/apps/studio/components/interfaces/Billing/Payment/Payment.utils.ts
@@ -1,4 +1,21 @@
-import type { Appearance } from '@stripe/stripe-js'
+import type { Appearance, CustomFontSource } from '@stripe/stripe-js'
+import { CUSTOM_FONT_BOOK_DATA_URL } from 'fonts/stripe-fonts'
+
+/**
+ * Custom font for Stripe Elements iframes.
+ * Stripe renders inside an iframe that can't access the parent page's CSS variables or fonts,
+ * so we pass the font explicitly (Stripe requires https:// or data:// sources).
+ * Keep using the data URL in all environments for now, since the CDN-hosted font still has
+ * CORS issues when Stripe loads it from inside its iframe.
+ */
+const fontSrc = `url(${CUSTOM_FONT_BOOK_DATA_URL})`
+
+export const STRIPE_ELEMENT_FONTS: CustomFontSource[] = [
+ {
+ family: 'CustomFont',
+ src: fontSrc,
+ },
+]
export const getStripeElementsAppearanceOptions = (
resolvedTheme: string | undefined
@@ -11,8 +28,7 @@ export const getStripeElementsAppearanceOptions = (
colorBackground: resolvedTheme?.includes('dark')
? 'hsl(0deg 0% 14.1%)'
: 'hsl(0deg 0% 95.3%)',
- fontFamily:
- 'var(--font-custom, Circular, custom-font, Helvetica Neue, Helvetica, Arial, sans-serif)',
+ fontFamily: 'CustomFont, Helvetica Neue, Helvetica, Arial, sans-serif',
},
rules: {
'.TermsText': {
@@ -37,3 +53,31 @@ export const getStripeElementsAppearanceOptions = (
},
}
}
+
+export const getAddressElementAppearanceOptions = (
+ resolvedTheme: string | undefined
+): Appearance => {
+ const isDark = resolvedTheme?.includes('dark')
+
+ return {
+ labels: 'above' as const,
+ theme: (isDark ? 'night' : 'flat') as 'night' | 'flat',
+ variables: {
+ fontSizeBase: '14px',
+ spacingUnit: '7px',
+ colorPrimary: isDark ? 'hsl(0deg 0% 32%)' : 'hsl(0deg 0% 55%)',
+ colorBackground: isDark ? 'hsl(0deg 0% 14.1%)' : 'hsl(0deg 0% 95.3%)',
+ borderRadius: '4px',
+ fontFamily: 'CustomFont, Helvetica Neue, Helvetica, Arial, sans-serif',
+ },
+ rules: {
+ '.Input': {
+ boxShadow: isDark ? 'none' : 'inset 0 0 0 1px hsl(0deg 0% 80%)',
+ height: '34px',
+ lineHeight: '16px',
+ padding: '8px 12px',
+ borderWidth: '1px',
+ },
+ },
+ }
+}
diff --git a/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerData.tsx b/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerData.tsx
index f86fe50419f..8e242070668 100644
--- a/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerData.tsx
+++ b/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerData.tsx
@@ -1,36 +1,43 @@
+import { Elements } from '@stripe/react-stripe-js'
+import { loadStripe, StripeAddressElement, StripeElementsOptions } from '@stripe/stripe-js'
import { PermissionAction } from '@supabase/shared-types/out/constants'
import { useQueryClient } from '@tanstack/react-query'
import { useParams } from 'common'
-import { useMemo, useState } from 'react'
-import { toast } from 'sonner'
-import { Button, Card, CardFooter, Form_Shadcn_ as Form } from 'ui'
-import { ShimmeringLoader } from 'ui-patterns/ShimmeringLoader'
-
import {
- BillingCustomerDataForm,
- type BillingCustomerDataFormValues,
-} from './BillingCustomerDataForm'
-import { resolveStoredTaxId } from './TaxID.utils'
-import { useBillingCustomerDataForm } from './useBillingCustomerDataForm'
+ getAddressElementAppearanceOptions,
+ STRIPE_ELEMENT_FONTS,
+} from 'components/interfaces/Billing/Payment/Payment.utils'
import {
ScaffoldSection,
ScaffoldSectionContent,
ScaffoldSectionDetail,
-} from '@/components/layouts/Scaffold'
-import AlertError from '@/components/ui/AlertError'
-import NoPermission from '@/components/ui/NoPermission'
-import PartnerManagedResource from '@/components/ui/PartnerManagedResource'
-import { organizationKeys } from '@/data/organizations/keys'
-import { useOrganizationCustomerProfileQuery } from '@/data/organizations/organization-customer-profile-query'
-import { useOrganizationCustomerProfileUpdateMutation } from '@/data/organizations/organization-customer-profile-update-mutation'
-import { useOrganizationTaxIdQuery } from '@/data/organizations/organization-tax-id-query'
-import { useOrganizationTaxIdUpdateMutation } from '@/data/organizations/organization-tax-id-update-mutation'
-import { useAsyncCheckPermissions } from '@/hooks/misc/useCheckPermissions'
-import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
+} from 'components/layouts/Scaffold'
+import AlertError from 'components/ui/AlertError'
+import NoPermission from 'components/ui/NoPermission'
+import PartnerManagedResource from 'components/ui/PartnerManagedResource'
+import { organizationKeys } from 'data/organizations/keys'
+import { useOrganizationCustomerProfileQuery } from 'data/organizations/organization-customer-profile-query'
+import { useOrganizationCustomerProfileUpdateMutation } from 'data/organizations/organization-customer-profile-update-mutation'
+import { useOrganizationTaxIdQuery } from 'data/organizations/organization-tax-id-query'
+import { useOrganizationTaxIdUpdateMutation } from 'data/organizations/organization-tax-id-update-mutation'
+import { useAsyncCheckPermissions } from 'hooks/misc/useCheckPermissions'
+import { useSelectedOrganizationQuery } from 'hooks/misc/useSelectedOrganization'
+import { STRIPE_PUBLIC_KEY } from 'lib/constants'
+import { useTheme } from 'next-themes'
+import { useEffect, useMemo, useRef, useState } from 'react'
+import { toast } from 'sonner'
+import { Button, Card, CardFooter, Form_Shadcn_ as Form } from 'ui'
+import { ShimmeringLoader } from 'ui-patterns/ShimmeringLoader'
+
+import { BillingCustomerDataForm } from './BillingCustomerDataForm'
+import { useBillingCustomerDataForm } from './useBillingCustomerDataForm'
+
+const stripePromise = loadStripe(STRIPE_PUBLIC_KEY)
export const BillingCustomerData = () => {
const { slug } = useParams()
const queryClient = useQueryClient()
+ const { resolvedTheme } = useTheme()
const { data: selectedOrganization } = useSelectedOrganizationQuery()
const { can: canReadBillingCustomerData, isSuccess: isPermissionsLoaded } =
@@ -54,49 +61,56 @@ export const BillingCustomerData = () => {
isSuccess: loadedTaxId,
} = useOrganizationTaxIdQuery({ slug })
- const initialCustomerData = useMemo<Partial<BillingCustomerDataFormValues>>(
- () => ({
- city: customerProfile?.address?.city ?? undefined,
- country: customerProfile?.address?.country,
- line1: customerProfile?.address?.line1,
- line2: customerProfile?.address?.line2 ?? undefined,
- postal_code: customerProfile?.address?.postal_code ?? undefined,
- state: customerProfile?.address?.state ?? undefined,
- billing_name: customerProfile?.billing_name,
- tax_id_type: taxId?.type,
- tax_id_value: taxId?.value,
- tax_id_name: taxId
- ? (resolveStoredTaxId(taxId.type, taxId.country, customerProfile?.address?.country)?.name ??
- '')
- : '',
- }),
- [customerProfile, taxId]
- )
-
- const { mutateAsync: updateCustomerProfile } = useOrganizationCustomerProfileUpdateMutation()
- const { mutateAsync: updateTaxId } = useOrganizationTaxIdUpdateMutation()
+ const { mutateAsync: updateCustomerProfile } = useOrganizationCustomerProfileUpdateMutation({
+ onError: () => {},
+ })
+ const { mutateAsync: updateTaxId } = useOrganizationTaxIdUpdateMutation({ onError: () => {} })
const [isSubmitting, setIsSubmitting] = useState(false)
+ const addressElementRef = useRef<StripeAddressElement | null>(null)
- const { form, handleSubmit, handleReset, isDirty } = useBillingCustomerDataForm({
- initialCustomerData,
+ const {
+ form,
+ handleSubmit,
+ handleReset,
+ isDirty,
+ resetKey,
+ onAddressChange,
+ applyAddressElementValue,
+ markCurrentValuesAsSaved,
+ addressCountry,
+ addressOptions,
+ } = useBillingCustomerDataForm({
+ customerProfile,
+ taxId,
onCustomerDataChange: async (data) => {
setIsSubmitting(true)
try {
- await updateCustomerProfile({
- slug,
- address: data.address,
- billing_name: data.billing_name,
- })
+ try {
+ await updateCustomerProfile({
+ slug,
+ address: data.address,
+ billing_name: data.billing_name,
+ })
+ } catch (error) {
+ toast.error(
+ `Failed updating billing address: ${error instanceof Error ? error.message : 'Unknown error'}`
+ )
+ throw error
+ }
- await updateTaxId({ slug, taxId: data.tax_id })
+ try {
+ await updateTaxId({ slug, taxId: data.tax_id })
+ } catch (error) {
+ toast.error(
+ `Failed updating tax ID: ${error instanceof Error ? error.message : 'Unknown error'}`
+ )
+ throw error
+ }
toast.success('Successfully updated billing data')
- // Optimistically update organization_missing_tax_id in the cached organizations list
- // so the TaxIdBanner hides immediately. The server responds 304 Not Modified for a
- // while after the tax ID is saved, so invalidation/refetch won't work here.
queryClient.setQueriesData<any[]>(
{ queryKey: organizationKeys.list(), exact: true },
(prev) => {
@@ -106,19 +120,52 @@ export const BillingCustomerData = () => {
)
}
)
-
- setIsSubmitting(false)
} catch (error) {
- toast.error(
- `Failed updating billing data: ${error instanceof Error ? error.message : 'Unknown error'}`
- )
+ throw error
+ } finally {
setIsSubmitting(false)
}
},
})
+ useEffect(() => {
+ addressElementRef.current = null
+ }, [resetKey])
+
+ const onFormSubmit = async (e: React.FormEvent) => {
+ e.preventDefault()
+ try {
+ if (addressElementRef.current) {
+ const addressResult = await addressElementRef.current.getValue()
+ applyAddressElementValue(addressResult)
+ }
+ const result = await handleSubmit()
+ if (result.status === 'error') {
+ toast.error(result.message)
+ return
+ }
+ markCurrentValuesAsSaved(
+ result.submittedState.addressValue,
+ result.submittedState.taxIdValues
+ )
+ } catch {
+ // Save failure toasts are handled inside onCustomerDataChange.
+ }
+ }
+
const isSubmitDisabled = !isDirty || !canUpdateBillingCustomerData || isSubmitting
+ const stripeElementsOptions: StripeElementsOptions = useMemo(
+ () =>
+ ({
+ mode: 'setup',
+ currency: 'usd',
+ appearance: getAddressElementAppearanceOptions(resolvedTheme),
+ fonts: STRIPE_ELEMENT_FONTS,
+ }) as any,
+ [resolvedTheme]
+ )
+
return (
<ScaffoldSection>
<ScaffoldSectionDetail>
@@ -162,38 +209,47 @@ export const BillingCustomerData = () => {
)}
{isSuccess && loadedTaxId && (
- <Card>
- <Form {...form}>
- <form onSubmit={form.handleSubmit(handleSubmit)}>
- <BillingCustomerDataForm
- className="p-8"
- form={form}
- disabled={!canUpdateBillingCustomerData}
- />
- <CardFooter className="border-t justify-end px-8">
- {!canUpdateBillingCustomerData && (
- <span className="text-sm text-foreground-lighter mr-auto">
- You need additional permissions to manage this organization's billing
- address
- </span>
- )}
- <div className="flex items-center gap-2">
- <Button type="default" onClick={handleReset} disabled={isSubmitDisabled}>
- Cancel
- </Button>
- <Button
- type="primary"
- htmlType="submit"
- disabled={isSubmitDisabled}
- loading={isSubmitting}
- >
- Save
- </Button>
- </div>
- </CardFooter>
- </form>
- </Form>
- </Card>
+ <Elements stripe={stripePromise} options={stripeElementsOptions}>
+ <Card>
+ <Form {...form}>
+ <form onSubmit={onFormSubmit}>
+ <BillingCustomerDataForm
+ className="p-8"
+ form={form}
+ disabled={!canUpdateBillingCustomerData}
+ addressOptions={addressOptions}
+ resetKey={resetKey}
+ onAddressChange={onAddressChange}
+ onAddressReady={(element) => {
+ addressElementRef.current = element
+ }}
+ addressCountry={addressCountry}
+ />
+ <CardFooter className="border-t justify-end px-8">
+ {!canUpdateBillingCustomerData && (
+ <span className="text-sm text-foreground-lighter mr-auto">
+ You need additional permissions to manage this organization's billing
+ address
+ </span>
+ )}
+ <div className="flex items-center gap-2">
+ <Button type="default" onClick={handleReset} disabled={isSubmitDisabled}>
+ Cancel
+ </Button>
+ <Button
+ type="primary"
+ htmlType="submit"
+ disabled={isSubmitDisabled}
+ loading={isSubmitting}
+ >
+ Save
+ </Button>
+ </div>
+ </CardFooter>
+ </form>
+ </Form>
+ </Card>
+ </Elements>
)}
</>
)}
diff --git a/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerDataForm.tsx b/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerDataForm.tsx
index 6c7bdf13daa..ac9341ef29b 100644
--- a/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerDataForm.tsx
+++ b/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/BillingCustomerDataForm.tsx
@@ -1,3 +1,9 @@
+import { AddressElement } from '@stripe/react-stripe-js'
+import type {
+ StripeAddressElement,
+ StripeAddressElementChangeEvent,
+ StripeAddressElementOptions,
+} from '@stripe/stripe-js'
import { Check, ChevronsUpDown, Info, X } from 'lucide-react'
import { useId, useMemo, useState } from 'react'
import { UseFormReturn } from 'react-hook-form'
@@ -24,47 +30,46 @@ import {
import { FormItemLayout } from 'ui-patterns/form/FormItemLayout/FormItemLayout'
import { z } from 'zod'
-import { COUNTRIES } from './BillingAddress.constants'
import { TAX_IDS } from './TaxID.constants'
interface BillingCustomerDataFormProps {
- form: UseFormReturn<BillingCustomerDataFormValues>
+ form: UseFormReturn<TaxIdFormValues>
disabled?: boolean
className?: string
+ addressOptions: StripeAddressElementOptions
+ resetKey: number
+ onAddressChange: (evt: StripeAddressElementChangeEvent) => void
+ onAddressReady?: (element: StripeAddressElement) => void
+ addressCountry?: string
}
-// Define the expected form values structure and validation schema
-export const BillingCustomerDataSchema = z.object({
- billing_name: z.string().min(3, 'Name must be at least 3 letters long'),
- line1: z.string().trim().min(3, 'Address line 1 is required'),
- line2: z.string().optional(),
- city: z.string().trim().min(2, 'City is required'),
- state: z.string().trim(),
- postal_code: z.string().trim().min(1, 'Postal code is required'),
- country: z.string().trim().min(1, 'Country is required'),
+export const TaxIdSchema = z.object({
tax_id_type: z.string(),
tax_id_value: z.string(),
tax_id_name: z.string(),
})
-export type BillingCustomerDataFormValues = z.infer<typeof BillingCustomerDataSchema>
+export type TaxIdFormValues = z.infer<typeof TaxIdSchema>
export const BillingCustomerDataForm = ({
form,
disabled = false,
className,
+ addressOptions,
+ resetKey,
+ onAddressChange,
+ onAddressReady,
+ addressCountry,
}: BillingCustomerDataFormProps) => {
- const [showCountriesPopover, setShowCountriesPopover] = useState(false)
const [showTaxIDsPopover, setShowTaxIDsPopover] = useState(false)
- const countryListboxId = useId()
const taxIdListboxId = useId()
const onSelectTaxIdType = (name: string) => {
const selectedTaxIdOption = TAX_IDS.find((option) => option.name === name)
if (!selectedTaxIdOption) return
- form.setValue('tax_id_type', selectedTaxIdOption.type)
- form.setValue('tax_id_value', '')
- form.setValue('tax_id_name', name)
+ form.setValue('tax_id_type', selectedTaxIdOption.type, { shouldDirty: true })
+ form.setValue('tax_id_value', '', { shouldDirty: true })
+ form.setValue('tax_id_name', name, { shouldDirty: true })
}
const onRemoveTaxId = () => {
@@ -73,178 +78,28 @@ export const BillingCustomerDataForm = ({
form.setValue('tax_id_value', '', { shouldDirty: true })
}
- const { tax_id_name, country } = form.watch()
+ const { tax_id_name } = form.watch()
const selectedTaxId = TAX_IDS.find((option) => option.name === tax_id_name)
const availableTaxIds = useMemo(() => {
- return TAX_IDS.filter((taxId) => !country || taxId.countryIso2 === country).sort((a, b) =>
- a.country.localeCompare(b.country)
+ return TAX_IDS.filter((taxId) => !addressCountry || taxId.countryIso2 === addressCountry).sort(
+ (a, b) => a.country.localeCompare(b.country)
)
- }, [country])
+ }, [addressCountry])
return (
<div className={cn('flex flex-col space-y-4', className)}>
- <FormField
- control={form.control}
- name="billing_name"
- render={({ field }) => (
- <FormItemLayout hideMessage label="Name">
- <FormControl>
- <Input {...field} disabled={disabled} />
- </FormControl>
- <FormMessage />
- </FormItemLayout>
- )}
- />
-
- <FormField
- control={form.control}
- name="line1"
- render={({ field }) => (
- <FormItemLayout hideMessage label="Address line 1">
- <FormControl>
- <Input {...field} placeholder="123 Main Street" disabled={disabled} />
- </FormControl>
- <FormMessage />
- </FormItemLayout>
- )}
- />
-
- <FormField
- control={form.control}
- name="line2"
- render={({ field }) => (
- <FormItemLayout hideMessage label="Address line 2 (optional)">
- <FormControl>
- <Input
- {...field}
- placeholder="Apartment, suite, unit, building, floor, etc."
- disabled={disabled}
- />
- </FormControl>
- <FormMessage />
- </FormItemLayout>
- )}
- />
-
- <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
- <FormField
- control={form.control}
- name="country"
- render={({ field }) => (
- <FormItemLayout hideMessage label="Country">
- <Popover open={showCountriesPopover} onOpenChange={setShowCountriesPopover}>
- <PopoverTrigger asChild>
- <FormControl>
- <Button
- type="default"
- role="combobox"
- size="medium"
- disabled={disabled}
- aria-expanded={showCountriesPopover}
- aria-controls={countryListboxId}
- className={cn(
- 'w-full justify-between h-[34px]',
- !field.value && 'text-muted'
- )}
- iconRight={
- <ChevronsUpDown
- className="ml-2 h-4 w-4 shrink-0 opacity-50"
- strokeWidth={1.5}
- />
- }
- >
- {field.value
- ? COUNTRIES.find((country) => country.code === field.value)?.name ||
- 'Select country'
- : 'Select country'}
- </Button>
- </FormControl>
- </PopoverTrigger>
- <PopoverContent
- id={countryListboxId}
- sameWidthAsTrigger
- className="p-0"
- align="start"
- >
- <Command>
- <CommandInput placeholder="Search country..." />
- <CommandList>
- <CommandEmpty>No country found.</CommandEmpty>
- <CommandGroup>
- {COUNTRIES.map((country) => (
- <CommandItem
- key={country.code}
- value={country.name}
- onSelect={() => {
- form.setValue('country', country.code, {
- shouldDirty: true,
- shouldTouch: true,
- shouldValidate: true,
- })
- setShowCountriesPopover(false)
- }}
- >
- <Check
- className={cn(
- 'mr-2 h-4 w-4',
- field.value === country.code ? 'opacity-100' : 'opacity-0'
- )}
- />
- {country.name}
- </CommandItem>
- ))}
- </CommandGroup>
- </CommandList>
- </Command>
- </PopoverContent>
- </Popover>
- <FormMessage />
- </FormItemLayout>
- )}
- />
- <FormField
- control={form.control}
- name="postal_code"
- render={({ field }) => (
- <FormItemLayout hideMessage label="Postal code">
- <FormControl>
- <Input {...field} placeholder="12345" disabled={disabled} />
- </FormControl>
- <FormMessage />
- </FormItemLayout>
- )}
- />
- </div>
-
- <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
- <FormField
- control={form.control}
- name="city"
- render={({ field }) => (
- <FormItemLayout hideMessage label="City">
- <FormControl>
- <Input {...field} disabled={disabled} />
- </FormControl>
- <FormMessage />
- </FormItemLayout>
- )}
- />
- <FormField
- control={form.control}
- name="state"
- render={({ field }) => (
- <FormItemLayout hideMessage label="State / Province">
- <FormControl>
- <Input {...field} disabled={disabled} />
- </FormControl>
- <FormMessage />
- </FormItemLayout>
- )}
+ <div className={cn('relative', disabled && 'opacity-50')}>
+ <AddressElement
+ key={`billing-address-${resetKey}`}
+ options={addressOptions}
+ onChange={onAddressChange}
+ onReady={onAddressReady}
/>
+ {disabled && <div className="absolute inset-0 z-10 cursor-not-allowed" />}
</div>
- <div className="grid grid-cols-2 gap-x-2 w-full items-end">
+ <div className={cn('grid grid-cols-2 gap-x-6 w-full items-end', disabled && 'opacity-50')}>
<FormField
name="tax_id_name"
control={form.control}
@@ -348,7 +203,13 @@ export const BillingCustomerDataForm = ({
)}
/>
- <Button type="text" className="px-1" icon={<X />} onClick={() => onRemoveTaxId()} />
+ <Button
+ type="text"
+ className="px-1"
+ icon={<X />}
+ disabled={disabled}
+ onClick={() => onRemoveTaxId()}
+ />
</div>
)}
</div>
diff --git a/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/useBillingCustomerDataForm.ts b/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/useBillingCustomerDataForm.ts
index b2589963d0f..70eafdacbad 100644
--- a/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/useBillingCustomerDataForm.ts
+++ b/apps/studio/components/interfaces/Organization/BillingSettings/BillingCustomerData/useBillingCustomerDataForm.ts
@@ -1,132 +1,243 @@
import { zodResolver } from '@hookform/resolvers/zod'
-import { components } from 'api-types'
-import { useEffect } from 'react'
+import type {
+ StripeAddressElement,
+ StripeAddressElementChangeEvent,
+ StripeAddressElementOptions,
+} from '@stripe/stripe-js'
+import type { CustomerAddress, CustomerTaxId } from 'data/organizations/types'
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
import { useForm } from 'react-hook-form'
-import { BillingCustomerDataFormValues, BillingCustomerDataSchema } from './BillingCustomerDataForm'
+import { TaxIdFormValues, TaxIdSchema } from './BillingCustomerDataForm'
import { TAX_IDS } from './TaxID.constants'
-import { getEffectiveTaxCountry, sanitizeTaxIdValue } from './TaxID.utils'
-import type { CustomerAddress } from '@/data/organizations/types'
+import { getEffectiveTaxCountry, resolveStoredTaxId, sanitizeTaxIdValue } from './TaxID.utils'
-export type FormCustomerData = {
+type StripeAddressValue = StripeAddressElementChangeEvent['value']
+type StripeAddressValidationState = 'unknown' | 'complete' | 'incomplete'
+type StripeAddressElementValueResult = Awaited<ReturnType<StripeAddressElement['getValue']>>
+
+interface UseBillingCustomerDataFormProps {
+ customerProfile?: {
+ address?: CustomerAddress | null
+ billing_name?: string
+ } | null
+ taxId?: CustomerTaxId | null
+ onCustomerDataChange: (data: BillingAddressPayload) => Promise<void>
+}
+
+export type BillingAddressPayload = {
address: CustomerAddress | undefined
billing_name: string
- tax_id: components['schemas']['TaxIdResponse']['tax_id'] | null
+ tax_id: CustomerTaxId | null
}
-interface UseBillingAddressFormProps {
- initialCustomerData?: Partial<BillingCustomerDataFormValues> | null
- onCustomerDataChange: (data: FormCustomerData) => void
+type SubmittedBillingFormState = {
+ addressValue: StripeAddressValue
+ taxIdValues: TaxIdFormValues
}
+type BillingFormSubmitResult =
+ | {
+ status: 'error'
+ message: string
+ }
+ | {
+ status: 'success'
+ submittedState: SubmittedBillingFormState
+ }
+
export function useBillingCustomerDataForm({
- initialCustomerData,
+ customerProfile,
+ taxId,
onCustomerDataChange,
-}: UseBillingAddressFormProps) {
- const form = useForm<BillingCustomerDataFormValues>({
- resolver: zodResolver(BillingCustomerDataSchema),
- defaultValues: {
- billing_name: initialCustomerData?.billing_name || '',
- line1: initialCustomerData?.line1 || '',
- line2: initialCustomerData?.line2 || '',
- city: initialCustomerData?.city || '',
- state: initialCustomerData?.state || '',
- postal_code: initialCustomerData?.postal_code || '',
- country: initialCustomerData?.country || '',
- tax_id_type: initialCustomerData?.tax_id_type || '',
- tax_id_value: initialCustomerData?.tax_id_value || '',
- tax_id_name: initialCustomerData?.tax_id_name || '',
- },
+}: UseBillingCustomerDataFormProps) {
+ const initialStripeAddressValue: StripeAddressValue = useMemo(
+ () => ({
+ name: customerProfile?.billing_name ?? '',
+ address: {
+ line1: customerProfile?.address?.line1 ?? '',
+ line2: customerProfile?.address?.line2 ?? '',
+ city: customerProfile?.address?.city ?? '',
+ state: customerProfile?.address?.state ?? '',
+ postal_code: customerProfile?.address?.postal_code ?? '',
+ country: customerProfile?.address?.country ?? '',
+ },
+ }),
+ [customerProfile]
+ )
+
+ const addressOptions: StripeAddressElementOptions = useMemo(
+ () => ({
+ mode: 'billing',
+ fields: { phone: 'never' },
+ autocomplete: {
+ apiKey: process.env.NEXT_PUBLIC_GOOGLE_MAPS_KEY!,
+ mode: 'google_maps_api' as const,
+ },
+ display: { name: 'full' as const },
+ defaultValues: initialStripeAddressValue,
+ }),
+ [initialStripeAddressValue]
+ )
+
+ const initialTaxIdValues = useMemo(
+ () => ({
+ tax_id_type: taxId?.type || '',
+ tax_id_value: taxId?.value || '',
+ tax_id_name: taxId
+ ? (resolveStoredTaxId(taxId.type, taxId.country, customerProfile?.address?.country)?.name ??
+ '')
+ : '',
+ }),
+ [customerProfile, taxId]
+ )
+
+ const form = useForm<TaxIdFormValues>({
+ resolver: zodResolver(TaxIdSchema),
+ defaultValues: initialTaxIdValues,
})
- // Update form when initialAddress changes
+ const stripeAddressRef = useRef<StripeAddressValue>(initialStripeAddressValue)
+ const savedStripeAddressRef = useRef<StripeAddressValue>(initialStripeAddressValue)
+ const stripeAddressValidationRef = useRef<StripeAddressValidationState>('unknown')
+ const savedTaxIdValuesRef = useRef<TaxIdFormValues>(initialTaxIdValues)
+ const [isAddressDirty, setIsAddressDirty] = useState(false)
+ const [addressCountry, setAddressCountry] = useState<string | undefined>(
+ initialStripeAddressValue.address.country || undefined
+ )
+ const [resetKey, setResetKey] = useState(0)
+
useEffect(() => {
- if (initialCustomerData) {
- form.reset({
- billing_name: initialCustomerData.billing_name || '',
- line1: initialCustomerData.line1 || '',
- line2: initialCustomerData.line2 || '',
- city: initialCustomerData.city || '',
- state: initialCustomerData.state || '',
- postal_code: initialCustomerData.postal_code || '',
- country: initialCustomerData.country || '',
- tax_id_type: initialCustomerData?.tax_id_type || '',
- tax_id_value: initialCustomerData?.tax_id_value || '',
- tax_id_name: initialCustomerData?.tax_id_name || '',
- })
+ savedStripeAddressRef.current = initialStripeAddressValue
+ savedTaxIdValuesRef.current = initialTaxIdValues
+ form.reset(initialTaxIdValues)
+ stripeAddressRef.current = initialStripeAddressValue
+ stripeAddressValidationRef.current = 'unknown'
+ setIsAddressDirty(false)
+ setAddressCountry(initialStripeAddressValue.address.country || undefined)
+ setResetKey((c) => c + 1)
+ // eslint-disable-next-line react-hooks/exhaustive-deps
+ }, [initialStripeAddressValue, initialTaxIdValues])
+
+ const onAddressChange = useCallback((evt: StripeAddressElementChangeEvent) => {
+ stripeAddressRef.current = evt.value
+ stripeAddressValidationRef.current = evt.complete ? 'complete' : 'incomplete'
+ setAddressCountry(evt.value.address.country || undefined)
+ setIsAddressDirty(!isAddressEqual(evt.value, savedStripeAddressRef.current))
+ }, [])
+
+ const applyAddressElementValue = useCallback((result: StripeAddressElementValueResult) => {
+ stripeAddressRef.current = result.value
+ stripeAddressValidationRef.current = result.complete ? 'complete' : 'incomplete'
+ setAddressCountry(result.value.address.country || undefined)
+ setIsAddressDirty(!isAddressEqual(result.value, savedStripeAddressRef.current))
+ }, [])
+
+ const isDirty = isAddressDirty || form.formState.isDirty
+
+ const syncCurrentState = useCallback(
+ (addressValue: StripeAddressValue, taxIdValues: TaxIdFormValues) => {
+ form.reset(taxIdValues)
+ stripeAddressRef.current = addressValue
+ stripeAddressValidationRef.current = 'unknown'
+ setIsAddressDirty(false)
+ setAddressCountry(addressValue.address.country || undefined)
+ },
+ [form]
+ )
+
+ const handleSubmit = async (): Promise<BillingFormSubmitResult> => {
+ const address = stripeAddressRef.current
+ const addressWasEdited =
+ isAddressDirty || !isAddressEqual(address, savedStripeAddressRef.current)
+
+ if (!address.name?.trim()) {
+ return { status: 'error', message: 'Full name is required.' }
+ }
+ if (!address.address.country?.trim()) {
+ return { status: 'error', message: 'Country is required.' }
+ }
+ if (!address.address.line1?.trim()) {
+ return { status: 'error', message: 'Address Line 1 is required.' }
}
- }, [initialCustomerData])
-
- const handleSubmit = async (values: BillingCustomerDataFormValues) => {
- const trimmedValues = Object.entries(values).reduce((acc, [key, value]) => {
- acc[key as keyof BillingCustomerDataFormValues] =
- typeof value === 'string' ? value.trim() : value
- return acc
- }, {} as BillingCustomerDataFormValues)
-
- const addressPayload = !trimmedValues.line1 ? null : trimmedValues
-
- const selectedTaxId = TAX_IDS.find((option) => option.name === values.tax_id_name)
-
- onCustomerDataChange({
- address: addressPayload
- ? {
- line1: trimmedValues.line1!,
- line2: trimmedValues.line2,
- city: trimmedValues.city,
- state: trimmedValues.state,
- postal_code: trimmedValues.postal_code,
- country: trimmedValues.country!,
- }
- : undefined,
- billing_name: trimmedValues.billing_name,
+ if (addressWasEdited && stripeAddressValidationRef.current === 'incomplete') {
+ return { status: 'error', message: 'Please enter a valid billing address.' }
+ }
+
+ const taxIdValues = form.getValues()
+ const selectedTaxId = TAX_IDS.find((option) => option.name === taxIdValues.tax_id_name)
+
+ const payload = {
+ address: {
+ line1: address.address.line1.trim(),
+ line2: address.address.line2?.trim() || undefined,
+ city: address.address.city.trim(),
+ state: address.address.state?.trim() || undefined,
+ postal_code: address.address.postal_code.trim(),
+ country: address.address.country.trim(),
+ },
+ billing_name: address.name.trim(),
tax_id:
- selectedTaxId && values.tax_id_type?.length && values.tax_id_value?.length
+ selectedTaxId && taxIdValues.tax_id_type?.length && taxIdValues.tax_id_value?.length
? {
- type: values.tax_id_type,
+ type: taxIdValues.tax_id_type,
value: sanitizeTaxIdValue({
- value: values.tax_id_value,
- name: form.getValues().tax_id_name,
+ value: taxIdValues.tax_id_value,
+ name: taxIdValues.tax_id_name,
}),
country: getEffectiveTaxCountry(selectedTaxId),
}
: null,
- })
+ }
+
+ await onCustomerDataChange(payload)
+
+ return {
+ status: 'success',
+ submittedState: { addressValue: address, taxIdValues },
+ }
+ }
+
+ const markCurrentValuesAsSaved = (
+ addressValue: StripeAddressValue,
+ taxIdValues: TaxIdFormValues
+ ) => {
+ savedStripeAddressRef.current = addressValue
+ savedTaxIdValuesRef.current = taxIdValues
+ syncCurrentState(addressValue, taxIdValues)
}
const handleReset = () => {
- if (initialCustomerData) {
- form.reset({
- billing_name: initialCustomerData.billing_name || '',
- line1: initialCustomerData.line1 || '',
- line2: initialCustomerData.line2 || '',
- city: initialCustomerData.city || '',
- state: initialCustomerData.state || '',
- postal_code: initialCustomerData.postal_code || '',
- country: initialCustomerData.country || '',
- tax_id_type: initialCustomerData?.tax_id_type || '',
- tax_id_value: initialCustomerData?.tax_id_value || '',
- tax_id_name: initialCustomerData?.tax_id_name || '',
- })
- } else {
- form.reset({
- line1: '',
- line2: '',
- city: '',
- state: '',
- postal_code: '',
- country: '',
- tax_id_type: '',
- tax_id_value: '',
- tax_id_name: '',
- })
- }
+ syncCurrentState(savedStripeAddressRef.current, savedTaxIdValuesRef.current)
+ setResetKey((c) => c + 1)
}
return {
form,
handleSubmit,
handleReset,
- isDirty: form.formState.isDirty,
+ isDirty,
+ resetKey,
+ onAddressChange,
+ applyAddressElementValue,
+ markCurrentValuesAsSaved,
+ addressCountry,
+ addressOptions,
}
}
+
+function isAddressEqual(current: StripeAddressValue, original: StripeAddressValue): boolean {
+ return (
+ normalize(current.name) === normalize(original.name) &&
+ normalize(current.address.line1) === normalize(original.address.line1) &&
+ normalize(current.address.line2) === normalize(original.address.line2) &&
+ normalize(current.address.city) === normalize(original.address.city) &&
+ normalize(current.address.state) === normalize(original.address.state) &&
+ normalize(current.address.postal_code) === normalize(original.address.postal_code) &&
+ normalize(current.address.country) === normalize(original.address.country)
+ )
+}
+
+function normalize(val: string | null | undefined): string {
+ return (val ?? '').trim()
+}
diff --git a/apps/studio/components/interfaces/Organization/BillingSettings/BillingEmail.tsx b/apps/studio/components/interfaces/Organization/BillingSettings/BillingEmail.tsx
index a273ab78d7e..f991b5d46cc 100644
--- a/apps/studio/components/interfaces/Organization/BillingSettings/BillingEmail.tsx
+++ b/apps/studio/components/interfaces/Organization/BillingSettings/BillingEmail.tsx
@@ -117,7 +117,7 @@ const BillingEmail = () => {
<form id={FORM_ID} onSubmit={form.handleSubmit(onUpdateOrganizationEmail)}>
<FormPanel
footer={
- <div className="flex py-4 px-card">
+ <div className="flex py-4 px-8">
<FormActions
form={FORM_ID}
isSubmitting={isUpdating}
@@ -133,7 +133,7 @@ const BillingEmail = () => {
</div>
}
>
- <FormSection>
+ <FormSection className="!px-8">
<FormSectionContent fullWidth loading={loadingBillingCustomer}>
<FormField
control={form.control}
diff --git a/apps/studio/fonts/stripe-fonts.ts b/apps/studio/fonts/stripe-fonts.ts
new file mode 100644
index 00000000000..4694b0d58c5
--- /dev/null
+++ b/apps/studio/fonts/stripe-fonts.ts
@@ -0,0 +1,2 @@
+export const CUSTOM_FONT_BOOK_DATA_URL =
+ 'data:font/woff2;base64,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'
diff --git a/apps/studio/public/fonts/CustomFont-Book.woff2 b/apps/studio/public/fonts/CustomFont-Book.woff2
new file mode 100644
index 00000000000..abd31f7ec27
Binary files /dev/null and b/apps/studio/public/fonts/CustomFont-Book.woff2 differ
diff --git a/apps/studio/tests/components/Billing/UpdateBillingAddressModal.test.tsx b/apps/studio/tests/components/Billing/UpdateBillingAddressModal.test.tsx
index 743e9829ff3..e63132af81c 100644
--- a/apps/studio/tests/components/Billing/UpdateBillingAddressModal.test.tsx
+++ b/apps/studio/tests/components/Billing/UpdateBillingAddressModal.test.tsx
@@ -1,17 +1,168 @@
+import type {
+ StripeAddressElement,
+ StripeAddressElementChangeEvent,
+ StripeAddressElementOptions,
+} from '@stripe/stripe-js'
+import { PermissionAction } from '@supabase/shared-types/out/constants'
import { screen, waitFor } from '@testing-library/react'
import userEvent from '@testing-library/user-event'
import { UpdateBillingAddressModal } from 'components/interfaces/App/UpdateBillingAddressModal'
+import { useEffect, type ReactNode } from 'react'
import { createMockOrganization, render } from 'tests/helpers'
import { beforeEach, describe, expect, it, vi } from 'vitest'
+type MockAddressElementProps = {
+ onChange?: (event: StripeAddressElementChangeEvent) => void
+ onReady?: (element: StripeAddressElement) => void
+ options?: StripeAddressElementOptions
+}
+
+const EMPTY_ADDRESS_VALUE: StripeAddressElementChangeEvent['value'] = {
+ name: '',
+ address: {
+ line1: '',
+ line2: '',
+ city: '',
+ state: '',
+ postal_code: '',
+ country: '',
+ },
+}
+
+let currentAddressValue: StripeAddressElementChangeEvent['value'] = EMPTY_ADDRESS_VALUE
+let currentAddressComplete = false
+
+const emitAddressEvent = (
+ props: MockAddressElementProps,
+ event: Pick<StripeAddressElementChangeEvent, 'complete' | 'value'>
+) => {
+ currentAddressValue = event.value
+ currentAddressComplete = event.complete
+ props.onChange?.({
+ elementType: 'address',
+ elementMode: 'billing',
+ empty: false,
+ isNewAddress: false,
+ ...event,
+ })
+}
+
+vi.mock('@stripe/react-stripe-js', () => ({
+ Elements: ({ children }: { children: ReactNode }) => <div>{children}</div>,
+ AddressElement: (props: MockAddressElementProps) => {
+ useEffect(() => {
+ props.onReady?.({
+ getValue: vi.fn(async () => ({
+ complete: currentAddressComplete,
+ isNewAddress: false,
+ value: currentAddressValue,
+ })),
+ } as unknown as StripeAddressElement)
+ }, [props])
+
+ return (
+ <div>
+ <div data-testid="stripe-address-element" />
+ <button
+ type="button"
+ onClick={() =>
+ emitAddressEvent(props, {
+ complete: true,
+ value: {
+ name: 'Updated Company',
+ address: {
+ line1: '500 Market St',
+ line2: '',
+ city: 'San Francisco',
+ state: 'CA',
+ postal_code: '94105',
+ country: 'US',
+ },
+ },
+ })
+ }
+ >
+ Emit valid US address
+ </button>
+ <button
+ type="button"
+ onClick={() =>
+ emitAddressEvent(props, {
+ complete: false,
+ value: {
+ name: 'Updated Company',
+ address: {
+ line1: '500 Market St',
+ line2: '',
+ city: 'San Francisco',
+ state: 'CA',
+ postal_code: '',
+ country: 'US',
+ },
+ },
+ })
+ }
+ >
+ Emit invalid address
+ </button>
+ <button
+ type="button"
+ onClick={() =>
+ emitAddressEvent(props, {
+ complete: true,
+ value: {
+ name: 'Updated GmbH',
+ address: {
+ line1: 'Stephansplatz 1',
+ line2: '',
+ city: 'Vienna',
+ state: 'Vienna',
+ postal_code: '1010',
+ country: 'AT',
+ },
+ },
+ })
+ }
+ >
+ Emit valid AT address
+ </button>
+ <button
+ type="button"
+ onClick={() => {
+ currentAddressValue = {
+ name: 'Updated Company',
+ address: {
+ line1: '500 Market St',
+ line2: '',
+ city: '',
+ state: 'CA',
+ postal_code: '94105',
+ country: 'US',
+ },
+ }
+ currentAddressComplete = false
+ }}
+ >
+ Make submit validation fail
+ </button>
+ </div>
+ )
+ },
+ useElements: () => null,
+ useStripe: () => null,
+}))
+vi.mock('@stripe/stripe-js', () => ({
+ loadStripe: vi.fn(() => Promise.resolve(null)),
+}))
+
vi.mock('lib/constants', async (importOriginal) => {
- const original = (await importOriginal()) as any
+ const original = (await importOriginal()) as typeof import('lib/constants')
return { ...original, IS_PLATFORM: true }
})
const mockFlag = vi.fn(() => true)
vi.mock('common', async (importOriginal) => {
- const original = (await importOriginal()) as any
+ const original = (await importOriginal()) as typeof import('common')
return {
...original,
useFlag: (_name: string) => mockFlag(),
@@ -19,7 +170,7 @@ vi.mock('common', async (importOriginal) => {
}
})
-const mockOrg = vi.fn(() =>
+const mockOrg = vi.fn<() => ReturnType<typeof createMockOrganization> | undefined>(() =>
createMockOrganization({
slug: 'test-org',
organization_missing_address: true,
@@ -30,13 +181,21 @@ vi.mock('hooks/misc/useSelectedOrganization', () => ({
useSelectedOrganizationQuery: () => ({ data: mockOrg() }),
}))
+const mockCanRead = vi.fn(() => true)
const mockCanWrite = vi.fn(() => true)
-const mockPermissionsLoaded = vi.fn(() => true)
+const mockBillingReadLoaded = vi.fn(() => true)
+const mockBillingWriteLoaded = vi.fn(() => true)
vi.mock('hooks/misc/useCheckPermissions', () => ({
- useAsyncCheckPermissions: () => ({
- can: mockCanWrite(),
- isSuccess: mockPermissionsLoaded(),
- }),
+ useAsyncCheckPermissions: (action: PermissionAction) =>
+ action === PermissionAction.BILLING_READ
+ ? {
+ can: mockCanRead(),
+ isSuccess: mockBillingReadLoaded(),
+ }
+ : {
+ can: mockCanWrite(),
+ isSuccess: mockBillingWriteLoaded(),
+ },
}))
const mockCustomerProfile = vi.fn(() => ({
@@ -85,6 +244,8 @@ vi.mock('data/organizations/organizations-query', () => ({
describe('UpdateBillingAddressModal', () => {
beforeEach(() => {
vi.clearAllMocks()
+ currentAddressValue = EMPTY_ADDRESS_VALUE
+ currentAddressComplete = false
mockFlag.mockReturnValue(true)
mockOrg.mockReturnValue(
createMockOrganization({
@@ -94,8 +255,10 @@ describe('UpdateBillingAddressModal', () => {
plan: { id: 'pro', name: 'Pro' },
})
)
+ mockCanRead.mockReturnValue(true)
mockCanWrite.mockReturnValue(true)
- mockPermissionsLoaded.mockReturnValue(true)
+ mockBillingReadLoaded.mockReturnValue(true)
+ mockBillingWriteLoaded.mockReturnValue(true)
mockProfileLoaded.mockReturnValue(true)
mockTaxIdLoaded.mockReturnValue(true)
mockCustomerProfile.mockReturnValue({
@@ -146,14 +309,27 @@ describe('UpdateBillingAddressModal', () => {
expect(screen.queryByText('Billing address required')).not.toBeInTheDocument()
})
- it('does not render when user lacks billing write permission', () => {
+ it('renders an informational modal when user has read access but no write access', async () => {
+ mockCanRead.mockReturnValue(true)
+ mockCanWrite.mockReturnValue(false)
+ render(<UpdateBillingAddressModal />)
+
+ expect(await screen.findByText('Billing address required')).toBeInTheDocument()
+ expect(
+ screen.getByText(/please ask an organization administrator or owner/i)
+ ).toBeInTheDocument()
+ expect(screen.queryByRole('button', { name: 'Save address' })).not.toBeInTheDocument()
+ })
+
+ it('does not render when user lacks both billing read and write permission', () => {
+ mockCanRead.mockReturnValue(false)
mockCanWrite.mockReturnValue(false)
render(<UpdateBillingAddressModal />)
expect(screen.queryByText('Billing address required')).not.toBeInTheDocument()
})
it('does not render when no org is selected', () => {
- mockOrg.mockReturnValue(undefined as any)
+ mockOrg.mockReturnValue(undefined)
render(<UpdateBillingAddressModal />)
expect(screen.queryByText('Billing address required')).not.toBeInTheDocument()
})
@@ -175,4 +351,58 @@ describe('UpdateBillingAddressModal', () => {
render(<UpdateBillingAddressModal />)
expect(screen.queryByText('Save address')).not.toBeInTheDocument()
})
+ it('dismisses on close button click', async () => {
+ mockCanRead.mockReturnValue(true)
+ mockCanWrite.mockReturnValue(false)
+ render(<UpdateBillingAddressModal />)
+ expect(await screen.findByText('Billing address required')).toBeInTheDocument()
+
+ const closeButton = screen.getByRole('button', { name: /close/i })
+ await userEvent.click(closeButton)
+
+ await waitFor(() => {
+ expect(screen.queryByText('Billing address required')).not.toBeInTheDocument()
+ })
+ })
+
+ it('enables submit after the address element reports a valid change', async () => {
+ render(<UpdateBillingAddressModal />)
+
+ expect(await screen.findByText('Billing address required')).toBeInTheDocument()
+
+ expect(screen.getByRole('button', { name: 'Save address' })).toBeDisabled()
+
+ await userEvent.click(screen.getByRole('button', { name: 'Emit valid US address' }))
+
+ await waitFor(() => expect(screen.getByRole('button', { name: 'Save address' })).toBeEnabled())
+ })
+
+ it('filters tax ID options using the current address country', async () => {
+ render(<UpdateBillingAddressModal />)
+
+ expect(await screen.findByText('Billing address required')).toBeInTheDocument()
+
+ await userEvent.click(screen.getByRole('button', { name: 'Emit valid AT address' }))
+ await userEvent.click(screen.getByRole('combobox'))
+
+ expect(await screen.findByText('Austria - AT VAT')).toBeInTheDocument()
+ expect(screen.queryByText('United States - US EIN')).not.toBeInTheDocument()
+ })
+
+ it('uses getValue on submit to block saving when Stripe validation becomes incomplete', async () => {
+ render(<UpdateBillingAddressModal />)
+
+ expect(await screen.findByText('Billing address required')).toBeInTheDocument()
+
+ await userEvent.click(screen.getByRole('button', { name: 'Emit valid US address' }))
+ await waitFor(() => expect(screen.getByRole('button', { name: 'Save address' })).toBeEnabled())
+
+ await userEvent.click(screen.getByRole('button', { name: 'Make submit validation fail' }))
+ await userEvent.click(screen.getByRole('button', { name: 'Save address' }))
+
+ await waitFor(() => {
+ expect(mockUpdateCustomerProfile).not.toHaveBeenCalled()
+ expect(mockUpdateTaxId).not.toHaveBeenCalled()
+ })
+ })
})
diff --git a/apps/studio/tests/components/Billing/useBillingCustomerDataForm.test.tsx b/apps/studio/tests/components/Billing/useBillingCustomerDataForm.test.tsx
new file mode 100644
index 00000000000..b8678359b4d
--- /dev/null
+++ b/apps/studio/tests/components/Billing/useBillingCustomerDataForm.test.tsx
@@ -0,0 +1,581 @@
+import { act, renderHook, waitFor } from '@testing-library/react'
+import type { StripeAddressElementChangeEvent } from '@stripe/stripe-js'
+import { describe, expect, it, vi } from 'vitest'
+
+import { useBillingCustomerDataForm } from 'components/interfaces/Organization/BillingSettings/BillingCustomerData/useBillingCustomerDataForm'
+import type { CustomerAddress, CustomerTaxId } from 'data/organizations/types'
+
+type BillingProfile = ReturnType<typeof makeCustomerProfile>
+type CustomerChangeHandler = Parameters<
+ typeof useBillingCustomerDataForm
+>[0]['onCustomerDataChange']
+
+type HookPropsWithTaxId = {
+ customerProfile: BillingProfile
+ taxId: CustomerTaxId | null
+ onCustomerDataChange: CustomerChangeHandler
+}
+
+type HookPropsWithExistingTaxId = {
+ customerProfile: BillingProfile
+ taxId: CustomerTaxId
+ onCustomerDataChange: CustomerChangeHandler
+}
+
+type HookPropsWithoutTaxId = {
+ customerProfile: BillingProfile
+ onCustomerDataChange: CustomerChangeHandler
+}
+
+type HookPropsHydrated = {
+ customerProfile: BillingProfile | null | undefined
+ onCustomerDataChange: CustomerChangeHandler
+}
+
+const makeCustomerProfile = (
+ overrides?: Partial<{ address: CustomerAddress; billing_name: string }>
+) => ({
+ billing_name: 'Acme Inc',
+ address: {
+ line1: '123 Main St',
+ line2: 'Suite 100',
+ city: 'New York',
+ state: 'NY',
+ postal_code: '10001',
+ country: 'US',
+ },
+ ...overrides,
+})
+
+const makeTaxId = (overrides?: Partial<CustomerTaxId>): CustomerTaxId => ({
+ type: 'us_ein',
+ value: '12-3456789',
+ country: 'US',
+ ...overrides,
+})
+
+const makeAddressChangeEvent = (
+ overrides?: Partial<{
+ name: string
+ address: Partial<CustomerAddress>
+ complete: boolean
+ }>
+): StripeAddressElementChangeEvent => ({
+ complete: overrides?.complete ?? true,
+ elementType: 'address',
+ elementMode: 'billing',
+ empty: false,
+ isNewAddress: false,
+ value: {
+ address: {
+ city: overrides?.address?.city ?? 'San Francisco',
+ country: overrides?.address?.country ?? 'US',
+ line1: overrides?.address?.line1 ?? '500 Market St',
+ line2: overrides?.address?.line2 ?? '',
+ postal_code: overrides?.address?.postal_code ?? '94105',
+ state: overrides?.address?.state ?? 'CA',
+ },
+ name: overrides?.name ?? 'Updated Company',
+ },
+})
+
+const submitHook = async <TResult,>(submit: () => Promise<TResult>) => {
+ let result: TResult | undefined
+ await act(async () => {
+ result = await submit()
+ })
+ return result as TResult
+}
+
+describe('useBillingCustomerDataForm', () => {
+ it('initializes tax ID fields and address country from the provided profile', () => {
+ const customerProfile = makeCustomerProfile({
+ address: {
+ line1: '1 Infinite Loop',
+ line2: '',
+ city: 'Cupertino',
+ state: 'CA',
+ postal_code: '95014',
+ country: 'US',
+ },
+ })
+ const taxId = makeTaxId()
+
+ const { result } = renderHook(
+ ({ customerProfile, taxId, onCustomerDataChange }: HookPropsWithTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, taxId, onCustomerDataChange: vi.fn() },
+ }
+ )
+
+ expect(result.current.addressCountry).toBe('US')
+ expect(result.current.form.getValues()).toEqual({
+ tax_id_name: 'US EIN',
+ tax_id_type: 'us_ein',
+ tax_id_value: '12-3456789',
+ })
+ expect(result.current.isDirty).toBe(false)
+ })
+
+ it('returns validation errors when the seeded address is incomplete', async () => {
+ const customerProfile = makeCustomerProfile({
+ billing_name: '',
+ address: {
+ line1: '',
+ line2: '',
+ city: '',
+ state: '',
+ postal_code: '',
+ country: '',
+ },
+ })
+
+ const { result } = renderHook(
+ ({ customerProfile, onCustomerDataChange }: HookPropsWithoutTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId: null,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, onCustomerDataChange: vi.fn() },
+ }
+ )
+
+ await expect(submitHook(result.current.handleSubmit)).resolves.toEqual({
+ status: 'error',
+ message: 'Full name is required.',
+ })
+ })
+
+ it('blocks submit when Stripe marks the address element as incomplete', async () => {
+ const onCustomerDataChange = vi.fn()
+ const customerProfile = makeCustomerProfile()
+
+ const { result } = renderHook(
+ ({ customerProfile, onCustomerDataChange }: HookPropsWithoutTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId: null,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, onCustomerDataChange },
+ }
+ )
+
+ act(() => {
+ result.current.onAddressChange(
+ makeAddressChangeEvent({
+ complete: false,
+ address: { postal_code: 'ABCDE' },
+ })
+ )
+ })
+
+ await expect(submitHook(result.current.handleSubmit)).resolves.toEqual({
+ status: 'error',
+ message: 'Please enter a valid billing address.',
+ })
+ expect(onCustomerDataChange).not.toHaveBeenCalled()
+ })
+
+ it('submits the seeded address for tax-id-only updates', async () => {
+ const onCustomerDataChange = vi.fn()
+ const customerProfile = makeCustomerProfile()
+
+ const { result } = renderHook(
+ ({ customerProfile, onCustomerDataChange }: HookPropsWithoutTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId: null,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, onCustomerDataChange },
+ }
+ )
+
+ act(() => {
+ result.current.form.setValue('tax_id_name', 'US EIN', { shouldDirty: true })
+ result.current.form.setValue('tax_id_type', 'us_ein', { shouldDirty: true })
+ result.current.form.setValue('tax_id_value', '12-3456789', { shouldDirty: true })
+ })
+
+ await waitFor(() => expect(result.current.isDirty).toBe(true))
+ const submitResult = await submitHook(result.current.handleSubmit)
+ expect(submitResult.status).toBe('success')
+ if (submitResult.status !== 'success') {
+ throw new Error('Expected successful submit result')
+ }
+ act(() => {
+ result.current.markCurrentValuesAsSaved(
+ submitResult.submittedState.addressValue,
+ submitResult.submittedState.taxIdValues
+ )
+ })
+
+ expect(onCustomerDataChange).toHaveBeenCalledWith({
+ address: customerProfile.address,
+ billing_name: 'Acme Inc',
+ tax_id: {
+ type: 'us_ein',
+ value: '12-3456789',
+ country: 'US',
+ },
+ })
+ expect(result.current.isDirty).toBe(false)
+ })
+
+ it('submits tax_id as null after an existing tax ID is removed', async () => {
+ const onCustomerDataChange = vi.fn()
+ const customerProfile = makeCustomerProfile()
+ const taxId = makeTaxId()
+
+ const { result } = renderHook(
+ ({ customerProfile, taxId, onCustomerDataChange }: HookPropsWithTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, taxId, onCustomerDataChange },
+ }
+ )
+
+ act(() => {
+ result.current.form.setValue('tax_id_name', '', { shouldDirty: true })
+ result.current.form.setValue('tax_id_type', '', { shouldDirty: true })
+ result.current.form.setValue('tax_id_value', '', { shouldDirty: true })
+ })
+
+ await waitFor(() => expect(result.current.isDirty).toBe(true))
+ const submitResult = await submitHook(result.current.handleSubmit)
+ expect(submitResult).toEqual({
+ status: 'success',
+ submittedState: {
+ addressValue: {
+ name: 'Acme Inc',
+ address: customerProfile.address,
+ },
+ taxIdValues: {
+ tax_id_name: '',
+ tax_id_type: '',
+ tax_id_value: '',
+ },
+ },
+ })
+
+ expect(onCustomerDataChange).toHaveBeenCalledWith({
+ address: customerProfile.address,
+ billing_name: 'Acme Inc',
+ tax_id: null,
+ })
+ })
+
+ it('keeps a removed tax ID cleared after an intermediate rerender during save', async () => {
+ const customerProfile = makeCustomerProfile()
+ const taxId = makeTaxId()
+ let rerenderHook: ((props: HookPropsWithExistingTaxId) => void) | undefined
+
+ const onCustomerDataChange: CustomerChangeHandler = vi.fn(async () => {
+ rerenderHook?.({
+ customerProfile: makeCustomerProfile({
+ address: {
+ ...customerProfile.address,
+ line1: '500 Market St',
+ },
+ }),
+ taxId,
+ onCustomerDataChange,
+ })
+ await Promise.resolve()
+ })
+
+ const { result, rerender } = renderHook(
+ ({ customerProfile, taxId, onCustomerDataChange }: HookPropsWithTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, taxId, onCustomerDataChange },
+ }
+ )
+
+ rerenderHook = rerender
+
+ act(() => {
+ result.current.form.setValue('tax_id_name', '', { shouldDirty: true })
+ result.current.form.setValue('tax_id_type', '', { shouldDirty: true })
+ result.current.form.setValue('tax_id_value', '', { shouldDirty: true })
+ })
+
+ const submitResult = await submitHook(result.current.handleSubmit)
+ expect(submitResult.status).toBe('success')
+ if (submitResult.status !== 'success') {
+ throw new Error('Expected successful submit result')
+ }
+
+ act(() => {
+ result.current.markCurrentValuesAsSaved(
+ submitResult.submittedState.addressValue,
+ submitResult.submittedState.taxIdValues
+ )
+ })
+
+ expect(result.current.form.getValues()).toEqual({
+ tax_id_name: '',
+ tax_id_type: '',
+ tax_id_value: '',
+ })
+ })
+
+ it('uses the latest address element value when building the submit payload', async () => {
+ const onCustomerDataChange = vi.fn()
+ const customerProfile = makeCustomerProfile()
+ const taxId = makeTaxId({ type: 'eu_vat', value: '12345678', country: 'AT' })
+
+ const { result } = renderHook(
+ ({ customerProfile, taxId, onCustomerDataChange }: HookPropsWithTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, taxId, onCustomerDataChange },
+ }
+ )
+
+ act(() => {
+ result.current.onAddressChange(
+ makeAddressChangeEvent({
+ name: 'Updated GmbH',
+ address: { country: 'AT', city: 'Vienna', postal_code: '1010' },
+ })
+ )
+ result.current.form.setValue('tax_id_name', 'AT VAT', { shouldDirty: true })
+ result.current.form.setValue('tax_id_type', 'eu_vat', { shouldDirty: true })
+ result.current.form.setValue('tax_id_value', '12345678', { shouldDirty: true })
+ })
+
+ await waitFor(() => expect(result.current.addressCountry).toBe('AT'))
+ const submitResult = await submitHook(result.current.handleSubmit)
+ expect(submitResult).toEqual({
+ status: 'success',
+ submittedState: {
+ addressValue: {
+ name: 'Updated GmbH',
+ address: {
+ line1: '500 Market St',
+ line2: '',
+ city: 'Vienna',
+ state: 'CA',
+ postal_code: '1010',
+ country: 'AT',
+ },
+ },
+ taxIdValues: {
+ tax_id_name: 'AT VAT',
+ tax_id_type: 'eu_vat',
+ tax_id_value: '12345678',
+ },
+ },
+ })
+
+ expect(onCustomerDataChange).toHaveBeenCalledWith({
+ address: {
+ line1: '500 Market St',
+ line2: undefined,
+ city: 'Vienna',
+ state: 'CA',
+ postal_code: '1010',
+ country: 'AT',
+ },
+ billing_name: 'Updated GmbH',
+ tax_id: {
+ type: 'eu_vat',
+ value: 'ATU12345678',
+ country: 'AT',
+ },
+ })
+ })
+
+ it('submits an updated address without changing a missing tax ID', async () => {
+ const onCustomerDataChange = vi.fn()
+ const customerProfile = makeCustomerProfile()
+
+ const { result } = renderHook(
+ ({ customerProfile, onCustomerDataChange }: HookPropsWithoutTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId: null,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, onCustomerDataChange },
+ }
+ )
+
+ act(() => {
+ result.current.onAddressChange(
+ makeAddressChangeEvent({
+ name: 'Updated Company',
+ address: { city: 'Los Angeles', state: 'CA', postal_code: '90001' },
+ })
+ )
+ })
+
+ expect(result.current.isDirty).toBe(true)
+ const submitResult = await submitHook(result.current.handleSubmit)
+ expect(submitResult).toEqual({
+ status: 'success',
+ submittedState: {
+ addressValue: {
+ name: 'Updated Company',
+ address: {
+ line1: '500 Market St',
+ line2: '',
+ city: 'Los Angeles',
+ state: 'CA',
+ postal_code: '90001',
+ country: 'US',
+ },
+ },
+ taxIdValues: {
+ tax_id_name: '',
+ tax_id_type: '',
+ tax_id_value: '',
+ },
+ },
+ })
+
+ expect(onCustomerDataChange).toHaveBeenCalledWith({
+ address: {
+ line1: '500 Market St',
+ line2: undefined,
+ city: 'Los Angeles',
+ state: 'CA',
+ postal_code: '90001',
+ country: 'US',
+ },
+ billing_name: 'Updated Company',
+ tax_id: null,
+ })
+ })
+
+ it('resets dirty state and restores the initial address payload', async () => {
+ const onCustomerDataChange = vi.fn()
+ const customerProfile = makeCustomerProfile()
+
+ const { result } = renderHook(
+ ({ customerProfile, onCustomerDataChange }: HookPropsWithoutTaxId) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId: null,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps: { customerProfile, onCustomerDataChange },
+ }
+ )
+
+ act(() => {
+ result.current.onAddressChange(
+ makeAddressChangeEvent({
+ address: { city: 'Los Angeles', state: 'CA', postal_code: '90001' },
+ })
+ )
+ result.current.form.setValue('tax_id_name', 'US EIN', { shouldDirty: true })
+ result.current.form.setValue('tax_id_type', 'us_ein', { shouldDirty: true })
+ result.current.form.setValue('tax_id_value', '12-3456789', { shouldDirty: true })
+ })
+
+ await waitFor(() => expect(result.current.isDirty).toBe(true))
+
+ act(() => {
+ result.current.handleReset()
+ })
+
+ expect(result.current.isDirty).toBe(false)
+ expect(result.current.addressCountry).toBe('US')
+
+ act(() => {
+ result.current.form.setValue('tax_id_name', 'US EIN', { shouldDirty: true })
+ result.current.form.setValue('tax_id_type', 'us_ein', { shouldDirty: true })
+ result.current.form.setValue('tax_id_value', '12-3456789', { shouldDirty: true })
+ })
+
+ const submitResult = await submitHook(result.current.handleSubmit)
+ expect(submitResult).toEqual({
+ status: 'success',
+ submittedState: {
+ addressValue: {
+ name: 'Acme Inc',
+ address: customerProfile.address,
+ },
+ taxIdValues: {
+ tax_id_name: 'US EIN',
+ tax_id_type: 'us_ein',
+ tax_id_value: '12-3456789',
+ },
+ },
+ })
+
+ expect(onCustomerDataChange).toHaveBeenLastCalledWith({
+ address: customerProfile.address,
+ billing_name: 'Acme Inc',
+ tax_id: {
+ type: 'us_ein',
+ value: '12-3456789',
+ country: 'US',
+ },
+ })
+ })
+
+ it('syncs addressCountry when the customer profile loads after mount', async () => {
+ const onCustomerDataChange = vi.fn<CustomerChangeHandler>()
+ const initialProps: HookPropsHydrated = {
+ customerProfile: undefined,
+ onCustomerDataChange,
+ }
+
+ const { result, rerender } = renderHook(
+ ({ customerProfile, onCustomerDataChange }: HookPropsHydrated) =>
+ useBillingCustomerDataForm({
+ customerProfile,
+ taxId: null,
+ onCustomerDataChange,
+ }),
+ {
+ initialProps,
+ }
+ )
+
+ expect(result.current.addressCountry).toBeUndefined()
+
+ rerender({
+ onCustomerDataChange,
+ customerProfile: makeCustomerProfile({
+ address: {
+ line1: 'Schonhauser Allee 1',
+ line2: '',
+ city: 'Berlin',
+ state: 'BE',
+ postal_code: '10119',
+ country: 'DE',
+ },
+ }),
+ })
+
+ await waitFor(() => expect(result.current.addressCountry).toBe('DE'))
+ })
+})