forlogic-core 2.3.0 → 2.3.1

package/.note/memory/patterns/dynamic-supabase-config.md

@@ -1,4 +1,4 @@
 # Memory: patterns/dynamic-supabase-config
-Updated: 2026-03-24
+Updated: 2026-05-25
 
-As credenciais do Supabase vêm exclusivamente do `.env` (auto-populado pelo Lovable ao trocar banco). O Vite injeta automaticamente variáveis `VITE_*` em `import.meta.env` — não há bloco `define` manual nem extração de `client.ts`. O `vite.config.ts` usa `loadEnv()` apenas para ler o project ID no contexto Node (CSP headers). O `SupabaseSingleton` lê `import.meta.env.VITE_SUPABASE_URL` e `VITE_SUPABASE_PUBLISHABLE_KEY` em runtime no browser.
+O `vite.config.ts` chama `resolveSupabaseEnv(mode)` (de `forlogic-core/vite`), que lê tanto `VITE_SUPABASE_*` quanto `SUPABASE_*` (formato novo Lovable Cloud), prioriza `VITE_*` e injeta valores consolidados via `define`: `import.meta.env.VITE_SUPABASE_URL`, `VITE_SUPABASE_PUBLISHABLE_KEY`, `VITE_SUPABASE_PROJECT_ID`, `VITE_SUPABASE_PK_OVERRIDE`. O `.env` precisa apenas de UMA versão (`SUPABASE_URL` + `SUPABASE_PUBLISHABLE_KEY`). `VITE_SUPABASE_PK_OVERRIDE` continua obrigatório por causa do bug do Lovable sobrescrever a publishable key com a legacy JWT. `projectId` é derivado da URL quando ausente.

package/.note/memory/patterns/environment-detection-logic.md

@@ -1,35 +1,41 @@
 # Memory: patterns/environment-detection-logic
-Updated: 2026-03-24
+Updated: 2026-05-25
 
 O sistema separa duas preocupações independentes de ambiente:
 
 ## 1. Método de autenticação (`shouldUseDevTokens()` / `isLovablePreview()`)
 Detecta se o app roda em contexto de desenvolvimento (preview Lovable via iframe, `*.lovable.dev`, localhost ou `import.meta.env.DEV`). Quando true, usa a edge function `dev-tokens` do Supabase conectado para autenticar. Quando false (app publicado), usa OAuth padrão do Qualiex.
 
-## 2. Qual API usar (`getEnvironmentConfig()` / `isDevSupabaseProject()`)
-Compara o project ID do Supabase conectado com `PROD_PROJECT_ID` (`ccjfvpnndclajkleyqkc`). Se igual → config PROD (API prod, OAuth prod). Se diferente → config DEV (API dev, OAuth dev).
+## 2. Qual API usar (`getEnvironmentConfig()` / `isDevEnv()`)
+Fonte de verdade **única e explícita**: env var `VITE_APP_ENV`.
 
-## Fonte de verdade do Project ID
-O project ID vem do `.env` (auto-populado pelo Lovable ao trocar banco), que o Vite injeta automaticamente em `import.meta.env.VITE_SUPABASE_PROJECT_ID`. **Não** é extraído de `src/integrations/supabase/client.ts`. O `vite.config.ts` usa `loadEnv()` apenas no contexto Node para configurar CSP headers.
+| `VITE_APP_ENV`                  | Resultado             |
+|---------------------------------|-----------------------|
+| `"PROD"`                        | PROD (API/OAuth prod) |
+| `"DEV"`                         | DEV (API/OAuth dev)   |
+| ausente / qualquer outro valor  | **PROD (failsafe)**   |
+
+Não há fallback derivado do Supabase. Apps que querem apontar para dev precisam declarar `VITE_APP_ENV="DEV"` no `.env`. Apps prod simplesmente omitem (ou setam `"PROD"`).
 
 ## Tabela de regras
 
-| Cenário                      | API  | Auth       |
-|------------------------------|------|------------|
-| Preview + Prod Supabase      | Prod | dev-tokens |
-| Preview + Dev Supabase       | Dev  | dev-tokens |
-| Publicado + Prod Supabase    | Prod | OAuth      |
-| Publicado + Dev Supabase     | Dev  | OAuth      |
+| Cenário                         | API  | Auth       |
+|---------------------------------|------|------------|
+| Preview + `VITE_APP_ENV=PROD`   | Prod | dev-tokens |
+| Preview + `VITE_APP_ENV=DEV`    | Dev  | dev-tokens |
+| Publicado + `VITE_APP_ENV=PROD` | Prod | OAuth      |
+| Publicado + `VITE_APP_ENV=DEV`  | Dev  | OAuth      |
 
 ## Guard de troca de projeto (`TokenManager.checkProjectMismatch()`)
-Ao inicializar (`AuthService.initialize()`), o sistema compara `import.meta.env.VITE_SUPABASE_PROJECT_ID` com o valor armazenado em `localStorage('supabase_project_id')`. Se diferente, limpa todos os tokens stale automaticamente antes de qualquer chamada a `validate-token`, evitando 401 desnecessários. Após a limpeza, armazena o novo project ID. Isso garante transição limpa ao trocar de banco Supabase sem erros ou blank screen.
+Independente de `VITE_APP_ENV`. Ao inicializar (`AuthService.initialize()`), compara `import.meta.env.VITE_SUPABASE_PROJECT_ID` (consolidado por `resolveSupabaseEnv()` no `vite.config.ts`) com o valor armazenado em `localStorage('supabase_project_id')`. Se diferente, limpa tokens stale antes de qualquer chamada a `validate-token`. Sem efeito em apps `backend="dotnet"`.
 
 ## Funções (lib/config/index.ts)
 - `isLovablePreview()` — detecta contexto de preview/localhost
-- `shouldUseDevTokens()` — wrapper semântico sobre `isLovablePreview()`
+- `shouldUseDevTokens()` — wrapper semântico sobre `isLovablePreview()` (apenas modo Supabase)
 - `isDevEnvironment` — alias deprecated, mantido para compatibilidade
-- `getEnvironmentConfig()` — retorna config PROD ou DEV baseado no project ID
-- `isDevSupabaseProject()` — true se project ID ≠ PROD_PROJECT_ID
+- `getAppEnv()` — retorna `'PROD' | 'DEV'` lendo `VITE_APP_ENV` (default `'PROD'`)
+- `getEnvironmentConfig()` — retorna config PROD ou DEV baseado em `getAppEnv()`
+- `isDevEnv()` — true se `getAppEnv() === 'DEV'`
 
 ## Funções (lib/auth/services/TokenManager.ts)
 - `checkProjectMismatch()` — detecta troca de projeto Supabase e limpa tokens stale

package/README.md

@@ -49,7 +49,7 @@ function App() {
 
 A partir da versão com `CoreProviders backend="..."`, o Supabase deixou de ser obrigatório:
 
-- `backend="supabase"` (default, retrocompat) — exige `VITE_SUPABASE_URL` + `VITE_SUPABASE_PUBLISHABLE_KEY`.
+- `backend="supabase"` (default, retrocompat) — exige `SUPABASE_URL` + `SUPABASE_PUBLISHABLE_KEY` (ou `VITE_SUPABASE_*` legadas; o `vite.config.ts` consolida ambos).
 - `backend="dotnet"` — autentica apenas com tokens OAuth do Qualiex; **não** lê envs do Supabase.
 
 **Breaking change:** os módulos `sign`, `audit-trail`, `action-plans`, `leadership` e `places` foram **removidos do barrel principal** e só podem ser importados via subpath (ex.: `import { DocumentSigner } from 'forlogic-core/sign'`). Eles continuam exigindo Supabase em runtime mesmo quando o app usa `backend="dotnet"`.

package/dist/action-plans/config/environments.d.ts

@@ -1,12 +1,27 @@
-declare const PROD_PROJECT_ID = "ccjfvpnndclajkleyqkc";
+/**
+ * Detecção de ambiente prod/dev.
+ *
+ * Fonte de verdade ÚNICA: `VITE_APP_ENV` (`"PROD"` | `"DEV"`).
+ * - `"DEV"` → API/OAuth/Supabase de dev.
+ * - `"PROD"` ou ausente / qualquer outro valor → PROD (failsafe).
+ *
+ * Não há fallback baseado em env vars Supabase: apps sem Supabase precisam
+ * configurar `VITE_APP_ENV="DEV"` explicitamente quando quiserem apontar para dev.
+ *
+ * **Storage de assets (logos/favicon) é sempre prod** — bucket público fixo.
+ */
+export type AppEnv = 'PROD' | 'DEV';
 export interface EnvironmentConfig {
     storageProjectId: string;
+    supabaseProjectId: string;
+    supabaseUrl: string;
+    supabasePublishableKey: string;
     oauth: {
         authUrl: string;
         clientId: string;
     };
     qualiexApiUrl: string;
 }
+export declare function getAppEnv(): AppEnv;
 export declare function getEnvironmentConfig(): EnvironmentConfig;
-export declare function isDevSupabaseProject(): boolean;
-export { PROD_PROJECT_ID };
+export declare function isDevEnv(): boolean;

package/dist/action-plans/config/index.d.ts

@@ -22,13 +22,13 @@ export declare const SEARCH_CONFIG: {
 export declare const isLovablePreview: () => boolean;
 /**
  * Determines auth method: true → use dev-tokens edge function, false → use OAuth.
- * This is independent of which API environment (prod/dev) is used — that's decided
- * by getEnvironmentConfig() based on the Supabase project ID.
+ * Requer modo Supabase: em modo dotnet, dev-tokens não existe e devemos sempre
+ * cair no OAuth real (loginProd), mesmo em localhost/preview.
  */
 export declare const shouldUseDevTokens: () => boolean;
 /** @deprecated Use `isLovablePreview()` or `shouldUseDevTokens()` instead */
 export declare const isDevEnvironment: () => boolean;
-export { isDevSupabaseProject } from './environments';
+export { isDevEnv, getAppEnv, type AppEnv } from './environments';
 export declare const getQualiexApiUrl: () => string;
 export declare const QUERY_KEYS: {
     readonly crud: (entity: string) => readonly [string];

package/dist/action-plans/index.d.ts

@@ -90,7 +90,7 @@ export { loadForlogicFonts } from './utils/load-fonts';
 export * from './types';
 export * from './types/sidebar';
 export * from './config';
-export { getEnvironmentConfig, PROD_PROJECT_ID, isDevSupabaseProject } from './config/environments';
+export { getEnvironmentConfig, isDevEnv, getAppEnv, type AppEnv } from './config/environments';
 export type { EnvironmentConfig } from './config/environments';
 export { setBackendMode, getBackendMode, isSupabaseBackend } from './config/backend';
 export type { BackendMode } from './config/backend';

package/dist/audit-trail/config/environments.d.ts

@@ -1,12 +1,27 @@
-declare const PROD_PROJECT_ID = "ccjfvpnndclajkleyqkc";
+/**
+ * Detecção de ambiente prod/dev.
+ *
+ * Fonte de verdade ÚNICA: `VITE_APP_ENV` (`"PROD"` | `"DEV"`).
+ * - `"DEV"` → API/OAuth/Supabase de dev.
+ * - `"PROD"` ou ausente / qualquer outro valor → PROD (failsafe).
+ *
+ * Não há fallback baseado em env vars Supabase: apps sem Supabase precisam
+ * configurar `VITE_APP_ENV="DEV"` explicitamente quando quiserem apontar para dev.
+ *
+ * **Storage de assets (logos/favicon) é sempre prod** — bucket público fixo.
+ */
+export type AppEnv = 'PROD' | 'DEV';
 export interface EnvironmentConfig {
     storageProjectId: string;
+    supabaseProjectId: string;
+    supabaseUrl: string;
+    supabasePublishableKey: string;
     oauth: {
         authUrl: string;
         clientId: string;
     };
     qualiexApiUrl: string;
 }
+export declare function getAppEnv(): AppEnv;
 export declare function getEnvironmentConfig(): EnvironmentConfig;
-export declare function isDevSupabaseProject(): boolean;
-export { PROD_PROJECT_ID };
+export declare function isDevEnv(): boolean;

package/dist/audit-trail/config/index.d.ts

@@ -22,13 +22,13 @@ export declare const SEARCH_CONFIG: {
 export declare const isLovablePreview: () => boolean;
 /**
  * Determines auth method: true → use dev-tokens edge function, false → use OAuth.
- * This is independent of which API environment (prod/dev) is used — that's decided
- * by getEnvironmentConfig() based on the Supabase project ID.
+ * Requer modo Supabase: em modo dotnet, dev-tokens não existe e devemos sempre
+ * cair no OAuth real (loginProd), mesmo em localhost/preview.
  */
 export declare const shouldUseDevTokens: () => boolean;
 /** @deprecated Use `isLovablePreview()` or `shouldUseDevTokens()` instead */
 export declare const isDevEnvironment: () => boolean;
-export { isDevSupabaseProject } from './environments';
+export { isDevEnv, getAppEnv, type AppEnv } from './environments';
 export declare const getQualiexApiUrl: () => string;
 export declare const QUERY_KEYS: {
     readonly crud: (entity: string) => readonly [string];

package/dist/audit-trail/index.d.ts

@@ -90,7 +90,7 @@ export { loadForlogicFonts } from './utils/load-fonts';
 export * from './types';
 export * from './types/sidebar';
 export * from './config';
-export { getEnvironmentConfig, PROD_PROJECT_ID, isDevSupabaseProject } from './config/environments';
+export { getEnvironmentConfig, isDevEnv, getAppEnv, type AppEnv } from './config/environments';
 export type { EnvironmentConfig } from './config/environments';
 export { setBackendMode, getBackendMode, isSupabaseBackend } from './config/backend';
 export type { BackendMode } from './config/backend';

package/dist/config/environments.d.ts

@@ -1,12 +1,27 @@
-declare const PROD_PROJECT_ID = "ccjfvpnndclajkleyqkc";
+/**
+ * Detecção de ambiente prod/dev.
+ *
+ * Fonte de verdade ÚNICA: `VITE_APP_ENV` (`"PROD"` | `"DEV"`).
+ * - `"DEV"` → API/OAuth/Supabase de dev.
+ * - `"PROD"` ou ausente / qualquer outro valor → PROD (failsafe).
+ *
+ * Não há fallback baseado em env vars Supabase: apps sem Supabase precisam
+ * configurar `VITE_APP_ENV="DEV"` explicitamente quando quiserem apontar para dev.
+ *
+ * **Storage de assets (logos/favicon) é sempre prod** — bucket público fixo.
+ */
+export type AppEnv = 'PROD' | 'DEV';
 export interface EnvironmentConfig {
     storageProjectId: string;
+    supabaseProjectId: string;
+    supabaseUrl: string;
+    supabasePublishableKey: string;
     oauth: {
         authUrl: string;
         clientId: string;
     };
     qualiexApiUrl: string;
 }
+export declare function getAppEnv(): AppEnv;
 export declare function getEnvironmentConfig(): EnvironmentConfig;
-export declare function isDevSupabaseProject(): boolean;
-export { PROD_PROJECT_ID };
+export declare function isDevEnv(): boolean;

package/dist/config/index.d.ts

@@ -22,13 +22,13 @@ export declare const SEARCH_CONFIG: {
 export declare const isLovablePreview: () => boolean;
 /**
  * Determines auth method: true → use dev-tokens edge function, false → use OAuth.
- * This is independent of which API environment (prod/dev) is used — that's decided
- * by getEnvironmentConfig() based on the Supabase project ID.
+ * Requer modo Supabase: em modo dotnet, dev-tokens não existe e devemos sempre
+ * cair no OAuth real (loginProd), mesmo em localhost/preview.
  */
 export declare const shouldUseDevTokens: () => boolean;
 /** @deprecated Use `isLovablePreview()` or `shouldUseDevTokens()` instead */
 export declare const isDevEnvironment: () => boolean;
-export { isDevSupabaseProject } from './environments';
+export { isDevEnv, getAppEnv, type AppEnv } from './environments';
 export declare const getQualiexApiUrl: () => string;
 export declare const QUERY_KEYS: {
     readonly crud: (entity: string) => readonly [string];

package/dist/index.d.ts

@@ -90,7 +90,7 @@ export { loadForlogicFonts } from './utils/load-fonts';
 export * from './types';
 export * from './types/sidebar';
 export * from './config';
-export { getEnvironmentConfig, PROD_PROJECT_ID, isDevSupabaseProject } from './config/environments';
+export { getEnvironmentConfig, isDevEnv, getAppEnv, type AppEnv } from './config/environments';
 export type { EnvironmentConfig } from './config/environments';
 export { setBackendMode, getBackendMode, isSupabaseBackend } from './config/backend';
 export type { BackendMode } from './config/backend';