@greatapps/common 1.1.666 → 1.1.668

package/src/i18n/messages/es-es.ts

@@ -0,0 +1,235 @@
+/**
+ * Catálogo de traducción es-es para los componentes de @greatapps/common.
+ * Las apps consumidoras combinan este objeto bajo el namespace `common`.
+ * Refleja la estructura de módulos de `pt-br.ts` (la fuente de verdad).
+ */
+const messages = {
+  actions: {
+    save: 'Guardar',
+    saveChanges: 'Guardar cambios',
+    cancel: 'Cancelar',
+    confirm: 'Confirmar',
+    delete: 'Eliminar',
+    edit: 'Editar',
+    close: 'Cerrar',
+    back: 'Volver',
+    continue: 'Continuar',
+    add: 'Agregar',
+    remove: 'Quitar',
+    search: 'Buscar',
+    loading: 'Cargando...',
+    saving: 'Guardando...',
+    sending: 'Enviando...',
+    copy: 'Copiar',
+    copied: 'Copiado',
+  },
+
+  validations: {
+    required: 'Campo obligatorio',
+    invalidEmail: 'Correo electrónico inválido',
+    invalidPhone: 'Teléfono inválido',
+  },
+
+  preferences: {
+    title: 'Preferencias',
+    companyName: 'Nombre de la empresa',
+    companyNamePlaceholder: 'Ingrese el nombre de la empresa',
+    language: 'Idioma',
+    languagePlaceholder: 'Seleccione el idioma',
+    languageSearch: 'Buscar idioma...',
+    currency: 'Moneda',
+    currencyPlaceholder: 'Seleccione la moneda',
+    currencySearch: 'Buscar moneda...',
+    timeDisplay: 'Visualización de hora',
+    timezone: 'Zona horaria',
+    timezonePlaceholder: 'Seleccione la zona horaria',
+    timezoneSearch: 'Buscar zona horaria...',
+    timeFormat: 'Formato de hora',
+    timeFormatPlaceholder: 'Seleccione el formato',
+    timeFormatOptions: {
+      h24: '24 horas',
+      h12: '12 horas (AM/PM)',
+    },
+    savedSuccess: 'Preferencias guardadas con éxito',
+    saveError: 'Error al guardar las preferencias',
+  },
+
+  account: {
+    deleteAccount: {
+      title: 'Eliminar cuenta',
+      description:
+        'Esta acción es <b>irreversible</b>. Al confirmar, su cuenta y todos sus datos serán eliminados.',
+      reasonLabel: 'Motivo de la cancelación',
+      reasonPlaceholder: 'Seleccionar',
+      descriptionLabel: 'Describa qué lo llevó a tomar esta decisión',
+      descriptionPlaceholder: 'Explique su decisión...',
+      charactersCount: '{count}/400 caracteres',
+      passwordLabel: 'Contraseña',
+      passwordPlaceholder: 'Ingrese su contraseña',
+      submit: 'Eliminar cuenta',
+      requiredFields: 'Complete todos los campos obligatorios',
+      reasons: {
+        noFeature: 'La herramienta no tiene una función que necesito',
+        technical: 'Encontré problemas técnicos o errores en el sistema',
+        support: 'Tuve problemas con el soporte o atención al cliente',
+        updates: 'Las actualizaciones tardan más de lo esperado',
+        temporary: 'La cancelación es temporal',
+        other: 'Otro motivo',
+      },
+    },
+    confirmDelete: {
+      title: '¡Qué pena verte partir!',
+      warning:
+        'Todas sus <b>{count} páginas</b> serán eliminadas permanentemente. ¡Esta acción es <b>irreversible!</b>',
+      sessionExpired: 'Sesión expirada. Complete los campos nuevamente.',
+      success: 'Cuenta eliminada exitosamente',
+      error: 'Error al eliminar la cuenta. Intente nuevamente.',
+      keepAccount: 'Mantener mi cuenta',
+      deleteAnyway: 'Eliminar de todas formas',
+      deleting: 'Eliminando...',
+    },
+    cantDelete: {
+      title: 'No es posible eliminar la cuenta',
+      description:
+        'Tiene una suscripción activa. Para eliminar su cuenta, <b>primero cancele su suscripción</b> en la página Suscripción e intente nuevamente.',
+      confirm: 'Ok, entendido',
+      goToSubscription: 'Ir a suscripción',
+    },
+    twoFactor: {
+      title: 'Autenticación de dos factores',
+      instructions:
+        'Instale una aplicación autenticadora en su dispositivo móvil (p. ej., <link>Google Authenticator</link>), escanee el código QR al lado o copie la clave en la aplicación y, a continuación, ingrese el código de 6 dígitos generado para continuar.',
+      qrAlt: 'Código QR para autenticación de dos factores',
+      retry: 'Intentar de nuevo',
+      pasteDigits: 'Pegue los 6 dígitos abajo',
+      activating: 'Activando...',
+      activate: 'Activar autenticación',
+      recoveryTitle: 'Códigos de seguridad',
+      recoveryHeading: 'Guarde estos códigos de recuperación de emergencia',
+      recoveryText1:
+        'Si pierde acceso a su teléfono, no podrá iniciar sesión en su cuenta sin un código de dos factores.',
+      recoveryText2: 'Imprima, copie o escriba los códigos a continuación en un lugar seguro.',
+      copyCodes: 'Copiar códigos',
+      finish: 'Finalizar',
+      codesCopied: 'Códigos copiados correctamente',
+      generateError: 'Error al generar el código QR. Intente de nuevo.',
+      confirmError: 'Error al confirmar el código. Intente de nuevo.',
+      disableTitle: 'Desactivar autenticación 2FA',
+      disableDescription:
+        'Ingrese el código de 6 dígitos de su aplicación autenticadora para confirmar la desactivación.',
+      authenticatorCode: 'Código del autenticador',
+      disabling: 'Desactivando...',
+      disable: 'Desactivar 2FA',
+      disabledSuccess: 'Autenticación de dos factores desactivada',
+      disableError: 'Error al desactivar 2FA. Intente de nuevo.',
+      invalidCode: 'Código inválido',
+      codeResent: 'Código reenviado',
+      resendError: 'Error al reenviar el código. Intente de nuevo.',
+    },
+    profile: {
+      title: 'Mi perfil',
+      avatarAlt: 'Foto del usuario',
+      changePhoto: 'Cambiar foto',
+      name: 'Nombre',
+      namePlaceholder: 'Ingrese su nombre',
+      lastName: 'Apellido',
+      lastNamePlaceholder: 'Ingrese su apellido',
+      gender: 'Género',
+      genderPlaceholder: 'Seleccione su género',
+      genderOptions: {
+        male: 'Masculino',
+        female: 'Femenino',
+      },
+      phone: 'Teléfono',
+      change: 'Cambiar',
+      accessData: 'Datos de acceso',
+      email: 'Correo electrónico',
+      savedSuccess: 'Perfil actualizado exitosamente',
+      saveError: 'Error al actualizar el perfil',
+    },
+    otp: {
+      validationCode: 'Código de validación',
+      incorrectCode: 'Código incorrecto',
+      resend: 'Reenviar código',
+      resendIn: 'Reenviar en <b>{time}</b>',
+      validating: 'Validando...',
+    },
+    changeEmail: {
+      title: 'Cambiar correo electrónico',
+      confirm: 'Cambiar correo electrónico',
+      sentCodeTo: 'Enviamos un código de validación al correo electrónico <b>{email}.</b>',
+      updateTitle: 'Actualizar correo electrónico de contacto',
+      updateDescription:
+        'Indique su nuevo correo electrónico para mantener su información de contacto actualizada.',
+      newEmail: 'Nuevo correo electrónico',
+      newEmailPlaceholder: 'Ingrese su nuevo correo electrónico',
+      emailChanged: 'Correo electrónico cambiado exitosamente',
+      emailExistsError: 'El correo electrónico ya existe o ocurrió un error. Intente más tarde.',
+    },
+    changePhone: {
+      titleEdit: 'Cambiar teléfono',
+      titleAdd: 'Agregar teléfono',
+      sentCodeTo: 'Enviamos un código de validación al número actual <b>{phone}.</b>',
+      confirm: 'Cambiar teléfono',
+      updateTitle: 'Actualizar teléfono de contacto',
+      addTitle: 'Agregar teléfono de contacto',
+      updateDescription: 'Indique el nuevo número para mantener su información de contacto actualizada.',
+      addDescription: 'Indique su número de teléfono para contacto.',
+      newNumber: 'Nuevo número',
+      numberLabel: 'Número de teléfono',
+      phoneChanged: 'Teléfono cambiado',
+      phoneAdded: 'Teléfono agregado',
+      invalidNumber: 'Número de teléfono inválido',
+      saveError: 'Ocurrió un error al guardar el número de teléfono. Intente más tarde.',
+      numberExistsError: 'El número ya existe o ocurrió un error. Intente más tarde.',
+    },
+    security: {
+      title: 'Seguridad',
+      googleLinkedTitle: 'Cuenta Google vinculada',
+      googleLinkedDescription:
+        'Su cuenta está vinculada a Google. Si la desvincula, utilice "Olvidé mi contraseña" para restablecer una contraseña de acceso por correo electrónico.',
+      unlinking: 'Desvinculando...',
+      unlinkGoogle: 'Desvincular Google',
+      unlinkError: 'Error al desvincular la cuenta Google.',
+      deleteAccountDescription:
+        'Esta acción es permanente y no se puede deshacer. Todos sus datos, proyectos y configuraciones serán eliminados permanentemente.',
+      deleteMyAccount: 'Eliminar mi cuenta',
+    },
+    token: {
+      title: 'Token de la cuenta',
+      label: 'Token',
+      copySuccess: 'Token copiado correctamente',
+      copyError: 'No se pudo copiar el token',
+      info: 'Este token es exclusivo de su cuenta y permite el acceso a la API. No lo comparta con terceros.',
+      docsLink: 'Acceder a la documentación',
+    },
+    changePassword: {
+      title: 'Cambiar contraseña',
+      currentPassword: 'Contraseña actual',
+      currentPasswordPlaceholder: 'Ingrese su contraseña actual',
+      newPassword: 'Nueva contraseña',
+      newPasswordPlaceholder: 'Ingrese su nueva contraseña',
+      submit: 'Guardar nueva contraseña',
+      changeError: 'Error al cambiar la contraseña',
+      changedSuccess: 'Contraseña cambiada correctamente',
+      genericError: 'Error al cambiar la contraseña. Intente nuevamente.',
+    },
+    globalPreferences: {
+      title: 'Cambiar preferencias globales',
+      srDescription: 'Confirmación de cambio de preferencias globales de la cuenta',
+      warning:
+        'Está cambiando configuraciones que impactan <b>todos los usuarios de la cuenta</b>. ¿Desea confirmar?',
+    },
+    configurations: {
+      title: 'Configuración',
+    },
+  },
+
+  languages: {
+    'pt-br': 'Portugués (Brasil)',
+    'en-us': 'Inglés (EE. UU.)',
+    'es-es': 'Español',
+  },
+} as const;
+
+export default messages;

package/src/i18n/messages/index.ts

@@ -0,0 +1,24 @@
+import { DEFAULT_LOCALE, Locale } from '../config';
+import enUs from './en-us';
+import esEs from './es-es';
+import ptBr from './pt-br';
+
+const COMMON_MESSAGES: Record<Locale, Record<string, unknown>> = {
+  'pt-br': ptBr,
+  'en-us': enUs,
+  'es-es': esEs,
+};
+
+/**
+ * Forma das mensagens globais (derivada do pt-br, a fonte da verdade).
+ * Os apps usam este tipo para a type augmentation do next-intl (chaves `common.*` tipadas).
+ */
+export type CommonMessages = typeof ptBr;
+
+/**
+ * Mensagens dos componentes da @greatapps/common para o locale informado.
+ * Os apps mesclam o resultado sob o namespace `common` ao montar o catálogo do next-intl.
+ */
+export function getCommonMessages(locale: Locale): Record<string, unknown> {
+  return COMMON_MESSAGES[locale] ?? COMMON_MESSAGES[DEFAULT_LOCALE];
+}

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

@@ -0,0 +1,244 @@
+/**
+ * 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: {
+    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',
+    },
+  },
+
+  // Nomes dos idiomas exibidos no seletor.
+  languages: {
+    'pt-br': 'Português (Brasil)',
+    'en-us': 'Inglês (EUA)',
+    'es-es': 'Espanhol',
+  },
+} 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/providers/auth.provider.tsx

@@ -5,6 +5,7 @@ import {
   ReactNode,
   useCallback,
   useContext,
+  useEffect,
   useMemo,
 } from "react";
 import { useQueryClient } from "@tanstack/react-query";
@@ -41,8 +42,10 @@ import {
   useCurrentAccount,
   ACCOUNT_QUERY_KEY,
 } from "../modules/accounts/hooks/current-account.hook";
-import { useWhitelabelUrls } from "./whitelabel.provider";
+import { useWhitelabelUrls, useWhitelabel } from "./whitelabel.provider";
 import { useWlQueryKey } from "../hooks/useAuthQueryKey";
+import { normalizeLocale } from "../i18n/normalize";
+import { setLocaleCookie } from "../utils/intl/locale-cookie";
 
 interface AuthContextProps extends AuthState {
   login: (credentials: LoginRequest) => Promise<LoginResult>;
@@ -68,8 +71,17 @@ export function AuthProvider({ children }: AuthProviderProps) {
   const queryClient = useQueryClient();
   const setUserData = useSetUserData();
   const { accountsUrl, pagesUrl } = useWhitelabelUrls();
+  const { whitelabel } = useWhitelabel();
   const accountKey = useWlQueryKey([...ACCOUNT_QUERY_KEY]);
 
+  // Mantém o cookie NEXT_LOCALE alinhado à preferência da conta (login, sessão existente,
+  // atualização). Compartilhado entre subdomínios via domínio do whitelabel. A próxima
+  // navegação/requisição passa a resolver o locale pela preferência do usuário.
+  useEffect(() => {
+    const locale = normalizeLocale(user?.language);
+    if (locale) setLocaleCookie(locale, whitelabel?.domain);
+  }, [user?.language, whitelabel?.domain]);
+
   const { mutateAsync: loginMutate, isPending: isLogging } = useLogin();
   const { mutateAsync: registerMutate, isPending: isRegistering } =
     useRegister();

package/src/server.ts

@@ -74,6 +74,8 @@ export {
 // Server Utils
 export { getClientInfoFromRequest } from './infra/utils/client-info';
 export { getUserContext } from './modules/auth/utils/get-user-context';
+export { resolveLocale } from './i18n/resolve-locale';
+export type { ResolveLocaleOptions } from './i18n/resolve-locale';
 export { requireValidSession } from './modules/auth/utils/require-valid-session';
 export { requireTokenNotExpired } from './modules/auth/utils/require-token-not-expired';
 export { buildWlOverride, buildWlOverrideFromJwt } from './modules/auth/utils/build-wl-override';