@hed-hog/core 0.0.398 → 0.0.400

package/hedhog/frontend/app/configurations/[slug]/components/setting-field.tsx.ejs

@@ -25,6 +25,7 @@ import { cn } from '@/lib/utils';
 import {
   Setting,
   SettingComponentEnum,
+  type SettingEntityFilter,
   SettingTypeEnum,
 } from '@hed-hog/api-types';
 import { useApp } from '@hed-hog/next-app-provider';
@@ -77,194 +78,49 @@ function getLocalizedIntegrationName(
   );
 }
 
-type IntegrationProfileSettingConfig = {
-  /**
-   * Tipo de perfil aceito pela setting. Filtra a listagem do picker e trava o
-   * sheet de criação. Ausente só na rede de segurança, onde listamos tudo.
-   */
-  typeSlug?: string;
-  /** Estreita para um provider específico (OAuth, Kubernetes). */
-  providerSlug?: string;
-  /** Providers a esconder mesmo sendo do tipo certo. */
-  excludeProviders?: string[];
-  /** Substantivo usado nos rótulos dos botões editar/criar. */
-  profileNameKey?: string;
-};
+const asProfileSlug = (value: unknown) =>
+  typeof value === 'string' && value.trim() ? value.trim() : undefined;
 
 /**
- * Settings cujo valor é o SLUG de um integration_profile — o sufixo `-id` é
- * histórico, nenhuma delas guarda o id numérico. Uma entrada aqui é tudo que
- * uma setting nova precisa para ganhar o picker completo; sem ela o campo cai
- * na rede de segurança de `getIntegrationProfileSettingConfig` (picker sem
- * filtro de tipo).
- *
- * Deve espelhar `SELECT slug FROM setting WHERE component = 'entity-picker'`.
+ * `entity_filter` chega como objeto — o Prisma desserializa o `jsonb` e o Nest
+ * serializa de volta —, mas aceitamos string JSON porque uma instalação cuja
+ * coluna seja texto continuaria válida. Qualquer coisa fora do formato vira
+ * `null` e cai na rede de segurança, em vez de derrubar a tela inteira de
+ * configurações por causa de uma linha torta no banco.
  */
-const INTEGRATION_PROFILE_SETTINGS: Record<
-  string,
-  IntegrationProfileSettingConfig
-> = {
-  // IA
-  'ai-openai-profile-id': { typeSlug: 'ai' },
-  'ai-gemini-profile-id': { typeSlug: 'ai' },
-  'ai-deepseek-profile-id': { typeSlug: 'ai' },
-  'mcp-ai-profile-id': { typeSlug: 'ai' },
-  'richtext-ai-profile-id': { typeSlug: 'ai' },
-  'lms-ai-course-generation-profile-id': { typeSlug: 'ai' },
-  'lms-ai-lesson-xp-profile-id': { typeSlug: 'ai' },
-  'lms-ai-transcription-profile-id': { typeSlug: 'ai' },
-  'lms-ai-course-image-profile-id': { typeSlug: 'ai' },
-  'lms-ai-discussion-reply-profile-id': { typeSlug: 'ai' },
-  'sac.ai.integration-profile-id': { typeSlug: 'ai' },
-  // Transcrição de áudio só existe na OpenAI; oferecer Gemini ou Claude aqui
-  // deixaria escolher um perfil que o worker recusa.
-  'sac.whatsapp.transcription-profile-id': {
-    typeSlug: 'ai',
-    providerSlug: 'openai',
-  },
-  'campaign.ai.integration-profile-id': { typeSlug: 'ai' },
-
-  // E-mail. O IMAP é do tipo `email` mas só serve para receber:
-  // `buildMailConfigFromIntegration` recusa usá-lo no envio, então oferecê-lo
-  // aqui seria deixar escolher um perfil que o backend rejeita depois.
-  'mail-integration-profile-id': {
-    typeSlug: 'email',
-    excludeProviders: ['imap'],
-  },
-  'lms-discussion-notify-email-profile-id': {
-    typeSlug: 'email',
-    excludeProviders: ['imap'],
-  },
-  'lms-digest-notify-email-profile-id': {
-    typeSlug: 'email',
-    excludeProviders: ['imap'],
-  },
-  'lms-celebration-notify-email-profile-id': {
-    typeSlug: 'email',
-    excludeProviders: ['imap'],
-  },
-  'lms-class-reminder-notify-email-profile-id': {
-    typeSlug: 'email',
-    excludeProviders: ['imap'],
-  },
-  'operations.daily-report.email-integration-profile-id': {
-    typeSlug: 'email',
-    excludeProviders: ['imap'],
-  },
-  'operations.approval-notifications.email-integration-profile-id': {
-    typeSlug: 'email',
-    excludeProviders: ['imap'],
-  },
-
-  // WhatsApp
-  'lms-discussion-notify-whatsapp-profile-id': { typeSlug: 'whatsapp' },
-  'lms-digest-notify-whatsapp-profile-id': { typeSlug: 'whatsapp' },
-  'lms-celebration-notify-whatsapp-profile-id': { typeSlug: 'whatsapp' },
-  'lms-class-reminder-notify-whatsapp-profile-id': { typeSlug: 'whatsapp' },
-  'operations.daily-report.whatsapp-integration-profile-id': {
-    typeSlug: 'whatsapp',
-  },
-  'operations.approval-notifications.whatsapp-integration-profile-id': {
-    typeSlug: 'whatsapp',
-  },
-  'sac.notify-whatsapp-profile-id': { typeSlug: 'whatsapp' },
-
-  // Armazenamento
-  'file-storage-profile-id': { typeSlug: 'storage' },
-  'lms-bulk-upload-storage-profile-id': { typeSlug: 'storage' },
-
-  // OAuth — um provider por setting
-  'oauth-google-profile-id': {
-    typeSlug: 'oauth',
-    providerSlug: 'google-oauth',
-  },
-  'oauth-facebook-profile-id': {
-    typeSlug: 'oauth',
-    providerSlug: 'facebook-oauth',
-  },
-  'oauth-github-profile-id': {
-    typeSlug: 'oauth',
-    providerSlug: 'github-oauth',
-  },
-  'oauth-microsoft-profile-id': {
-    typeSlug: 'oauth',
-    providerSlug: 'microsoft-oauth',
-  },
-  'oauth-microsoft-entra-id-profile-id': {
-    typeSlug: 'oauth',
-    providerSlug: 'microsoft-entra-id-oauth',
-  },
-  'oauth-apple-profile-id': { typeSlug: 'oauth', providerSlug: 'apple-oauth' },
-  'oauth-linkedin-profile-id': {
-    typeSlug: 'oauth',
-    providerSlug: 'linkedin-oauth',
-  },
-
-  // Pagamento. O Google Play só cobra por compra dentro do app Android
-  // (`commerce-android-checkout-mode`), então escolhê-lo como gateway padrão
-  // quebraria o checkout do site. O backend também recusa — isto é só para não
-  // oferecer.
-  'commerce-default-payment-profile-id': {
-    typeSlug: 'payment',
-    excludeProviders: ['google_play'],
-  },
-
-  // Infraestrutura
-  'scaling.video.integration_profile_id': { typeSlug: 'infrastructure' },
-  'hedhog.k8s_integration_profile_id': {
-    typeSlug: 'infrastructure',
-    providerSlug: 'kubernetes',
-    profileNameKey: 'profileTypeNames.kubernetes',
-  },
-};
+function parseEntityFilter(raw: unknown): SettingEntityFilter | null {
+  let value = raw;
 
-/** Chaves de tradução do picker, por tipo de perfil. */
-const PROFILE_TYPE_TRANSLATION_KEYS: Record<
-  string,
-  { placeholder: string; emptyState: string; name: string }
-> = {
-  ai: {
-    placeholder: 'selectAiProfile',
-    emptyState: 'aiProfileEmptyState',
-    name: 'profileTypeNames.ai',
-  },
-  email: {
-    placeholder: 'selectMailProfile',
-    emptyState: 'mailProfileEmptyState',
-    name: 'profileTypeNames.email',
-  },
-  whatsapp: {
-    placeholder: 'selectWhatsAppProfile',
-    emptyState: 'whatsappProfileEmptyState',
-    name: 'profileTypeNames.whatsapp',
-  },
-  storage: {
-    placeholder: 'selectStorageProfile',
-    emptyState: 'storageProfileEmptyState',
-    name: 'profileTypeNames.storage',
-  },
-  oauth: {
-    placeholder: 'selectOAuthProfile',
-    emptyState: 'oauthProfileEmptyState',
-    name: 'profileTypeNames.oauth',
-  },
-  payment: {
-    placeholder: 'selectPaymentProfile',
-    emptyState: 'paymentProfileEmptyState',
-    name: 'profileTypeNames.payment',
-  },
-  infrastructure: {
-    placeholder: 'selectInfraProfile',
-    emptyState: 'infraProfileEmptyState',
-    name: 'profileTypeNames.infrastructure',
-  },
-};
+  if (typeof value === 'string') {
+    const trimmed = value.trim();
+    if (!trimmed) {
+      return null;
+    }
 
-const GENERIC_PROFILE_TRANSLATION_KEYS = {
-  placeholder: 'selectIntegrationProfile',
-  emptyState: 'integrationProfileEmptyState',
-  name: 'profileTypeNames.generic',
-};
+    try {
+      value = JSON.parse(trimmed);
+    } catch {
+      return null;
+    }
+  }
+
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return null;
+  }
+
+  const source = value as Record<string, unknown>;
+  const excludeProviders = Array.isArray(source.excludeProviders)
+    ? source.excludeProviders
+        .map(asProfileSlug)
+        .filter((slug): slug is string => Boolean(slug))
+    : undefined;
+
+  return {
+    typeSlug: asProfileSlug(source.typeSlug),
+    providerSlug: asProfileSlug(source.providerSlug),
+    ...(excludeProviders?.length ? { excludeProviders } : {}),
+  };
+}
 
 /**
  * Convenção de nome das settings que guardam um perfil: `...-profile-id`,
@@ -273,49 +129,64 @@ const GENERIC_PROFILE_TRANSLATION_KEYS = {
 const PROFILE_SETTING_SLUG_PATTERN =
   /(^|[.\-_])(integration[-_])?profile[-_]id$/;
 
-const warnedUnmappedProfileSettings = new Set<string>();
+const warnedUnfilteredProfileSettings = new Set<string>();
 
 /** Settings cujo valor exibido precisa ser resolvido a partir do slug salvo. */
-function isIntegrationProfileSetting(settingSlug: string) {
+function isIntegrationProfileSetting(setting: Setting) {
   return (
-    settingSlug in INTEGRATION_PROFILE_SETTINGS ||
-    PROFILE_SETTING_SLUG_PATTERN.test(settingSlug)
+    parseEntityFilter(setting.entity_filter) !== null ||
+    PROFILE_SETTING_SLUG_PATTERN.test(setting.slug)
   );
 }
 
 /**
- * Config do picker para uma setting `entity-picker`. Slug fora do registry mas
- * com cara de campo de perfil ainda ganha um picker — sem filtro de tipo, mas
- * melhor do que obrigar o administrador a digitar o slug à mão (era o que
- * acontecia com `sac.ai.integration-profile-id`). `null` = não é campo de
- * perfil, renderiza como texto.
+ * Filtro do picker de uma setting `entity-picker`, vindo da coluna
+ * `setting.entity_filter` — declarada no `setting_group.yaml` da biblioteca
+ * dona da setting.
+ *
+ * Antes disto o filtro vivia num `Record` hardcoded aqui, indexado por slug, e
+ * toda setting nova nascia sem filtro porque ninguém lembrava de voltar a este
+ * arquivo para cadastrá-la: o campo de frete oferecia perfil de e-mail e de
+ * OAuth para escolher transportadora.
+ *
+ * Sem filtro no banco (migration ainda não aplicada, ou biblioteca que esqueceu
+ * de declarar) o campo ainda ganha um picker, só que listando perfis de todos
+ * os tipos — ruim, mas melhor do que obrigar o administrador a digitar o slug
+ * do perfil à mão. `null` = não é campo de perfil, renderiza como texto.
  */
 function getIntegrationProfileSettingConfig(
-  settingSlug: string
-): IntegrationProfileSettingConfig | null {
-  const config = INTEGRATION_PROFILE_SETTINGS[settingSlug];
-  if (config) {
-    return config;
+  setting: Setting
+): SettingEntityFilter | null {
+  const filter = parseEntityFilter(setting.entity_filter);
+  if (filter?.typeSlug) {
+    return filter;
   }
 
-  if (!PROFILE_SETTING_SLUG_PATTERN.test(settingSlug)) {
+  if (!PROFILE_SETTING_SLUG_PATTERN.test(setting.slug)) {
     return null;
   }
 
   if (
     process.env.NODE_ENV !== 'production' &&
-    !warnedUnmappedProfileSettings.has(settingSlug)
+    !warnedUnfilteredProfileSettings.has(setting.slug)
   ) {
-    warnedUnmappedProfileSettings.add(settingSlug);
+    warnedUnfilteredProfileSettings.add(setting.slug);
     console.warn(
-      `[setting-field] "${settingSlug}" não está em INTEGRATION_PROFILE_SETTINGS; ` +
-        'listando perfis de integração de todos os tipos.'
+      `[setting-field] "${setting.slug}" não tem \`entity_filter\`; declare-o ` +
+        'no `setting_group.yaml` da biblioteca e espelhe numa migration. ' +
+        'Listando perfis de integração de todos os tipos.'
     );
   }
 
-  return {};
+  return filter ?? {};
 }
 
+/**
+ * Chaves de tradução do picker, derivadas do tipo do perfil. Um tipo novo custa
+ * três strings em `messages/core/*.json` e nenhuma linha de código aqui.
+ */
+const GENERIC_PROFILE_TYPE_KEY = 'profileTypes.generic';
+
 export const SettingField = ({ setting, className }: SettingFieldProps) => {
   const t = useTranslations('core.Configurations');
   const {
@@ -410,8 +281,13 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
     };
   }, [localValue]);
 
+  // Booleano em vez de `setting` na lista de dependências: o objeto da setting
+  // troca de identidade a cada render do pai e dispararia a resolução do rótulo
+  // de novo a cada vez.
+  const isProfileSetting = isIntegrationProfileSetting(setting);
+
   useEffect(() => {
-    if (!isIntegrationProfileSetting(setting.slug)) {
+    if (!isProfileSetting) {
       setStorageProfileSelectedLabel('');
       setResolvedProfileId(null);
       return;
@@ -452,7 +328,7 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
     return () => {
       isCurrent = false;
     };
-  }, [localValue, request, setting.slug]);
+  }, [localValue, request, isProfileSetting]);
 
   const handleChangeValue = (newValue: string, immediate = false) => {
     setLocalValue(newValue);
@@ -582,7 +458,7 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
             size="icon"
             className="absolute right-1 top-1/2 h-8 w-8 -translate-y-1/2"
             onClick={() => setShowSecretValue((prev) => !prev)}
-            aria-label={showSecretValue ? t('hidePassword') : t('showPassword')}
+            tooltip={showSecretValue ? t('hidePassword') : t('showPassword')}
           >
             {showSecretValue ? (
               <EyeOff className="h-4 w-4" />
@@ -672,6 +548,7 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
               onClick={() => fileInputRef.current?.click()}
               disabled={isUploading}
               className="shrink-0"
+              tooltip={t('uploadFile')}
             >
               <Upload className="h-4 w-4" />
             </Button>
@@ -851,7 +728,7 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
     }
 
     case SettingComponentEnum.ENTITY_PICKER: {
-      const profileConfig = getIntegrationProfileSettingConfig(setting.slug);
+      const profileConfig = getIntegrationProfileSettingConfig(setting);
 
       if (!profileConfig) {
         isTextInputRef.current = true;
@@ -866,12 +743,17 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
       }
 
       const { typeSlug, providerSlug, excludeProviders } = profileConfig;
-      const translationKeys =
-        (typeSlug && PROFILE_TYPE_TRANSLATION_KEYS[typeSlug]) ||
-        GENERIC_PROFILE_TRANSLATION_KEYS;
-      const profileName = t(
-        profileConfig.profileNameKey ?? translationKeys.name
-      );
+      // Um tipo sem tradução própria (ou sem filtro nenhum) cai no genérico.
+      const profileTypeKey =
+        typeSlug && t.has(`profileTypes.${typeSlug}.placeholder`)
+          ? `profileTypes.${typeSlug}`
+          : GENERIC_PROFILE_TYPE_KEY;
+      // Provider com nome próprio (Kubernetes) manda no rótulo dos botões;
+      // sem ele, o substantivo é o do tipo.
+      const profileName =
+        providerSlug && t.has(`profileProviders.${providerSlug}`)
+          ? t(`profileProviders.${providerSlug}`)
+          : t(`${profileTypeKey}.name`);
 
       // O picker exibe o nome do perfil, mas a setting guarda o slug.
       const applyProfile = (
@@ -890,8 +772,8 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
         <>
           <div className="flex w-full min-w-0 items-center gap-2 md:max-w-72">
             <EntityPicker<IntegrationProfileOption & Record<string, unknown>>
-              placeholder={t(translationKeys.placeholder)}
-              emptyStateDescription={t(translationKeys.emptyState)}
+              placeholder={t(`${profileTypeKey}.placeholder`)}
+              emptyStateDescription={t(`${profileTypeKey}.emptyState`)}
               value={parsedValue || null}
               onChange={(slug, option) =>
                 applyProfile(
@@ -967,8 +849,7 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
                 setIsStorageProfileSheetOpen(true);
               }}
               disabled={!resolvedProfileId}
-              aria-label={t('editProfileAria', { profile: profileName })}
-              title={t('editProfileAria', { profile: profileName })}
+              tooltip={t('editProfileAria', { profile: profileName })}
             >
               <Pencil className="h-4 w-4" />
             </Button>
@@ -982,8 +863,7 @@ export const SettingField = ({ setting, className }: SettingFieldProps) => {
                 setStorageProfileEditingId(null);
                 setIsStorageProfileSheetOpen(true);
               }}
-              aria-label={t('createProfileAria', { profile: profileName })}
-              title={t('createProfileAria', { profile: profileName })}
+              tooltip={t('createProfileAria', { profile: profileName })}
             >
               <Plus className="h-4 w-4" />
             </Button>

package/hedhog/frontend/app/configurations/[slug]/page.tsx.ejs

@@ -13,9 +13,20 @@ import { Setting, SettingSubgroup } from '@hed-hog/api-types';
 import { useApp, useQuery } from '@hed-hog/next-app-provider';
 import { Loader } from 'lucide-react';
 import { useParams } from 'next/navigation';
-import { useMemo } from 'react';
+import { ComponentType, useMemo } from 'react';
+import { ImageOptimizationAction } from './components/image-optimization-action';
 import { SettingField } from './components/setting-field';
 
+/**
+ * Ações que não são settings, ancoradas ao subgrupo a que pertencem. A tela é montada a
+ * partir dos dados, então este mapa é o único ponto de escape: sem ele, uma manutenção
+ * que só faz sentido ao lado das suas settings (reprocessar as imagens que já estão no
+ * storage, por exemplo) não teria onde morar.
+ */
+const SUBGROUP_ACTIONS: Record<string, ComponentType> = {
+  'image-optimization': ImageOptimizationAction,
+};
+
 type SettingSection = {
   key: string;
   subgroupId: number | null;
@@ -166,6 +177,13 @@ export default function Page() {
                       </div>
                     </div>
                   ))}
+
+                  {(() => {
+                    const Action = section.subgroup?.slug
+                      ? SUBGROUP_ACTIONS[section.subgroup.slug]
+                      : undefined;
+                    return Action ? <Action /> : null;
+                  })()}
                 </CardContent>
               </Card>
             );

package/hedhog/frontend/app/configurations/layout.tsx.ejs

@@ -25,6 +25,11 @@ import {
   SelectTrigger,
   SelectValue,
 } from '@/components/ui/select';
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from '@/components/ui/tooltip';
 import { cn } from '@/lib/utils';
 import { PaginatedResult } from '@/types/pagination-result';
 import { SettingGroup } from '@hed-hog/api-types';
@@ -243,11 +248,20 @@ export default function ConfigurationsLayout({ children }: IProps) {
         extraContent={
           <>
             <DropdownMenu>
-              <DropdownMenuTrigger asChild>
-                <Button variant="outline" size="icon">
-                  <MenuIcon />
-                </Button>
-              </DropdownMenuTrigger>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <DropdownMenuTrigger asChild>
+                    <Button
+                      variant="outline"
+                      size="icon"
+                      aria-label={t('menuActions')}
+                    >
+                      <MenuIcon />
+                    </Button>
+                  </DropdownMenuTrigger>
+                </TooltipTrigger>
+                <TooltipContent>{t('menuActions')}</TooltipContent>
+              </Tooltip>
               <DropdownMenuContent align="end">
                 <DropdownMenuItem onClick={() => setExportDialogOpen(true)}>
                   <span className="flex items-center gap-2">

package/hedhog/frontend/app/dashboard/[slug]/widget-renderer.tsx.ejs

@@ -261,8 +261,7 @@ export const WidgetRenderer = ({
           variant="ghost"
           size="icon"
           className="no-drag absolute right-17 top-3 z-30 size-6 cursor-pointer shrink-0 opacity-0 transition-opacity group-hover:opacity-100"
-          title={t('saveWidgetPreview')}
-          aria-label={t('saveWidgetPreview')}
+          tooltip={t('saveWidgetPreview')}
           data-widget-action="true"
           onClick={(event) => {
             event.stopPropagation();
@@ -278,12 +277,7 @@ export const WidgetRenderer = ({
         variant="ghost"
         size="icon"
         className="no-drag absolute right-10 top-3 z-30 size-6 cursor-pointer shrink-0 opacity-0 transition-opacity group-hover:opacity-100"
-        title={
-          isGeneratingScreenshot
-            ? t('generatingWidgetScreenshot')
-            : t('generateWidgetScreenshot')
-        }
-        aria-label={
+        tooltip={
           isGeneratingScreenshot
             ? t('generatingWidgetScreenshot')
             : t('generateWidgetScreenshot')

package/hedhog/frontend/app/dashboard/components/dynamic-widget.tsx.ejs

@@ -5,6 +5,7 @@ import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
 import { cn } from '@/lib/utils';
 import * as TablerIcons from '@tabler/icons-react';
 import { IconGripVertical, IconX } from '@tabler/icons-react';
+import { useTranslations } from 'next-intl';
 import { ComponentType } from 'react';
 
 interface DynamicWidgetProps {
@@ -28,6 +29,7 @@ export function DynamicWidget({
   onRemove,
   className,
 }: DynamicWidgetProps) {
+  const t = useTranslations('core.DashboardPage');
   // Dynamically get icon from Tabler Icons
   const Icon: ComponentType<{ className?: string }> | null = iconName
     ? (TablerIcons as any)[iconName] || null
@@ -63,6 +65,7 @@ export function DynamicWidget({
                 e.preventDefault();
                 onRemove();
               }}
+              tooltip={t('removeWidget')}
             >
               <IconX className="size-3" />
             </Button>

package/hedhog/frontend/app/dashboard/components/widget-wrapper.tsx.ejs

@@ -38,6 +38,7 @@ export function WidgetWrapper({
                 e.preventDefault();
                 onRemove();
               }}
+              tooltip={t('removeWidget')}
             >
               <IconX className="size-3" />
             </Button>
@@ -67,6 +68,7 @@ export function WidgetWrapper({
               e.preventDefault();
               onRemove();
             }}
+            tooltip={t('removeWidget')}
           >
             <IconX className="size-3" />
           </Button>
@@ -104,6 +106,7 @@ export function WidgetWrapper({
               e.preventDefault();
               onRemove();
             }}
+            tooltip={t('removeWidget')}
           >
             <IconX className="size-3" />
           </Button>
@@ -140,6 +143,7 @@ export function WidgetWrapper({
             e.preventDefault();
             onRemove();
           }}
+          tooltip={t('removeWidget')}
         >
           <IconX className="size-3" />
         </Button>