@hed-hog/core 0.0.400 → 0.0.401

package/hedhog/data/setting_group.yaml

@@ -329,6 +329,7 @@
         component: entity-picker
         entity_filter:
           typeSlug: ai
+          providerSlug: openai
         name:
           en: OpenAI Profile
           pt: Perfil OpenAI
@@ -345,6 +346,7 @@
         component: entity-picker
         entity_filter:
           typeSlug: ai
+          providerSlug: gemini
         name:
           en: Gemini Profile
           pt: Perfil Gemini
@@ -361,6 +363,7 @@
         component: entity-picker
         entity_filter:
           typeSlug: ai
+          providerSlug: deepseek
         name:
           en: DeepSeek Profile
           pt: Perfil DeepSeek
@@ -1213,6 +1216,11 @@
             # para o arquivo original em vez do arquivo em si.
             - value: Files.Read.All
               order: 15
+            # Necessario para o sistema PUBLICAR no chat da reuniao (o convite da
+            # chamada por codigo). E o unico escopo de ESCRITA em chat que
+            # usamos, e so a conta de servico precisa dele.
+            - value: Chat.ReadWrite
+              order: 16
         subgroup_id:
           where:
             slug: microsoft-entra-id
@@ -2658,4 +2666,48 @@
           pt: Cor hexadecimal principal para PDFs da área Research (padrão #9400B5)
         value: '#9400B5'
         user_override: false
+      - slug: pdf-legal-footer
+        type: string
+        component: input-text
+        name:
+          en: Legal Footer
+          pt: Rodapé Legal
+        description:
+          en: Line repeated in the footer of commercial documents, such as legal name, tax ID and address. Leave empty to show the company name.
+          pt: Linha repetida no rodapé dos documentos comerciais, como razão social, CNPJ e endereço. Deixe vazio para mostrar o nome da empresa.
+        value: ''
+        user_override: false
+      - slug: pdf-partner-line
+        type: string
+        component: input-text
+        name:
+          en: Partner Line
+          pt: Linha de Parceiros
+        description:
+          en: Short line printed on the cover of commercial proposals, such as partnerships or certifications. Leave empty to hide it.
+          pt: Linha curta impressa na capa das propostas comerciais, como parcerias ou certificações. Deixe vazio para ocultar.
+        value: ''
+        user_override: false
+      - slug: pdf-font-family
+        type: string
+        component: input-text
+        name:
+          en: Document Font
+          pt: Fonte dos Documentos
+        description:
+          en: CSS font stack for the body and titles of commercial documents.
+          pt: Pilha de fontes CSS para o corpo e os títulos dos documentos comerciais.
+        value: "'Inter', sans-serif"
+        user_override: false
+      - slug: pdf-font-mono
+        type: string
+        component: input-text
+        name:
+          en: Label Font
+          pt: Fonte dos Rótulos
+        description:
+          en: Monospace CSS font stack for labels, section numbers and the footer of commercial documents.
+          pt: Pilha de fontes CSS monoespaçada para rótulos, números de seção e rodapé dos documentos comerciais.
+        value: "'JetBrains Mono', monospace"
+        user_override: false
 

package/hedhog/frontend/messages/en.json

@@ -2666,9 +2666,12 @@
     "fieldBusinessId": "Business ID",
     "fieldAppId": "Meta App ID",
     "fieldAppSecret": "Meta App Secret",
+    "fieldInstagramAppId": "Instagram App ID (Instagram > API setup with Instagram login)",
+    "fieldInstagramAppSecret": "Instagram App Secret (Instagram > API setup with Instagram login)",
     "fieldWabaId": "WhatsApp Business Account ID (WABA)",
     "fieldVerifyToken": "Webhook Verify Token",
     "fieldGraphApiVersion": "Graph API Version",
+    "fieldLinkedInApiVersion": "LinkedIn API version (YYYYMM)",
     "fieldEnvironmentTest": "Test",
     "fieldEnvironmentProduction": "Production",
     "copiedToClipboard": "Copied to clipboard",
@@ -2832,7 +2835,57 @@
     "fileStored": "A file is stored and encrypted. Click to replace it.",
     "fileSelected": "New file selected. It will be encrypted on save.",
     "fieldRtdnServiceAccount": "Notifications Service Account (RTDN)",
-    "fieldRtdnAudience": "Notifications Audience (RTDN)"
+    "fieldRtdnAudience": "Notifications Audience (RTDN)",
+    "fieldLoginConfigId": "Login Configuration ID (Facebook Login for Business)",
+    "metaSocialSectionTitle": "Social network connection",
+    "metaSocialDescription": "This profile is the HedHog app on Meta. Pages and Instagram accounts are connected per brand, under Social → Brands → Channels.",
+    "metaSocialRedirectUriLabel": "OAuth redirect URI",
+    "metaSocialRedirectUriUnavailable": "Set NEXT_PUBLIC_API_BASE_URL to show the URI",
+    "metaSocialStepsTitle": "How to configure it in the Meta dashboard",
+    "metaSocialStep1": "Create a Business app and add Facebook Login for Business and the Instagram API with Facebook Login.",
+    "metaSocialStep2": "Create a Login Configuration of type \"User access token\" with the publishing permissions and paste its ID above.",
+    "metaSocialStep3": "Add the URI above to \"Valid OAuth Redirect URIs\".",
+    "metaSocialStep4": "Until App Review is approved, use Sandbox mode or only the app administrators and testers.",
+    "instagramSocialSectionTitle": "Instagram connection",
+    "instagramSocialDescription": "This profile is the HedHog app on the Instagram API with Instagram Login. Professional Instagram accounts (Business or Creator) are connected per brand, under Social → Brands → Channels, with or without a Facebook Page.",
+    "instagramSocialRedirectUriLabel": "OAuth redirect URI",
+    "instagramSocialRedirectUriUnavailable": "Set NEXT_PUBLIC_API_BASE_URL to show the URI",
+    "instagramSocialStepsTitle": "How to configure it in the Meta dashboard",
+    "instagramSocialStep1": "In the Meta app, add the Instagram product and open \"API setup with Instagram login\".",
+    "instagramSocialStep2": "Copy the Instagram app ID and Instagram app secret shown there and paste them above. They are not the Meta app ID and secret.",
+    "instagramSocialStep3": "Under \"Set up Instagram business login\" > Business login settings, add the URI above to \"OAuth redirect URIs\" exactly as shown, with no trailing slash.",
+    "instagramSocialStep4": "In the same settings, fill in the Deauthorize callback URL and the Data deletion request URL with the page of your privacy instructions.",
+    "instagramSocialStep5": "Until App Review is approved, add the accounts you will connect as Instagram testers of the app, or use Sandbox mode.",
+    "linkedinSocialSectionTitle": "LinkedIn connection",
+    "linkedinSocialDescription": "This profile is the HedHog app on the LinkedIn Community Management API. Company pages are connected per brand, under Social → Brands → Channels, by a member who is an administrator or content administrator of the page.",
+    "linkedinSocialRedirectUriLabel": "Authorized redirect URL",
+    "linkedinSocialRedirectUriUnavailable": "Set NEXT_PUBLIC_API_BASE_URL to show the URL",
+    "linkedinSocialStepsTitle": "How to configure it in the LinkedIn Developer Portal",
+    "linkedinSocialStep1": "Create a dedicated app, with no other products, linked to the company page and verified by a super admin of that LinkedIn Page.",
+    "linkedinSocialStep2": "In the Products tab, request the Community Management API. Access starts in the Development tier.",
+    "linkedinSocialStep3": "In the Auth tab, add the URL above to \"Authorized redirect URLs for your app\" exactly as shown, then copy the Client ID and Primary Client Secret and paste them above.",
+    "linkedinSocialStep4": "Before going to production, request the Standard tier, which requires a screencast of each use case of the app.",
+    "linkedinSocialStep5": "Until the Standard tier is approved, use Sandbox mode.",
+    "fieldOauthAppStatus": "OAuth consent screen status",
+    "fieldOauthAppStatusTesting": "Testing (the refresh token expires in 7 days and the channel must be reconnected)",
+    "fieldOauthAppStatusProduction": "In production (the refresh token does not expire in 7 days)",
+    "googleSocialSectionTitle": "Google connection",
+    "youtubeSocialDescription": "This profile is the HedHog project on Google Cloud for YouTube. Channels are connected per brand, under Social → Brands → Channels.",
+    "googleBusinessSocialDescription": "This profile is the HedHog project on Google Cloud for Google Business Profile. Locations are connected per brand, under Social → Brands → Channels.",
+    "googleSocialRedirectUriLabel": "OAuth authorized redirect URI",
+    "googleSocialRedirectUriUnavailable": "Set NEXT_PUBLIC_API_BASE_URL to show the URI",
+    "googleSocialStepsTitle": "How to configure it in the Google Cloud Console",
+    "youtubeSocialStep1": "Create a Google Cloud project just for YouTube and enable the YouTube Data API v3.",
+    "youtubeSocialStep2": "Configure the OAuth consent screen with the youtube.upload and youtube.readonly scopes. Since they are sensitive scopes, the app must pass Google verification before it is published.",
+    "youtubeSocialStep3": "Create an OAuth client ID of type \"Web application\", add the URI above to \"Authorized redirect URIs\" and paste the Client ID and Client Secret above.",
+    "youtubeSocialStep4": "Request the YouTube API compliance audit: until it is approved, every video uploaded by the project stays private.",
+    "youtubeSocialStep5": "The default project quota allows about 100 video uploads per day. When it runs out, publishing is rescheduled for after the reset (midnight Pacific Time).",
+    "googleBusinessSocialStep1": "The Business Profile must have been verified for more than 60 days and have a website.",
+    "googleBusinessSocialStep2": "Create a Google Cloud project just for Business Profile and request Basic API Access, providing that project number.",
+    "googleBusinessSocialStep3": "Enable the My Business Account Management API, the My Business Business Information API and the Google My Business API. Until access is approved the quota is 0 and every call fails.",
+    "googleBusinessSocialStep4": "Configure the OAuth consent screen with the business.manage scope.",
+    "googleBusinessSocialStep5": "Create an OAuth client ID of type \"Web application\", add the URI above to \"Authorized redirect URIs\" and paste the Client ID and Client Secret above.",
+    "googleSocialTestingStep": "While the consent screen is in \"Testing\", choose \"Testing\" in the status above and use Sandbox mode to develop without waiting for Google approvals."
   },
   "SystemPagesPage": {
     "title": "Pages",

package/hedhog/frontend/messages/pt.json

@@ -2721,9 +2721,12 @@
     "fieldBusinessId": "Business ID",
     "fieldAppId": "Meta App ID",
     "fieldAppSecret": "Meta App Secret",
+    "fieldInstagramAppId": "ID do app do Instagram (Instagram > API setup with Instagram login)",
+    "fieldInstagramAppSecret": "Chave secreta do app do Instagram (Instagram > API setup with Instagram login)",
     "fieldWabaId": "ID da Conta do WhatsApp Business (WABA)",
     "fieldVerifyToken": "Verify Token do Webhook",
     "fieldGraphApiVersion": "Versão da Graph API",
+    "fieldLinkedInApiVersion": "Versão da API do LinkedIn (AAAAMM)",
     "fieldEnvironmentTest": "Teste",
     "fieldEnvironmentProduction": "Produção",
     "copiedToClipboard": "Copiado para a área de transferência",
@@ -2887,7 +2890,57 @@
     "fileStored": "Arquivo armazenado e cifrado. Clique para substituir.",
     "fileSelected": "Novo arquivo selecionado. Será cifrado ao salvar.",
     "fieldRtdnServiceAccount": "Conta de Serviço das Notificações (RTDN)",
-    "fieldRtdnAudience": "Audience das Notificações (RTDN)"
+    "fieldRtdnAudience": "Audience das Notificações (RTDN)",
+    "fieldLoginConfigId": "Login Configuration ID (Facebook Login for Business)",
+    "metaSocialSectionTitle": "Conexão das redes sociais",
+    "metaSocialDescription": "Este perfil é o app do HedHog na Meta. As Páginas e contas Instagram são conectadas por marca, em Social → Marcas → Canais.",
+    "metaSocialRedirectUriLabel": "URI de redirecionamento do OAuth",
+    "metaSocialRedirectUriUnavailable": "Defina NEXT_PUBLIC_API_BASE_URL para exibir a URI",
+    "metaSocialStepsTitle": "Como configurar no painel da Meta",
+    "metaSocialStep1": "Crie um app do tipo Business e adicione o Facebook Login for Business e a API do Instagram com login do Facebook.",
+    "metaSocialStep2": "Crie uma Login Configuration do tipo \"User access token\" com as permissões de publicação e cole o ID dela acima.",
+    "metaSocialStep3": "Cadastre a URI acima em \"Valid OAuth Redirect URIs\".",
+    "metaSocialStep4": "Até o App Review ser aprovado, use o modo Sandbox ou só contas de administradores e testadores do app.",
+    "instagramSocialSectionTitle": "Conexão com o Instagram",
+    "instagramSocialDescription": "Este perfil é o app do HedHog na API do Instagram com login do Instagram. As contas profissionais do Instagram (Empresa ou Criador de conteúdo) são conectadas por marca, em Social → Marcas → Canais, com ou sem Página do Facebook.",
+    "instagramSocialRedirectUriLabel": "URI de redirecionamento do OAuth",
+    "instagramSocialRedirectUriUnavailable": "Defina NEXT_PUBLIC_API_BASE_URL para exibir a URI",
+    "instagramSocialStepsTitle": "Como configurar no painel da Meta",
+    "instagramSocialStep1": "No app da Meta, adicione o produto Instagram e abra \"API setup with Instagram login\".",
+    "instagramSocialStep2": "Copie o ID do app do Instagram e a chave secreta do app do Instagram exibidos ali e cole acima. Eles não são o ID e a chave do app da Meta.",
+    "instagramSocialStep3": "Em \"Set up Instagram business login\" > Business login settings, cadastre a URI acima em \"OAuth redirect URIs\" exatamente como aparece, sem barra no final.",
+    "instagramSocialStep4": "Nas mesmas configurações, preencha a Deauthorize callback URL e a Data deletion request URL com a página das suas instruções de privacidade.",
+    "instagramSocialStep5": "Até o App Review ser aprovado, adicione as contas que serão conectadas como testadoras do Instagram no app, ou use o modo Sandbox.",
+    "linkedinSocialSectionTitle": "Conexão com o LinkedIn",
+    "linkedinSocialDescription": "Este perfil é o app do HedHog na Community Management API do LinkedIn. As páginas de empresa são conectadas por marca, em Social → Marcas → Canais, por um membro que seja administrador ou administrador de conteúdo da página.",
+    "linkedinSocialRedirectUriLabel": "URL de redirecionamento autorizada",
+    "linkedinSocialRedirectUriUnavailable": "Defina NEXT_PUBLIC_API_BASE_URL para exibir a URL",
+    "linkedinSocialStepsTitle": "Como configurar no LinkedIn Developer Portal",
+    "linkedinSocialStep1": "Crie um app dedicado, sem outros produtos, vinculado à página da empresa e verificado por um superadministrador dessa Página do LinkedIn.",
+    "linkedinSocialStep2": "Na aba Products, solicite a Community Management API. O acesso começa no nível Development.",
+    "linkedinSocialStep3": "Na aba Auth, cadastre a URL acima em \"Authorized redirect URLs for your app\" exatamente como aparece e copie o Client ID e o Primary Client Secret para os campos acima.",
+    "linkedinSocialStep4": "Antes de ir para produção, solicite o nível Standard, que exige um screencast de cada caso de uso do app.",
+    "linkedinSocialStep5": "Até o nível Standard ser aprovado, use o modo Sandbox.",
+    "fieldOauthAppStatus": "Status da tela de consentimento OAuth",
+    "fieldOauthAppStatusTesting": "Em teste (o token de atualização expira em 7 dias e o canal precisa ser reconectado)",
+    "fieldOauthAppStatusProduction": "Em produção (o token de atualização não expira em 7 dias)",
+    "googleSocialSectionTitle": "Conexão com o Google",
+    "youtubeSocialDescription": "Este perfil é o projeto do HedHog no Google Cloud para o YouTube. Os canais são conectados por marca, em Social → Marcas → Canais.",
+    "googleBusinessSocialDescription": "Este perfil é o projeto do HedHog no Google Cloud para o Perfil da Empresa no Google. Os locais são conectados por marca, em Social → Marcas → Canais.",
+    "googleSocialRedirectUriLabel": "URI de redirecionamento autorizado do OAuth",
+    "googleSocialRedirectUriUnavailable": "Defina NEXT_PUBLIC_API_BASE_URL para exibir a URI",
+    "googleSocialStepsTitle": "Como configurar no Google Cloud Console",
+    "youtubeSocialStep1": "Crie um projeto no Google Cloud só para o YouTube e ative a YouTube Data API v3.",
+    "youtubeSocialStep2": "Configure a tela de consentimento OAuth com os escopos youtube.upload e youtube.readonly. Por serem escopos sensíveis, o app precisa passar pela verificação do Google antes de ser publicado.",
+    "youtubeSocialStep3": "Crie um ID do cliente OAuth do tipo \"Aplicativo da Web\", cadastre a URI acima em \"URIs de redirecionamento autorizados\" e cole o Client ID e o Client Secret acima.",
+    "youtubeSocialStep4": "Solicite a auditoria de conformidade da API do YouTube: até ela ser aprovada, todo vídeo enviado pelo projeto fica privado.",
+    "youtubeSocialStep5": "A cota padrão do projeto permite cerca de 100 envios de vídeo por dia. Ao esgotar, a publicação é reagendada para depois do reset (meia-noite no horário do Pacífico).",
+    "googleBusinessSocialStep1": "O Perfil da Empresa precisa estar verificado há mais de 60 dias e ter um site cadastrado.",
+    "googleBusinessSocialStep2": "Crie um projeto no Google Cloud só para o Perfil da Empresa e solicite o acesso básico à API (Basic API Access) informando o número desse projeto.",
+    "googleBusinessSocialStep3": "Ative a My Business Account Management API, a My Business Business Information API e a Google My Business API. Até o acesso ser aprovado a cota é 0 e toda chamada falha.",
+    "googleBusinessSocialStep4": "Configure a tela de consentimento OAuth com o escopo business.manage.",
+    "googleBusinessSocialStep5": "Crie um ID do cliente OAuth do tipo \"Aplicativo da Web\", cadastre a URI acima em \"URIs de redirecionamento autorizados\" e cole o Client ID e o Client Secret acima.",
+    "googleSocialTestingStep": "Enquanto a tela de consentimento estiver em \"Teste\", escolha \"Em teste\" no status acima e use o modo Sandbox para desenvolver sem depender das aprovações do Google."
   },
   "SystemPagesPage": {
     "title": "Páginas",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/core",
-  "version": "0.0.400",
+  "version": "0.0.401",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,12 +48,12 @@
     "ua-parser-js": "^2.0.10",
     "uuid": "^11.1.0",
     "@hed-hog/api-prisma": "0.0.7",
-    "@hed-hog/api-locale": "0.0.15",
     "@hed-hog/api-mail": "0.0.11",
+    "@hed-hog/api-locale": "0.0.15",
     "@hed-hog/vault-crypto": "0.0.1",
-    "@hed-hog/api": "0.0.9",
+    "@hed-hog/api-types": "0.0.2",
     "@hed-hog/api-pagination": "0.0.8",
-    "@hed-hog/api-types": "0.0.2"
+    "@hed-hog/api": "0.0.9"
   },
   "exports": {
     ".": {

package/src/ai/ai-attachment.fragments.spec.ts

@@ -179,6 +179,10 @@ describe('AiService — anexos no fio', () => {
     return mockedAxios.post.mock.calls.at(-1)?.[1] as Record<string, any>;
   }
 
+  function lastUrl(): string {
+    return mockedAxios.post.mock.calls.at(-1)?.[0] as string;
+  }
+
   describe('Gemini', () => {
     it('embrulha anexo de texto exatamente como o código original', async () => {
       useAttachment(TEXT_ATTACHMENT);
@@ -248,23 +252,72 @@ describe('AiService — anexos no fio', () => {
       );
     });
 
-    it('embrulha PDF com texto extraído exatamente como o código original', async () => {
+    // Num modelo com visão o PDF deixou de ser achatado em texto: ele vai
+    // inteiro para a Responses API, que renderiza as páginas. Era isso que
+    // faltava para uma nota fiscal escaneada — sem camada de texto, o caminho
+    // antigo mandava ao modelo a frase dizendo que o PDF é ilegível.
+    it('PDF vai como documento para a Responses API, não achatado em texto', async () => {
       const pdfText = 'Cláusula 1ª — objeto do contrato.';
       useAttachment(PDF_ATTACHMENT);
       jest.spyOn(service as any, 'extractPdfText').mockResolvedValue(pdfText);
+      jest.spyOn(service as any, 'countPdfPages').mockResolvedValue(1);
 
       await service.chat({ message: 'Resuma.', provider: 'openai' } as any);
 
+      expect(lastUrl()).toBe('https://api.openai.com/v1/responses');
+      expect(lastBody().messages).toBeUndefined();
+
+      const [file, text] = lastBody().input[0].content;
+      expect(file.type).toBe('input_file');
+      expect(file.filename).toBe(PDF_ATTACHMENT.filename);
+      expect(file.file_data).toBe(
+        `data:application/pdf;base64,${PDF_ATTACHMENT.buffer.toString('base64')}`,
+      );
+      expect(text).toEqual({ type: 'input_text', text: 'Resuma.' });
+    });
+
+    it('PDF ilegível também vai como documento, sem marcador nenhum', async () => {
+      useAttachment(PDF_ATTACHMENT);
+      jest.spyOn(service as any, 'extractPdfText').mockResolvedValue('');
+      jest.spyOn(service as any, 'countPdfPages').mockResolvedValue(1);
+
+      await service.chat({ message: 'Resuma.', provider: 'openai' } as any);
+
+      expect(lastUrl()).toBe('https://api.openai.com/v1/responses');
+      expect(JSON.stringify(lastBody())).not.toContain(
+        legacyUnreadablePdf(PDF_ATTACHMENT),
+      );
+    });
+
+    // O marcador continua valendo onde a Responses API não ajuda: modelo sem
+    // visão só receberia a camada de texto de volta, o mesmo nada num endpoint
+    // diferente. Então esses dois casos guardam a fidelidade byte a byte.
+    it('em modelo sem visão, PDF com texto continua no bloco de arquivo legado', async () => {
+      const pdfText = 'Cláusula 1ª — objeto do contrato.';
+      useAttachment(PDF_ATTACHMENT);
+      jest.spyOn(service as any, 'extractPdfText').mockResolvedValue(pdfText);
+
+      await service.chat({
+        message: 'Resuma.',
+        provider: 'openai',
+        model: 'gpt-3.5-turbo',
+      } as any);
+
+      expect(lastUrl()).toBe('https://api.openai.com/v1/chat/completions');
       expect(lastBody().messages[0].content).toBe(
         legacyOpenAiReturn('Resuma.', PDF_ATTACHMENT, pdfText),
       );
     });
 
-    it('PDF ilegível cai no marcador de PDF, dentro do bloco de arquivo', async () => {
+    it('em modelo sem visão, PDF ilegível cai no marcador de PDF', async () => {
       useAttachment(PDF_ATTACHMENT);
       jest.spyOn(service as any, 'extractPdfText').mockResolvedValue('');
 
-      await service.chat({ message: 'Resuma.', provider: 'openai' } as any);
+      await service.chat({
+        message: 'Resuma.',
+        provider: 'openai',
+        model: 'gpt-3.5-turbo',
+      } as any);
 
       expect(lastBody().messages[0].content).toBe(
         legacyOpenAiReturn('Resuma.', PDF_ATTACHMENT, legacyUnreadablePdf(PDF_ATTACHMENT)),