@mybuildex/pkg 0.10.2 → 0.11.0

package/README.md

@@ -51,6 +51,34 @@ createAuthMiddleware({
 createTenantMiddleware({getTenantClient, defaultClient, strictTenant: true});
 ```
 
+## 0.11.0 — governança de rede de escolas (matriz/filial)
+
+Módulo novo, opt-in: API que não registra o plugin não muda nada. Veio da `v1_settings` sem mudança de comportamento (19/10/2026), para as outras APIs ligarem com uma linha.
+
+- **`createNetworkPlugin({ttlMs, enabled, logger})`** — a escola é de rede quando o PRÓPRIO banco tem `configs.key = 'REDE'` com `TRUE` (gravada pelo core Go). Sem a flag o core nem é consultado. Com ela, o papel e as regras vêm do banco core (`my_builder_<env>_core`, por SQL cru qualificado no mesmo pool; env `CORE_DATABASE` sobrescreve):
+  - **filial** — cada ação (`read/add/edit/remove/restore/delete`) numa tabela do catálogo de módulos passa pelas `networks_policies`, **acima** da ACL: nega com 403 mesmo com a permissão do usuário. A ação sai da constante do router (`routeAcl.key` gravada pelo `useModuleAcl`) ou, sem ela, do método HTTP. A tabela é o segmento depois de `/v1/:id_school/`.
+  - **matriz** — pode tudo; o que grava nas tabelas do catálogo é replicado nas filiais com o mesmo id, numa transação única, no `onSend` (antes da resposta). Falha na réplica vira 500 com mensagem clara (a matriz já gravou, nenhuma filial foi alterada).
+  - **standalone** — sem flag, sem vínculo ou rede removida: nada muda.
+  - Core fora do ar numa escola de rede: 503 (fail-closed). Contexto em cache por escola (`NETWORK_CACHE_TTL_MS`, default 30 s). `NETWORK_GOVERNANCE=off` desliga tudo.
+- **Ordem no `loadPlugins`:** depois do `createAclPlugin` (usa a `routeAcl` dele) e **antes** do `createCompressPlugin` (o `onSend` da réplica pode trocar o corpo por erro).
+- **Para o front:** `effectivePermissions(request.network ?? standaloneContext(id))` devolve `{tabela: {read, add, ...}}` — é o que o `GET /v1/:id_school/networks/effective` da `v1_settings` responde.
+- Limitações (como antes): SQL cru na matriz não replica; escrita aninhada em relação só replica a tabela do model chamado; a réplica não entra no `audit_logs`.
+
+```ts
+import {createNetworkPlugin} from "@mybuildex/pkg";
+
+const pluginNetwork = createNetworkPlugin();
+// loadPlugins
+await createAclPlugin({api: settings.PREFIX, mode: "enforce"})(fastify);
+await pluginNetwork(fastify);
+await pluginCors(fastify);
+await pluginCompress(fastify);
+```
+
+## 0.10.3 — ACL_MAP com split de pagamento
+
+- **`ACL_MAP` regerado do front** com os recursos `pay_split_recipients` (ações do CRUD + `sync`, para o botão "Sincronizar" que grava o recebedor no gateway) e `pay_split_rules`. Sem eles a `v1_payments` em enforce nega as rotas novas para todo mundo (10/10/2026). Nenhuma mudança de código.
+
 ## 0.10.2 — `trace` resumido na resposta de erro
 
 - **`createErrorHandler` devolve `{statusCode, message, trace}`.** `trace` é o resumo do erro REAL — `Nome: mensagem @ primeiro frame do stack`, numa linha, com no máximo 255 caracteres (`TRACE_MAX_CHARS`) — e vem mesmo quando `message` é a genérica "Erro interno no processamento". Motivo (10/10/2026): o upload de arquivo do produto respondia só a genérica e o que estava acontecendo era "The table `pay_products_files` does not exist" — isso só aparecia no Cloud Logging. Vale para todas as APIs ao subirem esta versão; `trace: false` desliga e `trace: <n>` troca o limite. `resumirTrace(error)` é exportado.

package/dist/acl/map.generated.js

@@ -1340,6 +1340,31 @@ exports.ACL_MAP = {
         "restore": ["full", "pay_products_types.restore", "tipos_produto.restaura"],
         "trash": ["full", "pay_products_types.trash", "tipos_produto.lixeira"],
     },
+    "pay_split_recipients": {
+        "add": ["full", "pay_split_recipients.add", "recebedores_split.adiciona"],
+        "delete": ["full", "pay_split_recipients.delete", "recebedores_split.exclui"],
+        "edit": ["full", "pay_split_recipients.edit", "recebedores_split.edita"],
+        "find": ["full", "pay_split_recipients.find", "recebedores_split.detalha"],
+        "list": ["full", "pay_split_recipients.list", "recebedores_split.lista"],
+        "menu": ["full", "pay_split_recipients.menu", "recebedores_split.menu"],
+        "paginate": ["full", "pay_split_recipients.paginate", "recebedores_split.pagina"],
+        "remover": ["full", "pay_split_recipients.remove", "recebedores_split.remove"],
+        "restore": ["full", "pay_split_recipients.restore", "recebedores_split.restaura"],
+        "sync": ["full", "pay_split_recipients.sync", "recebedores_split.sincroniza"],
+        "trash": ["full", "pay_split_recipients.trash", "recebedores_split.lixeira"],
+    },
+    "pay_split_rules": {
+        "add": ["full", "pay_split_rules.add", "regras_split.adiciona"],
+        "delete": ["full", "pay_split_rules.delete", "regras_split.exclui"],
+        "edit": ["full", "pay_split_rules.edit", "regras_split.edita"],
+        "find": ["full", "pay_split_rules.find", "regras_split.detalha"],
+        "list": ["full", "pay_split_rules.list", "regras_split.lista"],
+        "menu": ["full", "pay_split_rules.menu", "regras_split.menu"],
+        "paginate": ["full", "pay_split_rules.paginate", "regras_split.pagina"],
+        "remover": ["full", "pay_split_rules.remove", "regras_split.remove"],
+        "restore": ["full", "pay_split_rules.restore", "regras_split.restaura"],
+        "trash": ["full", "pay_split_rules.trash", "regras_split.lixeira"],
+    },
     "pay_status": {
         "add": ["full", "pay_status.add", "status_pagamento.adiciona"],
         "delete": ["full", "pay_status.delete", "status_pagamento.exclui"],