forlogic-core 1.11.4 → 1.11.5

package/README.md

@@ -312,17 +312,16 @@ export default defineConfig(({ mode }) => ({
 
 ### 🏗️ Factory de Configuração Vite (Opcional)
 
-Para projetos que desejam usar a configuração completa padronizada:
+Para projetos que desejam usar a configuração padronizada com segurança:
 
 ```typescript
 // vite.config.ts
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react-swc';
+import path from 'path';
 import { createForlogicViteConfig } from 'forlogic-core/vite';
 
 const forlogicConfig = createForlogicViteConfig({
-  srcAlias: '@',
-  libAlias: 'forlogic-core',
   security: {
     supabaseUrls: ['https://seu-projeto.supabase.co'],
     trustedOrigins: ['https://meu-app.com'],
@@ -332,14 +331,98 @@ const forlogicConfig = createForlogicViteConfig({
 });
 
 export default defineConfig(({ mode }) => {
-  const config = forlogicConfig(mode === 'development');
+  const isDev = mode === 'development';
+  const baseConfig = forlogicConfig(isDev);
+  
   return {
-    ...config,
-    plugins: [react(), ...config.plugins],
+    ...baseConfig,
+    plugins: [react(), ...baseConfig.plugins],
+    // IMPORTANTE: resolve.alias deve usar caminhos absolutos
+    resolve: {
+      alias: {
+        '@': path.resolve(__dirname, './src'),
+      },
+    },
   };
 });
 ```
 
+> **⚠️ IMPORTANTE**: A factory **não** configura `resolve.alias` porque caminhos relativos não funcionam corretamente no build. Cada projeto deve definir seus próprios aliases com `path.resolve(__dirname, './caminho')` para garantir caminhos absolutos.
+
+---
+
+### 📋 Template Completo para Projetos Consumidores
+
+Copie e adapte este template para novos projetos:
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react-swc';
+import path from 'path';
+import { createSecurityHeadersPlugin } from 'forlogic-core/vite';
+
+export default defineConfig(({ mode }) => {
+  const isDev = mode === 'development';
+
+  return {
+    server: {
+      host: '::',
+      port: 8080,
+    },
+    
+    // Força re-bundle quando atualizar forlogic-core
+    optimizeDeps: {
+      force: true,
+    },
+    
+    plugins: [
+      react(),
+      // Headers de segurança (CSP, CORS, etc.)
+      createSecurityHeadersPlugin(isDev, {
+        supabaseUrls: [
+          'https://SEU_PROJETO.supabase.co',
+        ],
+        additionalConnectSrc: [
+          'https://*.qualiex.com',
+        ],
+        // Opcional: URI para relatório de violações CSP
+        cspReportUri: isDev
+          ? 'https://SEU_PROJETO_DEV.supabase.co/functions/v1/csp-report'
+          : 'https://SEU_PROJETO_PROD.supabase.co/functions/v1/csp-report',
+      }),
+    ],
+    
+    // CRÍTICO: Aliases devem usar caminhos absolutos
+    resolve: {
+      alias: {
+        '@': path.resolve(__dirname, './src'),
+      },
+    },
+    
+    publicDir: false,
+    
+    esbuild: {
+      sourcemap: true,
+      target: 'es2020',
+    },
+    
+    build: {
+      chunkSizeWarningLimit: 4000,
+    },
+  };
+});
+```
+
+#### Checklist de Configuração
+
+```markdown
+- [ ] Substituiu `SEU_PROJETO` pelas URLs do Supabase
+- [ ] Adicionou origens confiáveis em `additionalConnectSrc` se necessário
+- [ ] Verificou que `resolve.alias` usa `path.resolve(__dirname, ...)`
+- [ ] Reiniciou o servidor após modificar o arquivo
+```
+
 ---
 
 ### 🔄 Forçar Re-bundle de Dependências
@@ -747,6 +830,48 @@ Se você não fornecer um `queryClient`, o `CoreProviders` cria um com as seguin
 
 ---
 
+## 🛠️ CLI: Sincronização de Documentação
+
+O `forlogic-core` disponibiliza um comando CLI para sincronizar a documentação centralizada do banco de dados para projetos consumidores.
+
+### Uso
+
+```bash
+# Via npx (recomendado)
+npx forlogic-core-pull-docs
+
+# Ou adicione ao package.json do seu projeto:
+{
+  "scripts": {
+    "pull-docs": "forlogic-core-pull-docs"
+  }
+}
+
+# E execute:
+npm run pull-docs
+```
+
+### O que é sincronizado
+
+| Arquivo | Descrição |
+|---------|-----------|
+| `docs/FORLOGIC_CORE_README.md` | README completo da biblioteca |
+| `docs/DESIGN_SYSTEM.md` | Documentação do Design System |
+| `docs/KNOWLEDGE.md` | Knowledge base para IA/Lovable |
+
+### Benefícios
+
+- ✅ **Centralizado**: Documentação mantida em um único lugar (banco de dados)
+- ✅ **Sempre atualizado**: Execute o comando para obter a versão mais recente
+- ✅ **Sem cópia manual**: Não precisa copiar arquivos entre projetos
+- ✅ **Ideal para Custom Knowledge**: Use os arquivos gerados no Lovable
+
+### Requisitos
+
+O comando usa credenciais públicas do Supabase do forlogic-core e não requer configuração adicional.
+
+---
+
 <!-- AUTO_GENERATED_START -->
 
 ### 📚 Estatísticas da Documentação

package/dist/README.md

@@ -312,17 +312,16 @@ export default defineConfig(({ mode }) => ({
 
 ### 🏗️ Factory de Configuração Vite (Opcional)
 
-Para projetos que desejam usar a configuração completa padronizada:
+Para projetos que desejam usar a configuração padronizada com segurança:
 
 ```typescript
 // vite.config.ts
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react-swc';
+import path from 'path';
 import { createForlogicViteConfig } from 'forlogic-core/vite';
 
 const forlogicConfig = createForlogicViteConfig({
-  srcAlias: '@',
-  libAlias: 'forlogic-core',
   security: {
     supabaseUrls: ['https://seu-projeto.supabase.co'],
     trustedOrigins: ['https://meu-app.com'],
@@ -332,14 +331,98 @@ const forlogicConfig = createForlogicViteConfig({
 });
 
 export default defineConfig(({ mode }) => {
-  const config = forlogicConfig(mode === 'development');
+  const isDev = mode === 'development';
+  const baseConfig = forlogicConfig(isDev);
+  
   return {
-    ...config,
-    plugins: [react(), ...config.plugins],
+    ...baseConfig,
+    plugins: [react(), ...baseConfig.plugins],
+    // IMPORTANTE: resolve.alias deve usar caminhos absolutos
+    resolve: {
+      alias: {
+        '@': path.resolve(__dirname, './src'),
+      },
+    },
   };
 });
 ```
 
+> **⚠️ IMPORTANTE**: A factory **não** configura `resolve.alias` porque caminhos relativos não funcionam corretamente no build. Cada projeto deve definir seus próprios aliases com `path.resolve(__dirname, './caminho')` para garantir caminhos absolutos.
+
+---
+
+### 📋 Template Completo para Projetos Consumidores
+
+Copie e adapte este template para novos projetos:
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react-swc';
+import path from 'path';
+import { createSecurityHeadersPlugin } from 'forlogic-core/vite';
+
+export default defineConfig(({ mode }) => {
+  const isDev = mode === 'development';
+
+  return {
+    server: {
+      host: '::',
+      port: 8080,
+    },
+    
+    // Força re-bundle quando atualizar forlogic-core
+    optimizeDeps: {
+      force: true,
+    },
+    
+    plugins: [
+      react(),
+      // Headers de segurança (CSP, CORS, etc.)
+      createSecurityHeadersPlugin(isDev, {
+        supabaseUrls: [
+          'https://SEU_PROJETO.supabase.co',
+        ],
+        additionalConnectSrc: [
+          'https://*.qualiex.com',
+        ],
+        // Opcional: URI para relatório de violações CSP
+        cspReportUri: isDev
+          ? 'https://SEU_PROJETO_DEV.supabase.co/functions/v1/csp-report'
+          : 'https://SEU_PROJETO_PROD.supabase.co/functions/v1/csp-report',
+      }),
+    ],
+    
+    // CRÍTICO: Aliases devem usar caminhos absolutos
+    resolve: {
+      alias: {
+        '@': path.resolve(__dirname, './src'),
+      },
+    },
+    
+    publicDir: false,
+    
+    esbuild: {
+      sourcemap: true,
+      target: 'es2020',
+    },
+    
+    build: {
+      chunkSizeWarningLimit: 4000,
+    },
+  };
+});
+```
+
+#### Checklist de Configuração
+
+```markdown
+- [ ] Substituiu `SEU_PROJETO` pelas URLs do Supabase
+- [ ] Adicionou origens confiáveis em `additionalConnectSrc` se necessário
+- [ ] Verificou que `resolve.alias` usa `path.resolve(__dirname, ...)`
+- [ ] Reiniciou o servidor após modificar o arquivo
+```
+
 ---
 
 ### 🔄 Forçar Re-bundle de Dependências
@@ -747,6 +830,48 @@ Se você não fornecer um `queryClient`, o `CoreProviders` cria um com as seguin
 
 ---
 
+## 🛠️ CLI: Sincronização de Documentação
+
+O `forlogic-core` disponibiliza um comando CLI para sincronizar a documentação centralizada do banco de dados para projetos consumidores.
+
+### Uso
+
+```bash
+# Via npx (recomendado)
+npx forlogic-core-pull-docs
+
+# Ou adicione ao package.json do seu projeto:
+{
+  "scripts": {
+    "pull-docs": "forlogic-core-pull-docs"
+  }
+}
+
+# E execute:
+npm run pull-docs
+```
+
+### O que é sincronizado
+
+| Arquivo | Descrição |
+|---------|-----------|
+| `docs/FORLOGIC_CORE_README.md` | README completo da biblioteca |
+| `docs/DESIGN_SYSTEM.md` | Documentação do Design System |
+| `docs/KNOWLEDGE.md` | Knowledge base para IA/Lovable |
+
+### Benefícios
+
+- ✅ **Centralizado**: Documentação mantida em um único lugar (banco de dados)
+- ✅ **Sempre atualizado**: Execute o comando para obter a versão mais recente
+- ✅ **Sem cópia manual**: Não precisa copiar arquivos entre projetos
+- ✅ **Ideal para Custom Knowledge**: Use os arquivos gerados no Lovable
+
+### Requisitos
+
+O comando usa credenciais públicas do Supabase do forlogic-core e não requer configuração adicional.
+
+---
+
 <!-- AUTO_GENERATED_START -->
 
 ### 📚 Estatísticas da Documentação

package/dist/bin/pull-docs.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+import * as fs from 'fs';
+import * as path from 'path';
+import { createClient } from '@supabase/supabase-js';
+
+const FORLOGIC_CORE_SUPABASE_URL = "https://ccjfvpnndclajkleyqkc.supabase.co";
+const FORLOGIC_CORE_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImNjamZ2cG5uZGNsYWprbGV5cWtjIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTA5NTQ1OTksImV4cCI6MjA2NjUzMDU5OX0.j7ASp7OYaR5oXfnVmK77VGNH-5hDa9JpzbAYJBUpfa8";
+const supabase = createClient(
+  FORLOGIC_CORE_SUPABASE_URL,
+  FORLOGIC_CORE_ANON_KEY
+);
+const DOCS_TO_SYNC = [
+  { type: "readme", outputFile: "docs/FORLOGIC_CORE_README.md" },
+  { type: "design_system", outputFile: "docs/DESIGN_SYSTEM.md" },
+  { type: "knowledge", outputFile: "docs/KNOWLEDGE.md" }
+];
+async function pullDocs() {
+  console.log("\u{1F4E5} Puxando documenta\xE7\xE3o do forlogic-core...\n");
+  let successCount = 0;
+  let errorCount = 0;
+  for (const doc of DOCS_TO_SYNC) {
+    try {
+      const { data, error } = await supabase.schema("common").from("documentation").select("content, updated_at").eq("type", doc.type).single();
+      if (error) {
+        console.error(`\u274C Erro ao buscar ${doc.type}:`, error.message);
+        errorCount++;
+        continue;
+      }
+      if (!data) {
+        console.warn(`\u26A0\uFE0F Documento '${doc.type}' n\xE3o encontrado no banco`);
+        errorCount++;
+        continue;
+      }
+      const outputPath = path.join(process.cwd(), doc.outputFile);
+      const outputDir = path.dirname(outputPath);
+      if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+      }
+      fs.writeFileSync(outputPath, data.content, "utf-8");
+      console.log(`\u2705 ${doc.type} \u2192 ${doc.outputFile}`);
+      console.log(`   \u{1F4CA} Tamanho: ${(data.content.length / 1024).toFixed(2)} KB`);
+      console.log(`   \u{1F550} \xDAltima atualiza\xE7\xE3o: ${data.updated_at}
+`);
+      successCount++;
+    } catch (err) {
+      console.error(`\u274C Erro ao processar ${doc.type}:`, err.message);
+      errorCount++;
+    }
+  }
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.log(`\u{1F389} Sincroniza\xE7\xE3o conclu\xEDda!`);
+  console.log(`   \u2705 Sucesso: ${successCount}`);
+  console.log(`   \u274C Erros: ${errorCount}
+`);
+  if (successCount > 0) {
+    console.log("\u{1F4A1} Arquivos sincronizados em docs/");
+    console.log("   Use no Custom Knowledge do Lovable ou como refer\xEAncia.\n");
+  }
+}
+pullDocs();

package/dist/vite/index.esm.js

@@ -162,8 +162,6 @@ function createSecurityHeadersPlugin(isDev, options = {}) {
 
 function createForlogicViteConfig(options = {}) {
   const {
-    srcAlias = "@",
-    libAlias = "forlogic-core",
     security = {},
     server = {},
     build = {},
@@ -180,13 +178,6 @@ function createForlogicViteConfig(options = {}) {
         host: server.host ?? "::",
         port: server.port ?? 8080
       },
-      resolve: {
-        alias: {
-          [srcAlias]: "./src",
-          [libAlias]: "./lib",
-          "/assets": "./lib/assets"
-        }
-      },
       publicDir: false,
       esbuild: {
         sourcemap: build.sourcemap ?? true,

package/dist/vite/index.js

@@ -164,8 +164,6 @@ function createSecurityHeadersPlugin(isDev, options = {}) {
 
 function createForlogicViteConfig(options = {}) {
   const {
-    srcAlias = "@",
-    libAlias = "forlogic-core",
     security = {},
     server = {},
     build = {},
@@ -182,13 +180,6 @@ function createForlogicViteConfig(options = {}) {
         host: server.host ?? "::",
         port: server.port ?? 8080
       },
-      resolve: {
-        alias: {
-          [srcAlias]: "./src",
-          [libAlias]: "./lib",
-          "/assets": "./lib/assets"
-        }
-      },
       publicDir: false,
       esbuild: {
         sourcemap: build.sourcemap ?? true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "1.11.4",
+  "version": "1.11.5",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",