@greatapps/common 1.1.675 → 1.1.677

package/src/i18n/messages/pt-br.ts

@@ -0,0 +1,538 @@
+/**
+ * Catálogo de traduções pt-br dos componentes da @greatapps/common.
+ * Os apps consumidores mesclam este objeto sob o namespace `common`.
+ *
+ * Padrão modular: cada chave de primeiro nível é um **módulo** (um agrupamento por
+ * componente/domínio). Para adicionar traduções, crie/edite o módulo correspondente aqui
+ * e replique a mesma estrutura em `en-us.ts` e `es-es.ts`.
+ *
+ * pt-br é a fonte da verdade — os textos saem verbatim do que o componente já exibe hoje.
+ */
+const messages = {
+  // Vocabulário global de ações (botões, comandos).
+  actions: {
+    save: 'Salvar',
+    saveChanges: 'Salvar alterações',
+    cancel: 'Cancelar',
+    confirm: 'Confirmar',
+    delete: 'Excluir',
+    edit: 'Editar',
+    close: 'Fechar',
+    back: 'Voltar',
+    continue: 'Continuar',
+    add: 'Adicionar',
+    remove: 'Remover',
+    search: 'Buscar',
+    loading: 'Carregando...',
+    saving: 'Salvando...',
+    sending: 'Enviando...',
+    copy: 'Copiar',
+    copied: 'Copiado',
+  },
+
+  // Mensagens de validação de formulário.
+  validations: {
+    required: 'Campo obrigatório',
+    invalidEmail: 'E-mail inválido',
+    invalidPhone: 'Telefone inválido',
+  },
+
+  // Componente: PreferencesSection.
+  preferences: {
+    title: 'Preferências',
+    companyName: 'Nome da empresa',
+    companyNamePlaceholder: 'Digite o nome da empresa',
+    language: 'Idioma',
+    languagePlaceholder: 'Selecione o idioma',
+    languageSearch: 'Buscar idioma...',
+    currency: 'Moeda',
+    currencyPlaceholder: 'Selecione a moeda',
+    currencySearch: 'Buscar moeda...',
+    timeDisplay: 'Exibição hora',
+    timezone: 'Fuso horário',
+    timezonePlaceholder: 'Selecione o fuso horário',
+    timezoneSearch: 'Buscar fuso horário...',
+    timeFormat: 'Formato hora',
+    timeFormatPlaceholder: 'Selecione o formato',
+    timeFormatOptions: {
+      h24: '24 horas',
+      h12: '12 horas (AM/PM)',
+    },
+    savedSuccess: 'Preferências salvas com sucesso',
+    saveError: 'Erro ao salvar preferências',
+  },
+
+  // Conta — modais e seções. `<b>` = trecho em negrito (rich text); `{count}` = interpolação.
+  account: {
+    notificationTypes: {
+      projectUpdates: 'Atualizações de projetos',
+      securityAlerts: 'Alertas de segurança',
+      planBilling: 'Mudanças no plano ou faturamento',
+      scheduledMaintenance: 'Manutenções programadas',
+    },
+    deleteAccount: {
+      title: 'Excluir conta',
+      description:
+        'Esta ação é <b>irreversível</b>. Ao confirmar, sua conta e todos os seus dados serão excluídos.',
+      reasonLabel: 'Motivo do cancelamento',
+      reasonPlaceholder: 'Selecione',
+      descriptionLabel: 'Descreva o que levou a tomar essa decisão',
+      descriptionPlaceholder: 'Explique sua decisão...',
+      charactersCount: '{count}/400 caracteres',
+      passwordLabel: 'Senha',
+      passwordPlaceholder: 'Informe sua senha',
+      submit: 'Excluir conta',
+      requiredFields: 'Preencha todos os campos obrigatórios',
+      reasons: {
+        noFeature: 'A ferramenta não possui uma função que eu preciso',
+        technical: 'Encontrei problemas técnicos ou erros no sistema',
+        support: 'Tive problemas com o suporte ou atendimento',
+        updates: 'As atualizações demoram mais do que o esperado',
+        temporary: 'O cancelamento é temporário',
+        other: 'Outro motivo',
+      },
+    },
+    confirmDelete: {
+      title: 'Uma pena te ver ir!',
+      warning:
+        'Todas suas <b>{count} páginas</b> serão deletadas permanentemente. Essa ação é <b>irreversível!</b>',
+      sessionExpired: 'Sessão expirada. Preencha os campos novamente.',
+      success: 'Conta excluída com sucesso',
+      error: 'Erro ao excluir. Tente novamente.',
+      keepAccount: 'Manter minha conta',
+      deleteAnyway: 'Excluir mesmo assim',
+      deleting: 'Excluindo...',
+    },
+    cantDelete: {
+      title: 'Não é possível excluir a conta',
+      description:
+        'Você tem uma assinatura ativa. Para excluir sua conta, <b>primeiro cancele a assinatura</b> na página Assinatura e depois tente novamente.',
+      confirm: 'Ok, entendi',
+      goToSubscription: 'Ir para assinatura',
+    },
+    twoFactor: {
+      title: 'Autenticação de dois fatores',
+      instructions:
+        'Instale um aplicativo autenticador no seu celular (ex.: <link>Google Authenticator</link>), escaneie o QR Code ao lado ou copie a chave no aplicativo e, em seguida, digite o código de 6 dígitos gerado para continuar.',
+      qrAlt: 'QR Code para autenticação de dois fatores',
+      retry: 'Tentar novamente',
+      pasteDigits: 'Cole os 6 dígitos abaixo',
+      activating: 'Ativando...',
+      activate: 'Ativar autenticação',
+      recoveryTitle: 'Códigos de segurança',
+      recoveryHeading: 'Salve estes códigos de recuperação de emergência',
+      recoveryText1:
+        'Se você perder acesso ao seu telefone, não será possível fazer login em sua conta sem um código de dois fatores.',
+      recoveryText2: 'Imprima, copie ou escreva em um local seguro os códigos abaixo.',
+      copyCodes: 'Copiar códigos',
+      finish: 'Finalizar',
+      codesCopied: 'Códigos copiados com sucesso',
+      generateError: 'Erro ao gerar QR Code. Tente novamente.',
+      confirmError: 'Erro ao confirmar código. Tente novamente.',
+      disableTitle: 'Desabilitar autenticação 2FA',
+      disableDescription:
+        'Informe o código de 6 dígitos do seu aplicativo autenticador para confirmar a desativação.',
+      authenticatorCode: 'Código do autenticador',
+      disabling: 'Desabilitando...',
+      disable: 'Desabilitar 2FA',
+      disabledSuccess: 'Autenticação de dois fatores desabilitada',
+      disableError: 'Erro ao desabilitar 2FA. Tente novamente.',
+      invalidCode: 'Código inválido',
+      codeResent: 'Código reenviado',
+      resendError: 'Erro ao reenviar código. Tente novamente.',
+    },
+    profile: {
+      title: 'Meu perfil',
+      avatarAlt: 'Foto do usuário',
+      changePhoto: 'Alterar foto',
+      name: 'Nome',
+      namePlaceholder: 'Digite seu nome',
+      lastName: 'Sobrenome',
+      lastNamePlaceholder: 'Digite seu sobrenome',
+      gender: 'Gênero',
+      genderPlaceholder: 'Selecione seu gênero',
+      genderOptions: {
+        male: 'Masculino',
+        female: 'Feminino',
+      },
+      phone: 'Telefone',
+      change: 'Alterar',
+      accessData: 'Dados de acesso',
+      email: 'E-mail',
+      savedSuccess: 'Perfil atualizado com sucesso',
+      saveError: 'Erro ao atualizar perfil',
+    },
+    otp: {
+      validationCode: 'Código de validação',
+      incorrectCode: 'Código incorreto',
+      resend: 'Reenviar código',
+      resendIn: 'Reenviar em <b>{time}</b>',
+      validating: 'Validando...',
+    },
+    changeEmail: {
+      title: 'Alterar e-mail',
+      confirm: 'Alterar e-mail',
+      sentCodeTo: 'Enviamos um código de validação para o E-mail <b>{email}.</b>',
+      updateTitle: 'Atualizar E-mail de contato',
+      updateDescription: 'Informe o seu novo E-mail para manter seu contato atualizado.',
+      newEmail: 'Novo e-mail',
+      newEmailPlaceholder: 'Digite seu novo e-mail',
+      emailChanged: 'E-mail alterado com sucesso',
+      emailExistsError: 'E-mail já existente ou ocorreu um erro. Tente novamente mais tarde.',
+    },
+    changePhone: {
+      titleEdit: 'Alterar telefone',
+      titleAdd: 'Adicionar telefone',
+      sentCodeTo: 'Enviamos um código de validação para o número atual <b>{phone}.</b>',
+      confirm: 'Alterar telefone',
+      updateTitle: 'Atualizar telefone de contato',
+      addTitle: 'Adicionar telefone de contato',
+      updateDescription: 'Informe o novo número para manter seu contato atualizado.',
+      addDescription: 'Informe seu número de telefone para contato.',
+      newNumber: 'Novo número',
+      numberLabel: 'Número de telefone',
+      phoneChanged: 'Telefone alterado',
+      phoneAdded: 'Telefone adicionado',
+      invalidNumber: 'Número de telefone inválido',
+      saveError: 'Ocorreu um erro ao salvar o telefone. Tente novamente mais tarde.',
+      numberExistsError: 'Número já existente ou ocorreu um erro. Tente novamente mais tarde.',
+    },
+    security: {
+      title: 'Segurança',
+      googleLinkedTitle: 'Conta Google vinculada',
+      googleLinkedDescription:
+        'Sua conta está vinculada ao Google. Se desvincular, use "Esqueci minha senha" para redefinir uma senha de acesso por e-mail.',
+      unlinking: 'Desvinculando...',
+      unlinkGoogle: 'Desvincular Google',
+      unlinkError: 'Erro ao desvincular conta Google.',
+      deleteAccountDescription:
+        'Esta ação é permanente e não pode ser desfeita. Todos os seus dados, projetos e configurações serão removidos definitivamente.',
+      deleteMyAccount: 'Excluir minha conta',
+    },
+    token: {
+      title: 'Token da conta',
+      label: 'Token',
+      copySuccess: 'Token copiado com sucesso',
+      copyError: 'Não foi possível copiar o token',
+      info: 'Este token é exclusivo da sua conta e permite acesso à API. Não compartilhe com terceiros.',
+      docsLink: 'Acessar a documentação',
+    },
+    changePassword: {
+      title: 'Alterar senha',
+      currentPassword: 'Senha atual',
+      currentPasswordPlaceholder: 'Digite sua senha atual',
+      newPassword: 'Nova senha',
+      newPasswordPlaceholder: 'Digite sua nova senha',
+      submit: 'Salvar nova senha',
+      changeError: 'Erro ao alterar senha',
+      changedSuccess: 'Senha alterada com sucesso',
+      genericError: 'Erro ao alterar senha. Tente novamente.',
+    },
+    globalPreferences: {
+      title: 'Alterar preferências globais',
+      srDescription: 'Confirmação de alteração de preferências globais da conta',
+      warning:
+        'Você está alterando configurações que impactam <b>todos os usuários da conta</b>. Deseja confirmar?',
+    },
+    configurations: {
+      title: 'Configurações',
+    },
+  },
+
+  // Modais de créditos de IA.
+  credits: {
+    buy: {
+      title: 'Comprar créditos de IA',
+      externalTitle: 'Créditos de IA',
+      externalDescription: 'Para adquirir créditos de IA, acesse sua área de assinatura.',
+      externalButton: 'Acessar área de assinatura',
+      creditsOptionLabel: '{credits} créditos de IA',
+      creditsOptionDisplayValue: '{credits} créditos de IA',
+      paymentOnConfirm: 'O pagamento será processado no momento da confirmação.',
+      nextInvoiceChanges: 'As alterações entrarão em vigor a partir da sua próxima fatura.',
+      defaultPrice: 'Padrão',
+      immediateCharge: 'Cobrança imediata',
+      totalPlanValue: 'Valor total do plano',
+      confirmAndPay: 'Confirmar e pagar',
+      creditsChangedToast: 'Créditos de IA alterados para {credits}',
+    },
+    disabled: {
+      title: 'Compra de créditos indisponível',
+      descriptionLine1: 'Apenas administradores e proprietários podem comprar créditos de IA.',
+      descriptionLine2:
+        'Peça a um administrador ou proprietário da conta para adquirir mais créditos.',
+      understood: 'Entendi',
+    },
+    paidPlanRequired: {
+      defaultTitle: 'Recurso disponível em planos pagos',
+      defaultDescription: 'Para acessar este recurso, faça upgrade para um plano pago',
+      knowPlans: 'Conhecer planos',
+    },
+  },
+
+  // Cartões: adicionar, formulário, excluir, não-pode-excluir, item, info de pagamento.
+  cards: {
+    add: {
+      stepBilling: 'Cobrança',
+      stepCard: 'Cartão',
+      externalTitle: 'Gerenciamento de cartões indisponível',
+      externalDescription: 'Acesse sua área de assinatura para gerenciar formas de pagamento.',
+      externalButton: 'Acessar área de assinatura',
+      title: 'Adicionar cartão',
+      billingHeading: 'Adicione suas informações de cobrança',
+      cardHeading: 'Adicione informações do seu cartão',
+      authenticating: 'Autenticando...',
+      submitting: 'Adicionando cartão...',
+      submit: 'Adicionar cartão',
+      errorInitAuth: 'Não foi possível iniciar a autenticação do cartão, tente novamente.',
+      errorAuth: 'Falha na autenticação do cartão.',
+      errorAuthStatus: 'Autenticação não concluída (status: {status}).',
+      statusUnknown: 'desconhecido',
+      successToast: 'Cartão adicionado com sucesso.',
+      errorSave: 'Não foi possível salvar o seu novo cartão, tente novamente.',
+    },
+    form: {
+      nameOnCard: 'Nome impresso no cartão',
+      typeHere: 'Digite aqui',
+      cardNumber: 'Número do cartão',
+      cardExpiry: 'Data de validade',
+      cardCvc: 'CVC',
+      country: 'País',
+      select: 'Selecione',
+      personType: 'Tipo de pessoa',
+      personTypePf: 'Pessoa física',
+      personTypePj: 'Pessoa jurídica',
+      cpf: 'CPF',
+      cnpj: 'CNPJ',
+      fullName: 'Nome completo',
+      cep: 'CEP',
+      postalCode: 'Código postal',
+      street: 'Endereço',
+      streetNumber: 'Número',
+      city: 'Cidade',
+      state: 'UF',
+      stateProvince: 'Estado/Província',
+      neighborhood: 'Bairro',
+      complement: 'Complemento',
+      cardNumberRequired: 'Número do cartão é obrigatório',
+      cardExpiryRequired: 'Data de validade é obrigatória',
+      cardCvcRequired: 'Código de segurança é obrigatório',
+    },
+    delete: {
+      title: 'Excluir cartão',
+      description: 'Deseja realmente excluir o cartão:',
+      confirmLabel: 'Digite EXCLUIR abaixo',
+      confirmPlaceholder: 'EXCLUIR',
+      deleting: 'Excluindo...',
+      successToast: 'O cartão •••• {digits} foi excluído com sucesso',
+      errorToast: 'Não foi possível excluir o cartão',
+    },
+    cannotDelete: {
+      title: 'Não é possível excluir este cartão',
+      description: 'Este cartão está em uso e tem uma assinatura ativa vinculada a ele. Selecione outro cartão como padrão ou adicione um novo.',
+      selectDefault: 'Selecione um cartão como padrão:',
+      addNewCard: 'Adicionar novo cartão',
+      errorUpdateCard: 'Erro ao atualizar cartão da assinatura',
+    },
+    item: {
+      defaultBadge: 'Padrão',
+      makeDefault: 'Tornar padrão',
+      setDefaultSuccess: 'Cartão definido como padrão',
+      setDefaultError: 'Erro ao definir cartão padrão',
+    },
+    paymentInfo: {
+      email: 'E-mail',
+      payment: 'Pagamento',
+      addCard: 'Adicionar cartão',
+      selectPaymentMethod: 'Selecione a forma de pagamento',
+      manageCards: 'Gerenciar cartões',
+      newPaymentMethod: 'Nova forma de pagamento',
+    },
+  },
+
+  // Componentes de navegação: banners de assinatura, seletor de projeto, links de rodapé, créditos, plano.
+  navigation: {
+    banners: {
+      cancelled: {
+        message: 'Assinatura cancelada! Suas páginas foram retiradas do ar.',
+        choosePlan: 'Escolher um novo plano',
+      },
+      overdue: {
+        message: 'Sua assinatura está atrasada e suas páginas podem ser retiradas do ar a qualquer momento.',
+        details: 'Detalhes',
+      },
+      pending: {
+        message: 'Sua assinatura foi cancelada, você possui até {limitDate} com suas páginas online.',
+        reactivate: 'Reativar assinatura',
+      },
+      upcoming: {
+        message: 'Fatura em aberto. Pague até {dueDate} para evitar a suspensão das suas páginas.',
+        details: 'Detalhes',
+      },
+    },
+    projectSelector: {
+      title: 'Projetos',
+      searchPlaceholder: 'Busque aqui',
+      emptyLine1: 'Nenhum projeto encontrado.',
+      emptyLine2: 'Crie um projeto para começar.',
+      noResults: 'Nenhum resultado encontrado.',
+      manageProjects: 'Gerenciar projetos',
+    },
+    bottomLinks: {
+      news: 'Novidades',
+      helpCenter: 'Central de ajuda',
+      sendSuggestions: 'Enviar sugestões',
+    },
+    creditsCard: {
+      label: 'Créditos usados',
+    },
+    planCard: {
+      knowPlans: 'Conheça os planos',
+    },
+  },
+
+  // Nomes dos idiomas exibidos no seletor.
+  // Planos: features e main features (mapApiPlanToUiPlan).
+  plans: {
+    features: {
+      unlimitedVisits: 'Visitas ilimitadas',
+      unlimitedLeads: 'Leads ilimitadas',
+      sharePages: 'Compartilhar páginas',
+      hosting: 'Hospedagem inclusa',
+      freeTemplates: 'Templates gratuitos',
+      onboarding: 'Reunião de Onboarding',
+      projectManagement: 'Gestão de projetos',
+    },
+    mainFeatures: {
+      pagesUnlimited: 'Páginas ilimitadas',
+      pageSingular: '1 página',
+      pagesPlural: '{count} páginas',
+      domainsUnlimited: 'Domínios ilimitados',
+      domainSingular: '1 domínio externo',
+      domainsPlural: '{count} domínios externos',
+      usersUnlimited: 'Usuários ilimitados',
+    },
+  },
+
+  // Periodicidade de cobrança.
+  periodicity: {
+    monthly: 'Mensal',
+    semiannual: 'Semestral',
+    annual: 'Anual',
+    suffixMonthly: '/mês',
+    suffixSemiannual: '/semestre',
+    suffixAnnual: '/ano',
+    labelMonthly: 'mensal',
+    labelSemiannual: 'semestral',
+    labelAnnual: 'anual',
+  },
+
+  languages: {
+    'pt-br': 'Português (Brasil)',
+    'en-us': 'Inglês (EUA)',
+    'es-es': 'Espanhol',
+  },
+
+  // Componentes de formulário e entrada.
+  forms: {
+    combobox: {
+      placeholder: 'Selecione uma opção',
+      searchPlaceholder: 'Buscar...',
+      emptyMessage: 'Nenhuma opção encontrada.',
+    },
+    datePicker: {
+      placeholder: 'Selecione a data',
+    },
+    dateRangePicker: {
+      placeholder: 'Selecione o período',
+    },
+    phoneInput: {
+      optional: '(Opcional)',
+      searchPlaceholder: 'Buscar país...',
+      emptyMessage: 'Nenhum país encontrado',
+    },
+    select: {
+      placeholder: 'Selecione uma opção',
+      optional: '(Opcional)',
+    },
+    copyButton: {
+      tooltipDefault: 'Copiar link',
+      successDefault: 'Link copiado',
+      errorMessage: 'Não foi possível copiar o link',
+    },
+    circularProgress: {
+      ariaLabel: 'Progresso de exportação',
+    },
+  },
+
+  // Componentes: ImageCropModal, ImageTooSmallModal.
+  imageUpload: {
+    cropTitle: 'Ajustar imagem',
+    cropHint: 'Arraste para ajustar a área de corte',
+    cropAlt: 'Crop',
+    tooSmallTitleWithDimension: 'Foto menor que {dimensionText}',
+    tooSmallTitleGeneric: 'Foto muito pequena',
+    tooSmallBodyFileWithDimension: 'O arquivo "{fileName}" é menor que {dimensionText}. Faça envio de uma imagem com pelo menos {dimensionText} para continuar.',
+    tooSmallBodyFileGeneric: 'O arquivo "{fileName}" é menor que o tamanho mínimo exigido. Faça envio de uma imagem maior para continuar.',
+    tooSmallBodyNoFileWithDimension: 'A imagem selecionada é menor que {dimensionText}. Faça envio de uma imagem com pelo menos {dimensionText} para continuar.',
+    tooSmallBodyNoFileGeneric: 'A imagem selecionada é menor que o tamanho mínimo exigido. Faça envio de uma imagem maior para continuar.',
+    sendAnother: 'Enviar outra',
+    errorSvg: 'Formato SVG não é suportado. Use PNG, JPEG, WebP ou GIF.',
+    errorFormat: 'Formato não suportado. Use PNG, JPEG, WebP ou GIF.',
+    errorTooLarge: 'Arquivo muito grande. Máximo {maxSize}MB.',
+  },
+
+  // Componentes: NotificationPageContent (Notifications.tsx), NotificationsPopover.tsx.
+  notifications: {
+    page: {
+      title: 'Notificações',
+      subtitle: 'Tenha controle total sobre páginas, experiências e conversões.',
+      markAllReadDesktop: 'Marcar todos como lidos',
+      markAllReadMobile: 'Marcar como lidos',
+      tabAll: 'Todas as notificações',
+      tabUnread: 'Não lidas',
+      details: 'Detalhes',
+      empty: 'Nenhuma notificação encontrada.',
+      markAllSuccess: 'Todas as notificações foram marcadas como lidas',
+      markAllError: 'Erro ao marcar notificações como lidas',
+    },
+    popover: {
+      title: 'Últimas notificações',
+      empty: 'Sem notificações por enquanto',
+      viewAll: 'Todas as notificações',
+    },
+  },
+
+  // Componentes: NavBar.tsx, ProfilePopover.tsx, UsersSelectorPopover.tsx.
+  layout: {
+    navbar: {
+      expandMenu: 'Expandir menu',
+      greatPages: 'GreatPages',
+      pages: 'Páginas',
+    },
+    profile: {
+      usedCredits: 'Créditos usados',
+      loggingOut: 'Saindo da sua conta...',
+      logout: 'Sair',
+    },
+    usersSelector: {
+      title: 'Usuários',
+      add: 'Adicionar',
+      searchPlaceholder: 'Busque aqui',
+      empty: 'Nenhum usuário encontrado.',
+      noResults: 'Nenhum resultado encontrado.',
+      addToProject: 'Adicionar ao projeto',
+      removeFromProject: 'Remover do projeto',
+      manageTeam: 'Gerenciar equipe',
+    },
+  },
+
+  // Componente: NotFoundPage.tsx.
+  notFound: {
+    title: 'Página não foi encontrada!',
+    description: 'A página que você está procurando não existe. Verifique se digitou corretamente o link que está procurando.',
+    backToHome: 'Voltar para o início',
+  },
+} as const;
+
+export default messages;

package/src/i18n/normalize.ts

@@ -0,0 +1,15 @@
+import { Locale } from './config';
+
+/**
+ * Normaliza um identificador de idioma vindo da API (`user.language`, ex.: `pt-br`, `en`, `es`)
+ * ou de um header BCP-47 (`pt-BR`, `en-US`, `es-419`) para um {@link Locale} suportado.
+ * Retorna `null` quando não reconhece o idioma.
+ */
+export function normalizeLocale(input?: string | null): Locale | null {
+  if (!input) return null;
+  const value = input.trim().toLowerCase();
+  if (value.startsWith('pt')) return 'pt-br';
+  if (value.startsWith('es')) return 'es-es';
+  if (value.startsWith('en')) return 'en-us';
+  return null;
+}

package/src/i18n/resolve-locale.ts

@@ -0,0 +1,77 @@
+import 'server-only';
+
+import { cookies, headers } from 'next/headers';
+import { DEFAULT_LOCALE, Locale, LOCALE_COOKIE } from './config';
+import { localeFromCountry } from './country-language';
+import { normalizeLocale } from './normalize';
+
+const AUTH_COOKIE = 'greatapps';
+const GEO_HEADER = 'cf-ipcountry';
+const DEFAULT_WHITELABEL_ID = 1;
+
+interface JwtLocaleInfo {
+  id_wl?: number;
+  country?: string | null;
+}
+
+/** Lê id_wl e país do JWT sem custo de rede (best-effort). */
+function decodeJwtLocaleInfo(token?: string | null): JwtLocaleInfo | null {
+  if (!token) return null;
+  try {
+    const payload = JSON.parse(atob(token.split('.')[1]));
+    return {
+      id_wl: payload?.id_wl != null ? Number(payload.id_wl) : undefined,
+      country: payload?.session?.location?.country ?? null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+export interface ResolveLocaleOptions {
+  /**
+   * Whitelabel id já resolvido (ex.: via `findWhitelabel()`), com prioridade sobre o JWT.
+   * Permite detectar domínio whitelabel mesmo para visitante não-logado.
+   */
+  whitelabelId?: number | null;
+  /** Idioma da conta (`user.language`), quando já conhecido pelo chamador. */
+  userLanguage?: string | null;
+}
+
+/**
+ * Resolve o locale da requisição (server-side). Ordem de prioridade:
+ *
+ * 1. **Whitelabel não-padrão** (`id_wl != 1`) → `pt` (por enquanto, whitelabels não são localizadas).
+ * 2. **Preferência da conta** (`userLanguage`), quando fornecida.
+ * 3. **Cookie `NEXT_LOCALE`** — cache da preferência ou escolha manual do visitante.
+ * 4. **Inferência por país** — JWT (`session.location.country`) ou header `CF-IPCountry`.
+ * 5. **Fallback** → {@link DEFAULT_LOCALE}.
+ */
+export async function resolveLocale(options: ResolveLocaleOptions = {}): Promise<Locale> {
+  const cookieStore = await cookies();
+  const token = process.env.DUMMY_AUTH_TOKEN || cookieStore.get(AUTH_COOKIE)?.value;
+  const jwt = decodeJwtLocaleInfo(token);
+
+  // 1. Whitelabel não-padrão → português
+  const whitelabelId = options.whitelabelId ?? jwt?.id_wl ?? null;
+  if (whitelabelId != null && whitelabelId !== DEFAULT_WHITELABEL_ID) {
+    return 'pt-br';
+  }
+
+  // 2. Preferência explícita da conta
+  const fromUser = normalizeLocale(options.userLanguage);
+  if (fromUser) return fromUser;
+
+  // 3. Cookie persistido
+  const fromCookie = normalizeLocale(cookieStore.get(LOCALE_COOKIE)?.value);
+  if (fromCookie) return fromCookie;
+
+  // 4. Inferência por país (geo)
+  const headersList = await headers();
+  const country = jwt?.country ?? headersList.get(GEO_HEADER);
+  const fromGeo = localeFromCountry(country);
+  if (fromGeo) return fromGeo;
+
+  // 5. Fallback
+  return DEFAULT_LOCALE;
+}

package/src/i18n.ts

@@ -0,0 +1,10 @@
+/**
+ * Barril client-safe de i18n (`@greatapps/common/i18n`).
+ * NÃO exporta `resolveLocale` (server-only) — esse vem de `@greatapps/common/server`.
+ */
+export { LOCALES, DEFAULT_LOCALE, LOCALE_COOKIE, isLocale } from './i18n/config';
+export type { Locale } from './i18n/config';
+export { normalizeLocale } from './i18n/normalize';
+export { localeFromCountry } from './i18n/country-language';
+export { getCommonMessages } from './i18n/messages';
+export type { CommonMessages } from './i18n/messages';

package/src/index.ts

@@ -137,7 +137,10 @@ export type {
   PlanTooltips,
 } from "./modules/plans/types/plan.type";
 export { PlanSchema, PlanItemSchema } from "./modules/plans/types/plan.type";
-export { mapApiPlanToUiPlan } from "./modules/plans/utils/map-api-plan-to-ui";
+export {
+  mapApiPlanToUiPlan,
+  mapApiPlanToUiPlanForCurrency,
+} from "./modules/plans/utils/map-api-plan-to-ui";
 export type { PlanBillingPeriod } from "./modules/plans/utils/map-api-plan-to-ui";
 export {
   usePlans,
@@ -205,6 +208,7 @@ export { CannotDeleteCardModal } from "./components/modals/cards/CannotDeleteCar
 export {
   CardFormFields,
   cardFormSchema,
+  buildCardFormSchema,
 } from "./components/modals/cards/CardFormFields";
 export type { CardFormData } from "./components/modals/cards/CardFormFields";
 export { Skeleton } from "./components/ui/feedback/Skeleton";
@@ -462,7 +466,13 @@ export {
   formatCNPJ,
   formatCardNumber,
 } from "./utils/format/masks";
-export { formatCurrencyNumber } from "./utils/format/currency";
+export {
+  formatCurrency,
+  formatCurrencyNumber,
+  parseCurrencyToNumber,
+  getCurrencyForGateway,
+} from "./utils/format/currency";
+export type { CurrencyCode } from "./utils/format/currency";
 export { BR_STATE_OPTIONS } from "./utils/constants/br-states";
 export type { TimezoneOption } from "./modules/accounts/services/timezone.service";
 export {
@@ -486,6 +496,7 @@ export {
   useCurrentAccount,
   ACCOUNT_QUERY_KEY,
 } from "./modules/accounts/hooks/current-account.hook";
+export { useCurrencyFormatter } from "./modules/accounts/hooks/use-currency-formatter.hook";
 export {
   useUpdateAccount,
   useUpdateAccountUser,