@softize/opus 28.0.0 → 29.0.0

package/src/ui/docs/content/log.md

@@ -44,7 +44,7 @@ const runtime = createRuntime({
 
 // No handler: ctx.log já traz o request ID e a action, adicionados com child().
 handler: async (ctx, input) => {
-  ctx.log.info('emitindo nota', { valor: input.valor })
+  ctx.log.info('emitindo nota', { amount: input.amount })
   return repo.create(input)
 }
 ```

package/src/ui/docs/content/queue.md

@@ -59,11 +59,11 @@ const runtime = createRuntime({
   queue,
 })
 
-export const relatorioGerar = bindAction(relatorioGerarContract, {
+export const reportGenerate = bindAction(reportGenerateContract, {
   background: { enabled: true, retry: { attempts: 3 }, progress: true },
   handler: async (ctx, input, loaded, progress) => {
     await progress?.report({ percent: 50, message: 'Consultando dados' })
-    return gerarRelatorio(input)
+    return generateReport(input)
   },
 })
 ```

package/src/ui/docs/content/router.md

@@ -76,5 +76,5 @@ o erro de uso.
 
 `navigate` espera um caminho da própria origem e não valida destinos. Quando o destino vem de fora,
 como o `?redirect=` de um pós-login, valide-o antes de navegar: resolva com
-`new URL(valor, origin)` e compare o `origin` do resultado, em vez de conferir apenas o prefixo do
+`new URL(target, origin)` e compare o `origin` do resultado, em vez de conferir apenas o prefixo do
 texto.

package/src/ui/docs/content/scheduler.md

@@ -47,26 +47,26 @@ Declare o schedule com `defineSchedule` e registre-o no domínio, ao lado da act
 
 ```ts
 import { createRuntime, defineDomain, defineSchedule } from '@softize/opus/core'
-import { caixaFechar } from './caixa-fechar.ts' // a action 'caixa.fechar', preparada abaixo
+import { ledgerClose } from './ledger-close.ts' // a action 'ledger.close', preparada abaixo
 
-const fecharDia = defineSchedule({
-  name: 'caixa.fechar-dia',
-  action: 'caixa.fechar',
+const closeDay = defineSchedule({
+  name: 'ledger.close-day',
+  action: 'ledger.close',
   cron: '0 23 * * *',
   timezone: 'America/Sao_Paulo',
 })
 
-export const caixaDomain = defineDomain({
-  name: 'caixa',
-  actions: { caixaFechar },
-  schedules: [fecharDia],
+export const ledgerDomain = defineDomain({
+  name: 'ledger',
+  actions: { ledgerClose },
+  schedules: [closeDay],
 })
 
 const runtime = createRuntime({
   // …server/data…
   scheduler,
 })
-runtime.register([caixaDomain])
+runtime.register([ledgerDomain])
 await runtime.start()
 ```
 
@@ -91,18 +91,18 @@ recusa o sistema até que o contrato dela aceite essa execução com `automatabl
 ```ts
 import { defineContract, isSystemActor } from '@softize/opus/core'
 
-export const caixaFecharContract = defineContract({
-  name: 'caixa.fechar',
+export const ledgerCloseContract = defineContract({
+  name: 'ledger.close',
   kind: 'simple',
   input: z.object({}),
-  output: z.object({ fechados: z.number() }),
+  output: z.object({ closedEntries: z.number() }),
   automatable: true,
 })
 
-export const caixaFechar = bindAction(caixaFecharContract, {
+export const ledgerClose = bindAction(ledgerCloseContract, {
   // O sistema não tem permissões: aceite-o de forma explícita ao lado da regra das pessoas.
-  authorize: (ctx) => isSystemActor(ctx) || ctx.can('caixa:fechar'),
-  handler: async (ctx) => ({ fechados: await caixa.fecharDia() }),
+  authorize: (ctx) => isSystemActor(ctx) || ctx.can('ledger:close'),
+  handler: async (ctx) => ({ closedEntries: await ledger.closeDay() }),
 })
 ```
 

package/src/ui/docs/content/testing.md

@@ -70,8 +70,8 @@ runtime: `ctx.user` é `null`, `ctx.can` nega tudo e `isSystemActor(ctx)` respon
 
 ```ts
 it('o fechamento diário roda pelo sistema', async () => {
-  const { output } = await runAction(caixaFechar, {}, { schedule: 'caixa.fechar-dia' })
-  expect(output.fechados).toBeGreaterThan(0)
+  const { output } = await runAction(ledgerClose, {}, { schedule: 'ledger.close-day' })
+  expect(output.closedEntries).toBeGreaterThan(0)
 })
 ```
 
@@ -102,8 +102,8 @@ validação de chave dos drivers reais:
 import { memStorage, runAction } from '@softize/opus/testing'
 
 const storage = memStorage()
-await runAction(notaAnexar, { id: '9' }, { user, storage })
-expect(storage.keys()).toEqual(['notas/9.pdf'])
+await runAction(invoiceAttach, { id: '9' }, { user, storage })
+expect(storage.keys()).toEqual(['invoices/9.pdf'])
 ```
 
 ## fake — dados gerados pelo schema

package/src/vite/design.ts

@@ -89,7 +89,7 @@ export interface OpusDesignOptions {
   entry?: string | string[]
 
   /**
-   * Cenários de design (ADR 0037): módulos que exportam `defineDesignScenario(contrato, resposta)`.
+   * Cenários de design (ADR 0037): módulos que exportam `defineDesignScenario(contract, response)`.
    * Aceita caminhos e globs, como `entry`. O cenário vence a resposta padrão gerada pelo `fake`;
    * cenário de action inexistente impede o boot, com a lista no erro.
    * Sem default: o projeto decide onde os cenários ficam e se são versionados.