@greatapps/common 1.1.739 → 1.1.741

package/dist/modules/accounts/utils/billing-data.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/modules/accounts/utils/billing-data.ts"],"sourcesContent":["import type { Account } from '../types';\n\n/**\n * Gateway das contas cobradas em USD. Elas não têm CPF/CNPJ, bairro nem número —\n * mesmo critério usado no AddCardModal (`account.gateway === 'stripe_usd'`).\n */\nexport const INTERNATIONAL_GATEWAY = 'stripe_usd';\n\nexport type BillingDataSnapshot = Pick<\n  Account,\n  | 'gateway'\n  | 'financial_document'\n  | 'financial_name'\n  | 'financial_email'\n  | 'zipcode'\n  | 'address'\n  | 'address_number'\n  | 'neighborhood'\n  | 'city'\n  | 'state'\n  | 'country'\n>;\n\ntype BillingField = keyof Omit<BillingDataSnapshot, 'gateway'>;\n\n/**\n * Campos exigidos em qualquer país — sem eles a nota fiscal não sai.\n *\n * `financial_email` NÃO entra: o backend cai no e-mail do usuário quando ele está\n * vazio (`financial_email || userDocument.email`, accounts/services.js), então a\n * nota sai do mesmo jeito. Exigi-lo aqui bloquearia 4.7k contas pagantes da wl 1\n * em vez das ~460 que de fato estão sem cadastro fiscal. O campo continua no\n * formulário, pré-preenchido — só não é critério de bloqueio.\n */\nconst INTERNATIONAL_BILLING_FIELDS: readonly BillingField[] = [\n  'financial_name',\n  'zipcode',\n  'address',\n  'city',\n  'state',\n  'country',\n];\n\n/** No Brasil a NF-e também exige documento fiscal, número e bairro. */\nconst BR_BILLING_FIELDS: readonly BillingField[] = [\n  ...INTERNATIONAL_BILLING_FIELDS,\n  'financial_document',\n  'address_number',\n  'neighborhood',\n];\n\nexport function isInternationalAccount(\n  account: Pick<BillingDataSnapshot, 'gateway'> | null | undefined,\n): boolean {\n  return account?.gateway === INTERNATIONAL_GATEWAY;\n}\n\nfunction isFilled(value: string | null | undefined): boolean {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\n/**\n * A conta tem todos os dados de cobrança/fiscais necessários pra emissão de nota.\n * Retorna `false` quando a conta ainda não carregou — quem decide bloquear é o\n * chamador, que checa o loading antes (ver `useRequiredBillingData`).\n */\nexport function hasCompleteBillingData(\n  account: BillingDataSnapshot | null | undefined,\n): boolean {\n  if (!account) return false;\n\n  const fields = isInternationalAccount(account)\n    ? INTERNATIONAL_BILLING_FIELDS\n    : BR_BILLING_FIELDS;\n\n  for (const field of fields) {\n    if (!isFilled(account[field])) return false;\n  }\n\n  return true;\n}\n"],"mappings":"AAMO,MAAM,wBAAwB;AA4BrC,MAAM,+BAAwD;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,MAAM,oBAA6C;AAAA,EACjD,GAAG;AAAA,EACH;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,uBACd,SACS;AACT,SAAO,SAAS,YAAY;AAC9B;AAEA,SAAS,SAAS,OAA2C;AAC3D,SAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS;AAC5D;AAOO,SAAS,uBACd,SACS;AACT,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,SAAS,uBAAuB,OAAO,IACzC,+BACA;AAEJ,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,SAAS,QAAQ,KAAK,CAAC,EAAG,QAAO;AAAA,EACxC;AAEA,SAAO;AACT;","names":[]}

package/dist/modules/subscriptions/utils/has-paid-subscription.mjs

@@ -0,0 +1,13 @@
+const FREE_PLAN_ID = 5;
+function hasPaidSubscription(subscription) {
+  if (!subscription) return false;
+  if (subscription.type === "free" || subscription.id_plan === FREE_PLAN_ID) {
+    return false;
+  }
+  if (subscription.type === "trial") return false;
+  return subscription.charged === true;
+}
+export {
+  hasPaidSubscription
+};
+//# sourceMappingURL=has-paid-subscription.mjs.map

package/dist/modules/subscriptions/utils/has-paid-subscription.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/modules/subscriptions/utils/has-paid-subscription.ts"],"sourcesContent":["import type { Subscription } from '../types/subscription.type';\n\nconst FREE_PLAN_ID = 5;\n\ntype PaidSubscriptionSnapshot = Pick<Subscription, 'type' | 'id_plan' | 'charged'>;\n\n/**\n * A conta já teve pagamento confirmado numa assinatura paga.\n *\n * Diferente de `hasActivePaidSubscription`, aqui NÃO importa se a assinatura\n * segue vigente: quem pagou e depois cancelou/atrasou continua precisando de\n * nota fiscal do que já foi cobrado. Por isso o sinal é `charged` (marcado pelo\n * backend no `bill_paid`), e não `active`/`date_due`.\n *\n * Free e trial ficam de fora — nunca houve cobrança a documentar.\n */\nexport function hasPaidSubscription(\n  subscription: PaidSubscriptionSnapshot | undefined | null,\n): boolean {\n  if (!subscription) return false;\n  if (subscription.type === 'free' || subscription.id_plan === FREE_PLAN_ID) {\n    return false;\n  }\n  if (subscription.type === 'trial') return false;\n\n  return subscription.charged === true;\n}\n"],"mappings":"AAEA,MAAM,eAAe;AAcd,SAAS,oBACd,cACS;AACT,MAAI,CAAC,aAAc,QAAO;AAC1B,MAAI,aAAa,SAAS,UAAU,aAAa,YAAY,cAAc;AACzE,WAAO;AAAA,EACT;AACA,MAAI,aAAa,SAAS,QAAS,QAAO;AAE1C,SAAO,aAAa,YAAY;AAClC;","names":[]}

package/dist/server.mjs

@@ -47,6 +47,7 @@ import {
   updateUserAction,
   updateAccountAction,
   updateAccountUserByIdAction,
+  updateBillingDataAction,
   deleteAccountUserAction,
   deleteAccountAction,
   createAccountUserAction,
@@ -135,6 +136,7 @@ export {
   unlinkGoogleAction,
   updateAccountAction,
   updateAccountUserByIdAction,
+  updateBillingDataAction,
   updateProjectAction,
   updateSubscriptionPaymentAction,
   updateSubscriptionPlanAction,

package/dist/server.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import 'server-only';\r\n\r\n// API Client\r\nexport { ApiClient, api, apiClient } from './infra/api/client';\r\n\r\n// Services\r\nexport { authService } from './modules/auth/services/auth.service';\r\nexport { whitelabelService } from './modules/whitelabel/services/whitelabel.service';\r\nexport { revalidateWhitelabelAction } from './modules/whitelabel/actions/revalidate-whitelabel.action';\r\nexport { assertManagementPermission } from './modules/auth/utils/assert-management-permission';\r\nexport { assertManagementSubscription } from './modules/auth/utils/assert-management-subscription';\r\nexport { assertSubscriptionAddon } from './modules/auth/utils/assert-subscription-addon';\r\nexport { assertPaidSubscription } from './modules/auth/utils/assert-paid-subscription';\r\nexport { subscriptionsService } from './modules/subscriptions/services/subscriptions.service';\r\nexport { plansService } from './modules/plans/services/plans.service';\r\nexport { cardsService } from './modules/cards/services/cards.service';\r\nexport { chargesService } from './modules/charges/services/charges.service';\r\nexport { iaCreditsService } from './modules/ia-credits/services/ia-credits.service';\r\n\r\n// Actions\r\nexport { findWhitelabel } from './modules/whitelabel/actions/find-whitelabel.action';\r\nexport { validateSessionAction } from './modules/auth/actions/validate-session.action';\r\nexport { socialGoogleLoginAction } from './modules/auth/actions/social-google-login.action';\r\nexport { socialGoogleOnboardingAction } from './modules/auth/actions/social-google-onboarding.action';\r\nexport { unlinkGoogleAction } from './modules/auth/actions/unlink-google.action';\r\nexport { findUserById } from './modules/users/action/find-user-by-id.action';\r\nexport { findCurrentAccount } from './modules/accounts/actions/find-current-account.action';\r\nexport { getAccountTokenAction } from './modules/accounts/actions/get-account-token.action';\r\nexport { listSubscriptionsAction } from './modules/subscriptions/actions/list-subscriptions.action';\r\nexport { calculateSubscriptionAction } from './modules/subscriptions/actions/calculate-subscription.action';\r\nexport { updateSubscriptionPlanAction } from './modules/subscriptions/actions/update-subscription-plan.action';\r\nexport { updateSubscriptionPaymentAction } from './modules/subscriptions/actions/update-subscription-payment.action';\r\nexport { createCardAction } from './modules/cards/actions/create-card.action';\r\nexport { createSetupIntentAction } from './modules/cards/actions/create-setup-intent.action';\r\nexport { chargeActionAction } from './modules/charges/actions/charge-action.action';\r\nexport { resolvePlanExtrasPrices } from './modules/subscriptions/utils/resolve-plan-extras-prices';\r\nexport { hasSubscriptionExpired } from './modules/subscriptions/utils/has-subscription-expired';\r\nexport { hasActivePaidSubscription } from './modules/subscriptions/utils/has-active-paid-subscription';\r\n\r\n// Project Services & Actions (server-only)\r\nexport { projectsService } from './modules/projects/services/projects.service';\r\nexport { listProjectsAction } from './modules/projects/actions/list-projects.action';\r\nexport { findProjectAction } from './modules/projects/actions/find-project.action';\r\nexport { createProjectAction } from './modules/projects/actions/create-project.action';\r\nexport { updateProjectAction } from './modules/projects/actions/update-project.action';\r\nexport { deleteProjectAction } from './modules/projects/actions/delete-project.action';\r\n\r\n// Project Users Services & Actions (server-only)\r\nexport { projectUsersService } from './modules/projects/services/project-users.service';\r\nexport { listProjectUsersAction } from './modules/projects/actions/list-project-users.action';\r\nexport { addProjectUserAction } from './modules/projects/actions/add-project-user.action';\r\nexport { removeProjectUserAction } from './modules/projects/actions/remove-project-user.action';\r\n\r\n// Account Services & Actions (server-only)\r\nexport { accountService } from './modules/accounts/services/account.service';\r\nexport { twoFactorService } from './modules/accounts/services/two-factor.service';\r\nexport {\r\n  listAccountUsersAction,\r\n  updateUserAction,\r\n  updateAccountAction,\r\n  updateAccountUserByIdAction,\r\n  deleteAccountUserAction,\r\n  deleteAccountAction,\r\n  createAccountUserAction,\r\n  changePasswordAction,\r\n  requestEmailChangeAction,\r\n  confirmEmailChangeAction,\r\n  requestPhoneChangeAction,\r\n  confirmPhoneChangeAction,\r\n  generateTwoFactorAction,\r\n  confirmTwoFactorAction,\r\n  disableTwoFactorAction,\r\n} from './modules/accounts/actions/account-management.action';\r\n\r\n// Server Utils\r\nexport { getClientInfoFromRequest } from './infra/utils/client-info';\r\nexport { getUserContext } from './modules/auth/utils/get-user-context';\r\nexport { resolveLocale } from './i18n/resolve-locale';\r\nexport type { ResolveLocaleOptions } from './i18n/resolve-locale';\r\nexport { requireValidSession } from './modules/auth/utils/require-valid-session';\r\nexport { requireTokenNotExpired } from './modules/auth/utils/require-token-not-expired';\r\nexport { buildWlOverride, buildWlOverrideFromJwt } from './modules/auth/utils/build-wl-override';\r\nexport { safeServerAction } from './utils/safeServerAction';\r\nexport { safeMutationAction } from './utils/safeMutationAction';\r\n\r\n// Image Processing (server-side)\r\nexport { processImageAction } from './modules/images/actions/process-image.action';\r\nexport { processImage } from './modules/images/services/image-processing.service';\r\nexport type {\r\n  ProcessImageInput,\r\n  ProcessImageOutput,\r\n  ProcessImageActionInput,\r\n  ProcessImageActionOutput,\r\n} from './modules/images/types/image.type';\r\n"],"mappings":"AAAA,OAAO;AAGP,SAAS,WAAW,KAAK,iBAAiB;AAG1C,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAClC,SAAS,kCAAkC;AAC3C,SAAS,kCAAkC;AAC3C,SAAS,oCAAoC;AAC7C,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AACvC,SAAS,4BAA4B;AACrC,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AAGjC,SAAS,sBAAsB;AAC/B,SAAS,6BAA6B;AACtC,SAAS,+BAA+B;AACxC,SAAS,oCAAoC;AAC7C,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,+BAA+B;AACxC,SAAS,mCAAmC;AAC5C,SAAS,oCAAoC;AAC7C,SAAS,uCAAuC;AAChD,SAAS,wBAAwB;AACjC,SAAS,+BAA+B;AACxC,SAAS,0BAA0B;AACnC,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AACvC,SAAS,iCAAiC;AAG1C,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,2BAA2B;AACpC,SAAS,2BAA2B;AAGpC,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,4BAA4B;AACrC,SAAS,+BAA+B;AAGxC,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,gCAAgC;AACzC,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAE9B,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,iBAAiB,8BAA8B;AACxD,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AAGnC,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;","names":[]}
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import 'server-only';\r\n\r\n// API Client\r\nexport { ApiClient, api, apiClient } from './infra/api/client';\r\n\r\n// Services\r\nexport { authService } from './modules/auth/services/auth.service';\r\nexport { whitelabelService } from './modules/whitelabel/services/whitelabel.service';\r\nexport { revalidateWhitelabelAction } from './modules/whitelabel/actions/revalidate-whitelabel.action';\r\nexport { assertManagementPermission } from './modules/auth/utils/assert-management-permission';\r\nexport { assertManagementSubscription } from './modules/auth/utils/assert-management-subscription';\r\nexport { assertSubscriptionAddon } from './modules/auth/utils/assert-subscription-addon';\r\nexport { assertPaidSubscription } from './modules/auth/utils/assert-paid-subscription';\r\nexport { subscriptionsService } from './modules/subscriptions/services/subscriptions.service';\r\nexport { plansService } from './modules/plans/services/plans.service';\r\nexport { cardsService } from './modules/cards/services/cards.service';\r\nexport { chargesService } from './modules/charges/services/charges.service';\r\nexport { iaCreditsService } from './modules/ia-credits/services/ia-credits.service';\r\n\r\n// Actions\r\nexport { findWhitelabel } from './modules/whitelabel/actions/find-whitelabel.action';\r\nexport { validateSessionAction } from './modules/auth/actions/validate-session.action';\r\nexport { socialGoogleLoginAction } from './modules/auth/actions/social-google-login.action';\r\nexport { socialGoogleOnboardingAction } from './modules/auth/actions/social-google-onboarding.action';\r\nexport { unlinkGoogleAction } from './modules/auth/actions/unlink-google.action';\r\nexport { findUserById } from './modules/users/action/find-user-by-id.action';\r\nexport { findCurrentAccount } from './modules/accounts/actions/find-current-account.action';\r\nexport { getAccountTokenAction } from './modules/accounts/actions/get-account-token.action';\r\nexport { listSubscriptionsAction } from './modules/subscriptions/actions/list-subscriptions.action';\r\nexport { calculateSubscriptionAction } from './modules/subscriptions/actions/calculate-subscription.action';\r\nexport { updateSubscriptionPlanAction } from './modules/subscriptions/actions/update-subscription-plan.action';\r\nexport { updateSubscriptionPaymentAction } from './modules/subscriptions/actions/update-subscription-payment.action';\r\nexport { createCardAction } from './modules/cards/actions/create-card.action';\r\nexport { createSetupIntentAction } from './modules/cards/actions/create-setup-intent.action';\r\nexport { chargeActionAction } from './modules/charges/actions/charge-action.action';\r\nexport { resolvePlanExtrasPrices } from './modules/subscriptions/utils/resolve-plan-extras-prices';\r\nexport { hasSubscriptionExpired } from './modules/subscriptions/utils/has-subscription-expired';\r\nexport { hasActivePaidSubscription } from './modules/subscriptions/utils/has-active-paid-subscription';\r\n\r\n// Project Services & Actions (server-only)\r\nexport { projectsService } from './modules/projects/services/projects.service';\r\nexport { listProjectsAction } from './modules/projects/actions/list-projects.action';\r\nexport { findProjectAction } from './modules/projects/actions/find-project.action';\r\nexport { createProjectAction } from './modules/projects/actions/create-project.action';\r\nexport { updateProjectAction } from './modules/projects/actions/update-project.action';\r\nexport { deleteProjectAction } from './modules/projects/actions/delete-project.action';\r\n\r\n// Project Users Services & Actions (server-only)\r\nexport { projectUsersService } from './modules/projects/services/project-users.service';\r\nexport { listProjectUsersAction } from './modules/projects/actions/list-project-users.action';\r\nexport { addProjectUserAction } from './modules/projects/actions/add-project-user.action';\r\nexport { removeProjectUserAction } from './modules/projects/actions/remove-project-user.action';\r\n\r\n// Account Services & Actions (server-only)\r\nexport { accountService } from './modules/accounts/services/account.service';\r\nexport { twoFactorService } from './modules/accounts/services/two-factor.service';\r\nexport {\r\n  listAccountUsersAction,\r\n  updateUserAction,\r\n  updateAccountAction,\r\n  updateAccountUserByIdAction,\r\n  updateBillingDataAction,\r\n  deleteAccountUserAction,\r\n  deleteAccountAction,\r\n  createAccountUserAction,\r\n  changePasswordAction,\r\n  requestEmailChangeAction,\r\n  confirmEmailChangeAction,\r\n  requestPhoneChangeAction,\r\n  confirmPhoneChangeAction,\r\n  generateTwoFactorAction,\r\n  confirmTwoFactorAction,\r\n  disableTwoFactorAction,\r\n} from './modules/accounts/actions/account-management.action';\r\n\r\n// Server Utils\r\nexport { getClientInfoFromRequest } from './infra/utils/client-info';\r\nexport { getUserContext } from './modules/auth/utils/get-user-context';\r\nexport { resolveLocale } from './i18n/resolve-locale';\r\nexport type { ResolveLocaleOptions } from './i18n/resolve-locale';\r\nexport { requireValidSession } from './modules/auth/utils/require-valid-session';\r\nexport { requireTokenNotExpired } from './modules/auth/utils/require-token-not-expired';\r\nexport { buildWlOverride, buildWlOverrideFromJwt } from './modules/auth/utils/build-wl-override';\r\nexport { safeServerAction } from './utils/safeServerAction';\r\nexport { safeMutationAction } from './utils/safeMutationAction';\r\n\r\n// Image Processing (server-side)\r\nexport { processImageAction } from './modules/images/actions/process-image.action';\r\nexport { processImage } from './modules/images/services/image-processing.service';\r\nexport type {\r\n  ProcessImageInput,\r\n  ProcessImageOutput,\r\n  ProcessImageActionInput,\r\n  ProcessImageActionOutput,\r\n} from './modules/images/types/image.type';\r\n"],"mappings":"AAAA,OAAO;AAGP,SAAS,WAAW,KAAK,iBAAiB;AAG1C,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAClC,SAAS,kCAAkC;AAC3C,SAAS,kCAAkC;AAC3C,SAAS,oCAAoC;AAC7C,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AACvC,SAAS,4BAA4B;AACrC,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AAGjC,SAAS,sBAAsB;AAC/B,SAAS,6BAA6B;AACtC,SAAS,+BAA+B;AACxC,SAAS,oCAAoC;AAC7C,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,+BAA+B;AACxC,SAAS,mCAAmC;AAC5C,SAAS,oCAAoC;AAC7C,SAAS,uCAAuC;AAChD,SAAS,wBAAwB;AACjC,SAAS,+BAA+B;AACxC,SAAS,0BAA0B;AACnC,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AACvC,SAAS,iCAAiC;AAG1C,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,2BAA2B;AACpC,SAAS,2BAA2B;AAGpC,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,4BAA4B;AACrC,SAAS,+BAA+B;AAGxC,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,gCAAgC;AACzC,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAE9B,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,iBAAiB,8BAA8B;AACxD,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AAGnC,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greatapps/common",
-  "version": "1.1.739",
+  "version": "1.1.741",
   "description": "Shared library for GreatApps frontend applications",
   "main": "./dist/index.mjs",
   "types": "./src/index.ts",

package/src/components/modals/billing/RequiredBillingDataModal.tsx

@@ -0,0 +1,548 @@
+/* eslint-disable @typescript-eslint/no-explicit-any -- o generic Translator do next-intl não é
+   expressável estruturalmente; o `any` do TranslateFn é intencional e está contido neste arquivo
+   (mesmo padrão de modules/plans/utils/map-api-plan-to-ui.ts). */
+'use client';
+
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { Controller, useForm } from 'react-hook-form';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { useTranslations } from 'next-intl';
+import { toast } from 'sonner';
+import z from 'zod';
+import { IconFileInvoice } from '@tabler/icons-react';
+
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from '../../ui/overlay/Dialog';
+import { Button } from '../../ui/buttons/Button';
+import { FormField } from '../../ui/form/FormField';
+import { SelectField } from '../../ui/form/SelectField';
+import { Toast } from '../../ui/feedback/Toast';
+import { useAuth } from '../../../providers/auth.provider';
+import { useViaCep } from '../../../modules/accounts/hooks/useViaCep';
+import { useUpdateBillingData } from '../../../modules/accounts/hooks/useAccountManagement';
+import { useRequiredBillingData } from '../../../modules/accounts/hooks/use-required-billing-data.hook';
+import { COUNTRIES } from '../../../utils/countries';
+import { BR_STATE_OPTIONS } from '../../../utils/constants/br-states';
+import { formatCNPJ, formatCPF, formatPostalCode } from '../../../utils/format/masks';
+import { isValidCNPJ, isValidCPF } from '../../../utils/validators/common';
+import type { UpdateBillingDataRequest } from '../../../modules/accounts/types';
+
+type TranslateFn = (key: any, values?: Record<string, string | number>) => string;
+
+type BillingDataFormValues = {
+  personType: 'pf' | 'pj';
+  document: string;
+  financialName: string;
+  financialEmail: string;
+  cep: string;
+  street: string;
+  streetNumber: string;
+  complement?: string;
+  neighborhood: string;
+  city: string;
+  state: string;
+  country: string;
+};
+
+const COUNTRY_OPTIONS = COUNTRIES.map((country: { iso: string; name: string }) => ({
+  value: country.iso,
+  label: country.name,
+}));
+
+function buildBillingDataSchema(isInternational: boolean, translate: TranslateFn) {
+  const requiredText = z
+    .string()
+    .trim()
+    .min(1, translate('common.billing.requiredData.requiredField'));
+
+  const base = z.object({
+    personType: z.enum(['pf', 'pj']),
+    document: z.string().trim(),
+    financialName: requiredText,
+    financialEmail: z
+      .string()
+      .trim()
+      .min(1, translate('common.billing.requiredData.requiredField'))
+      .email(translate('common.billing.requiredData.invalidEmail')),
+    cep: requiredText,
+    street: requiredText,
+    streetNumber: z.string().trim(),
+    complement: z.string().trim().optional(),
+    neighborhood: z.string().trim(),
+    city: requiredText,
+    state: requiredText,
+    country: requiredText,
+  });
+
+  /* Conta internacional não tem CPF/CNPJ, número nem bairro — mesmo recorte do
+   * AddCardModal. Exigir esses campos aqui trancaria o cliente fora do app, já que
+   * o modal é bloqueante. */
+  if (isInternational) return base;
+
+  return base.superRefine((data, ctx) => {
+    if (!data.streetNumber) {
+      ctx.addIssue({
+        code: 'custom',
+        path: ['streetNumber'],
+        message: translate('common.billing.requiredData.requiredField'),
+      });
+    }
+
+    if (!data.neighborhood) {
+      ctx.addIssue({
+        code: 'custom',
+        path: ['neighborhood'],
+        message: translate('common.billing.requiredData.requiredField'),
+      });
+    }
+
+    if (data.cep.replace(/\D/g, '').length !== 8) {
+      ctx.addIssue({
+        code: 'custom',
+        path: ['cep'],
+        message: translate('common.billing.requiredData.invalidCep'),
+      });
+    }
+
+    const isCompany = data.personType === 'pj';
+    const digits = data.document.replace(/\D/g, '');
+
+    if (digits.length !== (isCompany ? 14 : 11)) {
+      ctx.addIssue({
+        code: 'custom',
+        path: ['document'],
+        message: isCompany
+          ? translate('common.billing.requiredData.invalidCnpj')
+          : translate('common.billing.requiredData.invalidCpf'),
+      });
+      return;
+    }
+
+    /* Dígito verificador, mesmo algoritmo do backend: sem isso 111.111.111-11 passa
+     * aqui e o PUT da conta é recusado depois, sem o usuário saber o motivo. */
+    const isValid = isCompany ? isValidCNPJ(digits) : isValidCPF(digits);
+    if (!isValid) {
+      ctx.addIssue({
+        code: 'custom',
+        path: ['document'],
+        message: isCompany
+          ? translate('common.billing.requiredData.invalidCnpjChecksum')
+          : translate('common.billing.requiredData.invalidCpfChecksum'),
+      });
+    }
+  });
+}
+
+function formatDocument(document: string | null | undefined, isCompany: boolean) {
+  if (!document) return '';
+  return isCompany ? formatCNPJ(document) : formatCPF(document);
+}
+
+function RequiredBillingDataModalContent() {
+  const translate = useTranslations();
+  const { user } = useAuth();
+  const { isRequired, account, isInternational } = useRequiredBillingData();
+  const { mutateAsync: updateBillingData } = useUpdateBillingData();
+  const { mutateAsync: lookupCep } = useViaCep();
+
+  /* O modal fecha na hora do submit e não reabre enquanto o invalidate do account
+   * não volta — sem isso o usuário vê o modal piscar de novo com o cache antigo. */
+  const [isSubmitted, setIsSubmitted] = useState(false);
+  const isPrefilled = useRef(false);
+
+  const schema = useMemo(
+    () => buildBillingDataSchema(isInternational, translate),
+    [isInternational, translate],
+  );
+
+  const form = useForm<BillingDataFormValues>({
+    resolver: zodResolver(schema),
+    mode: 'onChange',
+    defaultValues: {
+      personType: 'pf',
+      document: '',
+      financialName: '',
+      financialEmail: '',
+      cep: '',
+      street: '',
+      streetNumber: '',
+      complement: '',
+      neighborhood: '',
+      city: '',
+      state: '',
+      country: 'BR',
+    },
+  });
+
+  const {
+    register,
+    control,
+    handleSubmit,
+    reset,
+    setValue,
+    watch,
+    formState: { errors, isSubmitting, isValid },
+  } = form;
+
+  const personType = watch('personType');
+  const isCompany = personType === 'pj';
+
+  useEffect(() => {
+    if (!account || isPrefilled.current) return;
+    isPrefilled.current = true;
+
+    const accountIsCompany = account.financial_document_type === 2;
+    reset({
+      personType: accountIsCompany ? 'pj' : 'pf',
+      document: formatDocument(account.financial_document, accountIsCompany),
+      financialName: account.financial_name ?? '',
+      financialEmail: account.financial_email || user?.email || '',
+      cep: account.zipcode ?? '',
+      street: account.address ?? '',
+      streetNumber: account.address_number ?? '',
+      complement: account.address_complement ?? '',
+      neighborhood: account.neighborhood ?? '',
+      city: account.city ?? '',
+      state: account.state ?? '',
+      country: account.country || (isInternational ? 'US' : 'BR'),
+    });
+  }, [account, isInternational, reset, user?.email]);
+
+  const handleDocumentChange = (rawValue: string) => {
+    setValue('document', isCompany ? formatCNPJ(rawValue) : formatCPF(rawValue), {
+      shouldValidate: true,
+    });
+  };
+
+  const handlePersonTypeChange = (value: 'pf' | 'pj') => {
+    if (value === personType) return;
+    setValue('document', '');
+    /* shouldValidate reroda o resolver: sem isso o `isValid` fica preso no valor
+     * do documento antigo e o botão continua habilitado com o campo já limpo. */
+    setValue('personType', value, { shouldValidate: true });
+  };
+
+  const handleCepChange = (rawValue: string) => {
+    if (isInternational) {
+      setValue('cep', rawValue, { shouldValidate: true });
+      return;
+    }
+
+    setValue('cep', formatPostalCode(rawValue), { shouldValidate: true });
+
+    const digits = rawValue.replace(/\D/g, '');
+    if (digits.length !== 8) return;
+
+    lookupCep(digits)
+      .then((data) => {
+        setValue('street', data.logradouro, { shouldValidate: true });
+        setValue('neighborhood', data.bairro, { shouldValidate: true });
+        setValue('city', data.localidade, { shouldValidate: true });
+        setValue('state', data.uf, { shouldValidate: true });
+      })
+      .catch(() => {
+        // CEP não encontrado: o usuário preenche o endereço na mão.
+      });
+  };
+
+  async function onSubmit(data: BillingDataFormValues) {
+    const payload: UpdateBillingDataRequest = {
+      ...(isInternational
+        ? {}
+        : {
+            financial_document_type: data.personType === 'pf' ? 1 : 2,
+            financial_document: data.document,
+          }),
+      financial_name: data.financialName,
+      financial_email: data.financialEmail,
+      zipcode: data.cep,
+      address: data.street,
+      address_number: data.streetNumber,
+      address_complement: data.complement ?? '',
+      neighborhood: data.neighborhood,
+      city: data.city,
+      state: data.state,
+      country: data.country,
+    };
+
+    try {
+      await updateBillingData(payload);
+      setIsSubmitted(true);
+      toast.custom(
+        (t) => (
+          <Toast
+            variant="success"
+            message={translate('common.billing.requiredData.successToast')}
+            toastId={t}
+          />
+        ),
+        { duration: 5000 },
+      );
+    } catch (error) {
+      /* O backend devolve a razão exata da recusa (ex.: documento fiscal inválido).
+       * Trocar por um texto genérico deixaria o usuário travado sem saber o que corrigir. */
+      const message =
+        error instanceof Error && error.message
+          ? error.message
+          : translate('common.billing.requiredData.errorToast');
+      toast.custom((t) => <Toast variant="error" message={message} toastId={t} />, {
+        duration: 5000,
+      });
+    }
+  }
+
+  if (!isRequired || isSubmitted) return null;
+
+  return (
+    <Dialog open onOpenChange={() => {}}>
+      <DialogContent
+        showCloseButton={false}
+        onEscapeKeyDown={(event: Event) => event.preventDefault()}
+        onPointerDownOutside={(event: Event) => event.preventDefault()}
+        onInteractOutside={(event: Event) => event.preventDefault()}
+        className="flex flex-col p-0 gap-0 max-w-full sm:max-w-full border-0 rounded-t-2xl rounded-b-none h-dvh top-0 bottom-0 left-0 right-0 translate-x-0 translate-y-0 lg:max-w-[502px] lg:h-auto lg:max-h-[90vh] lg:rounded-lg lg:border lg:top-[50%] lg:left-[50%] lg:right-auto lg:bottom-auto lg:translate-x-[-50%] lg:translate-y-[-50%] overflow-hidden"
+      >
+        <DialogHeader className="gap-3 text-left p-4 lg:p-5 border-b border-zinc-200 shrink-0">
+          <div className="flex items-center justify-center w-10 h-10 bg-zinc-50 rounded-lg">
+            <IconFileInvoice size={24} className="text-zinc-950" />
+          </div>
+          <div className="flex flex-col gap-2">
+            <DialogTitle className="paragraph-medium-semibold text-zinc-950">
+              {translate('common.billing.requiredData.title')}
+            </DialogTitle>
+            <span className="paragraph-small-regular text-zinc-600">
+              {translate('common.billing.requiredData.description')}
+            </span>
+          </div>
+        </DialogHeader>
+
+        <form
+          onSubmit={handleSubmit(onSubmit)}
+          className="flex flex-col flex-1 min-h-0"
+          noValidate
+        >
+          <div className="flex flex-col gap-6 p-4 lg:p-5 flex-1 overflow-y-auto">
+            <div className="flex flex-col gap-5">
+              {!isInternational && (
+                <div className="flex gap-4">
+                  <Controller
+                    name="personType"
+                    control={control}
+                    render={({ field }) => (
+                      <SelectField
+                        label={translate('common.billing.requiredData.personType')}
+                        placeholder={translate('common.billing.requiredData.select')}
+                        value={field.value}
+                        onChange={(value) => handlePersonTypeChange(value as 'pf' | 'pj')}
+                        options={[
+                          {
+                            value: 'pf',
+                            label: translate('common.billing.requiredData.personTypePf'),
+                          },
+                          {
+                            value: 'pj',
+                            label: translate('common.billing.requiredData.personTypePj'),
+                          },
+                        ]}
+                        containerClassName="flex-1"
+                      />
+                    )}
+                  />
+                  <div className="flex-1">
+                    <FormField
+                      label={
+                        isCompany
+                          ? translate('common.billing.requiredData.cnpj')
+                          : translate('common.billing.requiredData.cpf')
+                      }
+                      placeholder={isCompany ? '__.___.___/____-__' : '___.___.___-__'}
+                      error={!!errors.document}
+                      errorMessage={errors.document?.message}
+                      {...register('document', {
+                        onChange: (event) => handleDocumentChange(event.target.value),
+                      })}
+                    />
+                  </div>
+                </div>
+              )}
+
+              <FormField
+                label={
+                  isCompany
+                    ? translate('common.billing.requiredData.companyName')
+                    : translate('common.billing.requiredData.fullName')
+                }
+                placeholder={translate('common.billing.requiredData.typeHere')}
+                error={!!errors.financialName}
+                errorMessage={errors.financialName?.message}
+                {...register('financialName')}
+              />
+
+              <FormField
+                label={translate('common.billing.requiredData.financialEmail')}
+                placeholder={translate('common.billing.requiredData.financialEmailPlaceholder')}
+                type="email"
+                error={!!errors.financialEmail}
+                errorMessage={errors.financialEmail?.message}
+                {...register('financialEmail')}
+              />
+            </div>
+
+            <div className="h-px bg-zinc-200" />
+
+            <div className="flex flex-col gap-5">
+              <span className="paragraph-small-semibold text-zinc-950">
+                {translate('common.billing.requiredData.addressHeading')}
+              </span>
+
+              <FormField
+                label={
+                  isInternational
+                    ? translate('common.billing.requiredData.postalCode')
+                    : translate('common.billing.requiredData.cep')
+                }
+                placeholder={isInternational ? '' : '_____-___'}
+                error={!!errors.cep}
+                errorMessage={errors.cep?.message}
+                {...register('cep', {
+                  onChange: (event) => handleCepChange(event.target.value),
+                })}
+              />
+
+              <div className="flex gap-4">
+                <div className="flex-[3]">
+                  <FormField
+                    label={translate('common.billing.requiredData.street')}
+                    placeholder={translate('common.billing.requiredData.typeHere')}
+                    error={!!errors.street}
+                    errorMessage={errors.street?.message}
+                    {...register('street')}
+                  />
+                </div>
+                {!isInternational && (
+                  <div className="flex-1">
+                    <FormField
+                      label={translate('common.billing.requiredData.streetNumber')}
+                      placeholder="000"
+                      error={!!errors.streetNumber}
+                      errorMessage={errors.streetNumber?.message}
+                      {...register('streetNumber')}
+                    />
+                  </div>
+                )}
+              </div>
+
+              <div className="flex gap-4">
+                {!isInternational && (
+                  <div className="flex-1">
+                    <FormField
+                      label={translate('common.billing.requiredData.neighborhood')}
+                      placeholder={translate('common.billing.requiredData.typeHere')}
+                      error={!!errors.neighborhood}
+                      errorMessage={errors.neighborhood?.message}
+                      {...register('neighborhood')}
+                    />
+                  </div>
+                )}
+                <div className="flex-1">
+                  <FormField
+                    label={translate('common.billing.requiredData.complement')}
+                    optional
+                    placeholder={translate('common.billing.requiredData.typeHere')}
+                    {...register('complement')}
+                  />
+                </div>
+              </div>
+
+              <div className="flex gap-4">
+                <div className="flex-1">
+                  <FormField
+                    label={translate('common.billing.requiredData.city')}
+                    placeholder={translate('common.billing.requiredData.typeHere')}
+                    error={!!errors.city}
+                    errorMessage={errors.city?.message}
+                    {...register('city')}
+                  />
+                </div>
+                <div className="flex-1">
+                  {isInternational ? (
+                    <FormField
+                      label={translate('common.billing.requiredData.stateProvince')}
+                      placeholder={translate('common.billing.requiredData.typeHere')}
+                      error={!!errors.state}
+                      errorMessage={errors.state?.message}
+                      {...register('state')}
+                    />
+                  ) : (
+                    <Controller
+                      name="state"
+                      control={control}
+                      render={({ field }) => (
+                        <SelectField
+                          label={translate('common.billing.requiredData.state')}
+                          placeholder={translate('common.billing.requiredData.select')}
+                          value={field.value || undefined}
+                          onChange={(value) =>
+                            setValue('state', value as string, { shouldValidate: true })
+                          }
+                          options={BR_STATE_OPTIONS}
+                          error={!!errors.state}
+                          errorMessage={errors.state?.message}
+                        />
+                      )}
+                    />
+                  )}
+                </div>
+              </div>
+
+              <Controller
+                name="country"
+                control={control}
+                render={({ field }) => (
+                  <SelectField
+                    label={translate('common.billing.requiredData.country')}
+                    placeholder={translate('common.billing.requiredData.select')}
+                    value={field.value || undefined}
+                    onChange={(value) =>
+                      setValue('country', value as string, { shouldValidate: true })
+                    }
+                    options={COUNTRY_OPTIONS}
+                    error={!!errors.country}
+                    errorMessage={errors.country?.message}
+                  />
+                )}
+              />
+            </div>
+          </div>
+
+          <div className="flex items-center justify-end p-4 lg:p-5 border-t border-zinc-200 shrink-0">
+            <Button
+              type="submit"
+              className="h-10! w-full lg:w-fit"
+              disabled={!isValid || isSubmitting}
+              loading={isSubmitting}
+            >
+              {isSubmitting
+                ? translate('common.billing.requiredData.submitting')
+                : translate('common.billing.requiredData.submit')}
+            </Button>
+          </div>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+/**
+ * Modal bloqueante que exige o cadastro de cobrança/fiscal de contas que já
+ * pagaram sem ele — sem esses dados a nota fiscal não é emitida. Monte uma vez
+ * no layout raiz do app; ele mesmo decide se aparece (ver `useRequiredBillingData`).
+ */
+export default function RequiredBillingDataModal() {
+  const { user, isLoading } = useAuth();
+
+  /* Sem sessão não há conta nem assinatura pra consultar — evita disparar as
+   * queries (e tomar 401) em /login, /register e demais rotas públicas. */
+  if (isLoading || !user) return null;
+
+  return <RequiredBillingDataModalContent />;
+}