@oondemand/create-central-oon 0.6.6 → 0.6.8

package/docs/APP_LICENSING.md

@@ -0,0 +1,66 @@
+# Licença comercial por aplicativo — contrato 1 (Core 0.6.7)
+
+Disponível no namespace público `licensing` de `@oondemand/oon-core-back`.
+Requer a Central de Ativações com `/licensing/decision` e `/licensing/identity`.
+O SDK não substitui autenticação, RBAC, vínculo de Deployment ou licença organizacional.
+
+```js
+const { licensing } = require("@oondemand/oon-core-back");
+await licensing.assertBusinessOperation({ tenantId: accessContext.tenantId, correlationId });
+// Inicie agora o efeito autorizado: PDF, e-mail, emissão ou mutação externa.
+```
+
+Chame imediatamente antes de **cada novo efeito**, inclusive em jobs aceitos anteriormente.
+Não guarde autorização no JWT, snapshot ou cache positivo. A decisão é uma leitura pontual;
+uma suspensão posterior não cancela uma chamada já iniciada nem desfaz um efeito confirmado.
+Preserve recibos, callbacks, reconciliação, downloads já gerados e histórico sem reiniciar efeitos.
+
+O Core usa identidade operacional do próprio Deployment e a autoridade configurada pelo
+runtime. O App não configura URL da Central, credencial interna ou transporte paralelo.
+Timeout de 3 segundos, sem redirects, sem retry e sem cache positivo. Resposta ausente,
+incompatível ou de outro escopo retorna `LICENSE_AUTHORITY_UNAVAILABLE` (503).
+Runtime local não pode obter identidade operacional: `LOCAL_OPERATION_NOT_SUPPORTED`.
+Em testes unitários, injete o guard na camada de domínio; isso nunca habilita operação local real.
+
+Um contrato bloqueado retorna HTTP 423 com código `APP_LICENSE_REQUIRED`,
+`APP_LICENSE_NOT_STARTED`, `APP_LICENSE_EXPIRED`, `APP_LICENSE_SUSPENDED`,
+`APP_LICENSE_CANCELLED`, `APP_LICENSE_OVERDUE` ou `APP_LICENSE_INVALID`.
+Bloqueios organizacionais e de entitlement também são preservados.
+Exiba a razão comercial; deixe a operação pendente. Pagamento não renova nem reativa sozinho.
+
+## Gateway que recebe chamadas de outros Apps
+
+```js
+const identity = await licensing.verifyConsumerRequest({
+  headers: req.headers,
+  requireLicense: false,
+});
+// Vincule identity.{tenantId,appCode,environment} ao consumidor cadastrado no gateway.
+// Autorize base e operação no domínio do gateway, depois:
+await licensing.verifyConsumerRequest({ headers: req.headers, requireLicense: true });
+```
+
+`requireLicense` é `true` por padrão. `false` consulta apenas a identidade e vínculo
+ativo Deployment–tenant, permitindo receber/consultar evidências durante suspensão.
+**Não autoriza um efeito novo.** A autenticação específica do consumidor e sua política
+continuam obrigatórias. O bearer do gateway nunca é encaminhado à Central.
+
+Headers obrigatórios: `x-oon-deployment-id`, `x-oon-deployment-token`, `x-app-code`,
+`x-oon-tenant-id`. Eles só são confiáveis depois da validação remota. Não aceite App,
+ambiente ou tenant do body. Todas as respostas são comparadas com o escopo solicitado.
+Nenhum segredo ou diagnóstico bruto do provedor é incluído nos erros normalizados.
+
+## Resposta da autoridade
+
+`POST /licensing/decision` (body vazio): `schemaVersion: 1`, `appCode`, `tenantId`,
+`environment`, `allowed`, `code`, `version`, `checkedAt`, `maxAgeSeconds: 0`.
+Permissão exige versão positiva e código nulo; negação tem código reconhecido.
+`POST /licensing/identity`: `schemaVersion: 1`, `appCode`, `tenantId`, `environment`,
+`maxAgeSeconds: 0`. Respostas autenticadas têm `Cache-Control: no-store`.
+
+## Limite atual de jobs
+
+Este contrato oferece o guard de efeitos, não um executor durável de integrações.
+A documentação de process jobs existente não especifica registro público de handlers
+externos, inbox/outbox e retomada autônoma necessários ao gateway da issue #170.
+Essa extensão precisa de contrato e testes próprios antes de declarar I4 concluída.

package/docs/BACKEND_API.md

@@ -38,7 +38,12 @@ O namespace público `capabilities` contém:
 
 O App nunca configura URL, credencial interna ou implementação de uma capability. A única exceção é a injeção de dublês documentada para testes automatizados.
 
-`operationalRequestHeaders(options)` produz headers de identidade do Deployment. Retorna `LOCAL_OPERATION_NOT_SUPPORTED` no runtime local; nunca improvise identidade local.
+`operationalRequestHeaders({ tenantId, correlationId })` produz headers de identidade do Deployment. O tenant vem do contexto validado e correlationId é opcional. Retorna `LOCAL_OPERATION_NOT_SUPPORTED` no runtime local; nunca improvise identidade local.
+
+## Licença por App
+
+`licensing.assertBusinessOperation` e `licensing.verifyConsumerRequest` (0.6.7):
+consulte [APP_LICENSING.md](APP_LICENSING.md) para escopo, erros, local, jobs e reconciliação.
 
 ## Runtime local
 

package/docs/FRONTEND_API.md

@@ -23,9 +23,18 @@ O contrato principal do frontend é code-first.
 - `useOonApi`, `useOonResource`, `useCoreMetadata`, `useModelSchema`: acesso padronizado;
 - rotas reservadas e guards obrigatórios pertencem ao Core.
 
+## Contexto e descarte de estado por tenant
+
+`useOonTenant()` devolve `{activeTenantId: string | null, switchTenant(id), clearTenant()}`
+em Apps com tenancy. Não chame esse hook em Apps `tenancyModel=none`.
+O Core atualiza o header e limpa o cache de queries na troca. Estado React local,
+formulários, tokens de uso único e respostas assíncronas também devem ser descartados:
+uma página filha com `key={activeTenantId ?? "no-tenant"}` é uma composição possível.
+`useOonAuth().hasPermission(code)` permite ocultar ações, com autorização obrigatória
+e independente no backend. `useOonApi()` fornece `{http}` para o cliente autenticado.
+
 ## Domínio e UI
 
 Views declarativas continuam disponíveis como composição opcional dentro do
 objeto App. Componentes, páginas e layouts locais podem ser usados em qualquer
 `appKind`. Consulte `FRONTEND_CODE_FIRST.md`.
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oondemand/create-central-oon",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",

package/templates/_base/backend/package.json

@@ -12,6 +12,6 @@
     "deploy": "oonCore-back deploy"
   },
   "dependencies": {
-    "@oondemand/oon-core-back": "^0.6.6"
+    "@oondemand/oon-core-back": "^0.6.8"
   }
 }

package/templates/_base/frontend/package.json

@@ -11,7 +11,7 @@
     "sync:metadata": "oonCore-front sync:metadata"
   },
   "dependencies": {
-    "@oondemand/oon-core-front": "^0.6.6",
+    "@oondemand/oon-core-front": "^0.6.8",
     "@chakra-ui/react": "^3.13.0",
     "@emotion/react": "^11.14.0",
     "@tanstack/react-query": "^5.65.0",

package/templates/_base/package.json

@@ -13,6 +13,6 @@
     "dev:frontend": "npm run dev --prefix frontend"
   },
   "devDependencies": {
-    "@oondemand/create-central-oon": "0.6.6"
+    "@oondemand/create-central-oon": "0.6.8"
   }
 }