@trismegisto/spine 2.0.1 → 2.1.0

package/README.md

@@ -7,7 +7,7 @@ configurações (tema, família, densidade, fonte, atalhos), tour de boas-vindas
 tela.
 
 Na cadeia de camadas (`tokens ← icons ← primitives ← core ← angular ← maps · charts · spine`) é a ponta: monta
-peças grandes sobre o `@trismegisto/angular` e é o que os apps da organização usam como esqueleto. Ao contrário
+peças grandes sobre o `@trismegisto/angular` e é o que os apps usam como esqueleto. Ao contrário
 dos outros pacotes, é acoplado à autenticação (`@orfeu/angular` ≥ 0.9.9, OIDC + PKCE contra o Argos): serve a
 apps que se autenticam nesse servidor. O app e o spine precisam usar a **mesma** cópia do `@orfeu/angular` — com o
 app ainda no SDK antigo (`@caronte-sdk/angular`) os serviços seriam outros e o shell quebraria
@@ -51,7 +51,12 @@ export const appConfig: ApplicationConfig = {
   o tema no `<body>` e usa `clientId` como prefixo de **todas** as chaves salvas (tema, menu lateral, abas):
   apps diferentes na mesma origem não misturam preferências. Opções: `clientId`, `appName` (nome ao lado do
   logo no cabeçalho), `logo`, `showAppName` e `favicon` (ver "Logo e favicon" abaixo), `technicalDocs` (mostra a
-  especificação técnica das telas; padrão `isDevMode()`).
+  especificação técnica das telas e o botão "Copiar token de acesso" do painel de configurações; padrão
+  `isDevMode()`).
+- **Recentes, buscas recentes e favoritos** ficam no `localStorage` por usuário (`SpineUserStorage`: chave
+  `<clientId>_<lista>_<sub>`, com o `sub` do token). No logout (pelo spine ou vindo de outra aba, via `isAuth$`) os
+  históricos são apagados; os favoritos ficam. Logout próprio do app: chame `SpineUserStorage.clearHistory()` antes
+  de `AuthorizationService.logout()`.
 - **`APP_ROUTES`** traz login, callback, saída e as rotas privadas sob o `spine-layout`
   (`LayoutComponent`). O `/callback` usa o `handleCallback()` do `@orfeu/angular`: confere state/verifier, volta
   para a URL pedida antes do login e, no `login_required` da reautorização silenciosa, segue sozinho para o login
@@ -112,6 +117,27 @@ provideUi({
 - **Marca em componente:** `{ provide: SPINE_BRAND, useValue: MarcaComponent }` (`@trismegisto/spine/layout`) tem
   prioridade sobre a imagem (ex.: SVG inline com `currentColor`). Ele fica dentro do link — sem link/botão dentro.
 
+## Conta e segurança (painel de configurações)
+
+A seção **Conta e segurança** do painel (`?settings=seguranca`) gerencia a conta da pessoa no Argos sem sair do app:
+**Verificação em duas etapas** (adicionar o aplicativo autenticador com QR Code, adicionar o e-mail, trocar o aparelho,
+remover), **Códigos de recuperação** (gerar um lote novo, mostrado uma vez, com copiar e baixar) e **Sessões e
+dispositivos** (encerrar uma sessão ou todas as outras; a deste login vem marcada). Antes de qualquer alteração a
+pessoa confirma a identidade (senha, código do autenticador, código no e-mail cadastrado ou código de recuperação); o
+Argos guarda essa prova por 5 minutos.
+
+- **API**: a área da conta do Argos com Bearer, `{authority}/api/realms/{realmId}/account/*` (`security`, `reauth`,
+  `mfa/*`, `recovery-codes`, `sessions`), com o access token da sessão do `@orfeu/angular` no `Authorization` — o
+  mesmo `{authority}/api` que o Orfeu usa no OIDC (a `authority` já traz o `/argos`). Sem cookie: o Argos reconhece
+  a sessão pelo `sid` do token. Token vencido renova uma vez e repete.
+- **Configuração**: nenhuma além do `provideAuth`. A origem do app precisa estar nas `redirect_uris` do client no
+  Argos (é o que o CORS do Argos libera — o login já exige isso). Sem `authority`/`realmId` (ou com `CHANGE_ME`) a
+  seção não aparece.
+- **Versão do Argos**: precisa da área da conta por Bearer (`/realms/{realm}/account`). Num Argos anterior a seção
+  mostra o erro de carregamento.
+- A mesma API sai de `SpineAccountSecurityService` / `argosAccountApi(authority, realm)` (`@trismegisto/spine/layout`),
+  para outra tela do app.
+
 ## Pontos de entrada
 
 | Import | Conteúdo |
@@ -123,7 +149,7 @@ provideUi({
 | `@trismegisto/spine/modal` | `ModalService` (`open(config)` devolve um `Observable` com o resultado), `ModalContent` |
 | `@trismegisto/spine/side-panel` | `SidePanelService`, `SidePanelContent` |
 | `@trismegisto/spine/notification` | `NotificationService` (`addNotification`) |
-| `@trismegisto/spine/auto-service` | `provideAutoService({ adminApi })`: telas prontas de autosserviço (início, grupos, aplicações, cliente, auditoria), sempre carregadas sob demanda (`AUTO_SERVICE_SCREENS`); as classes das telas não são exportadas. `AutoServiceService` e o tipo `AutoServiceClient` são |
+| `@trismegisto/spine/auto-service` | `provideAutoService({ adminApi })`: telas prontas de autosserviço (início, grupos, aplicações, cliente, auditoria), sempre carregadas sob demanda (`AUTO_SERVICE_SCREENS`); as classes das telas não são exportadas. Cada tela já vem com a documentação (manual de uso e especificação técnica, em `AUTO_SERVICE_DOCUMENTS`, também sob demanda) no botão de documentação da página. `AutoServiceService` e o tipo `AutoServiceClient` são exportados |
 | `@trismegisto/spine/audit` | A tela de Auditoria (`SpineAuditComponent`, `spine-audit`), a mesma para o painel central (`scope="admin"`) e o auto-serviço (`scope="client"`), + `SpineAuditService` e os tipos/funções puras (`AuditEvent`, `AuditQuery`, `buildAuditQuery`, `auditApiBase`…). **Exporta o componente: importe só de código lazy** |
 | `@trismegisto/spine/graphql` | `provideGraphql({ endpoints })`: um cliente Apollo nomeado por backend |
 
@@ -174,7 +200,10 @@ component: async () => (await import('./admin-audit-page.component')).AdminAudit
   `provideAutoService`) pelo deles. Nunca forneça o token sem `multi: true`. Um `id` igual ao de uma tela
   base do shell faz o `provideShell` lançar erro.
 - **Documentação de tela** (`document.load`) é markdown cru importado como texto: configure o loader
-  `".md": "text"` no `angular.json` do app. O texto vai no chunk lazy da tela.
+  `".md": "text"` no `angular.json` do app. O `spine-markdown` limpa o HTML com um perfil restrito do DOMPurify
+  (`SPINE_MARKDOWN_PURIFY_CONFIG`): sem `<style>`/`style`, formulários e `<iframe>`; link externo abre em outra aba
+  com `rel="noopener noreferrer"`. Formatação além do Markdown (cor, layout) não passa. O texto vai no chunk lazy da tela. (As telas do auto-serviço não
+  dependem disso: o pacote publica o Markdown delas em módulos `.ts` próprios, cada um num chunk lazy.)
 - **Idioma:** os textos do spine seguem `HermesI18nService.setLocale` (o idioma em si se configura com
   `provideHermesI18n` do `@trismegisto/angular`). `provideSpineMessages({ override, catalogs })` só sobrescreve
   textos ou acrescenta idiomas.
@@ -198,7 +227,8 @@ O código fica em `projects/ui/` (um ponto de entrada por pasta). `npm run build
 empacota com ng-packagr em `dist/ui/` (o que vai publicado) e copia este README para lá
 (`scripts/copy-readme.mjs`); `npm run check-strings` sozinho confere que
 nenhum texto de interface está fora do catálogo. O build termina com `scripts/check-lazy.mjs`, que falha se uma
-tela carregada por `import()` (as do auto-serviço) acabar colada no arquivo do ponto de entrada, ou se o ponto
+tela carregada por `import()` (as do auto-serviço) ou o texto da documentação delas acabar colado no arquivo do
+ponto de entrada, ou se o ponto
 principal/`auto-service` importar `@trismegisto/spine/audit` estaticamente — acontece quando
 ela é exportada no `public-api.ts` (o rollup troca o `import()` por `Promise.resolve()` e a tela vai para o bundle
 inicial do app).

package/fesm2022/trismegisto-spine-audit.mjs

@@ -299,7 +299,7 @@ class SpineAuditService {
     }
     /** Um ranking paginado (`apps` | `operations` | `users`) com os mesmos filtros/janela do resumo. */
     tops(base, kind, query, page) {
-        return firstValueFrom(this.http.get(`${base}/tops/${kind}`, { headers: this.headers, params: auditParams(query, page) }));
+        return firstValueFrom(this.http.get(`${base}/tops/${encodeURIComponent(kind)}`, { headers: this.headers, params: auditParams(query, page) }));
     }
     /** Apps para o filtro (`{ apps: [{ id, name }] }` — `/admin/apps` ou `/auto-service/:clientId/apps`). */
     apps(url) {