Único contrato da extensão. Quatro canais, identidade, logger e catálogo — sem token e sem SQL.

defineExtension entrega um objeto: ctx. É o único caminho até o Core. Não existe process.env de tenant, não existe import de farmus-api, não existe repositório.

src/index.ts

import { defineExtension } from "@m3r/sdk";
import { registerVendas } from "./vendas/register";

export default defineExtension({
  async activate(ctx) {
    ctx.logger.info("up", { executionId: ctx.executionId, sdk: ctx.runtime.sdkVersion });
    await registerVendas(ctx);
  },
  async deactivate(ctx) {
    ctx.logger.info("stop");
  }
});

Não registre IP nem tables.ensure no index. Padrões.

activate é awaited antes do runtime marcar a extensão como running. deactivate é awaited (com timeout) antes do processo sair. Não registre listener em deactivate.

Mapa

Campo	Papel	Pode recusar save?
`ctx.m3r`	A extensão chama o Core (hoje: vendas).	Não.
`ctx.events`	O Core avisou depois do commit.	Não.
`ctx.entryPoints`	O Core consulta no meio da tela ou do save.	Sim, em `BEFORE_*` / `ACTION`.
`ctx.ext`	Tabela, tela, menu e relatório declarativos.	Não. O ERP pinta.
`ctx.logger`	Log estruturado no host.	—
`ctx.subscriptions`	Dispose automático dos `on()`.	—
`ctx.capabilities`	`SDK_CATALOG` 0.5.0 congelado.	—
`identidade / runtime`	`extensionId`, tenant, `executionId`, modo.	—

Não existem ctx.auth, ctx.storage nem ctx.fetch. A credencial RUN fica no transport do host. KV próprio é ctx.ext.records.

O que pode

Registrar IPs e eventos no activate e jogar o disposable em ctx.subscriptions.
Chamar ctx.m3r.sales.* com os scopes declarados no m3r.json.
Declarar tabela/tela/menu/relatório e gravar linhas na sua tabela.
Ler ctx.capabilities para saber o que esta versão fecha.