cosmemilton-acbr-node 0.1.2 → 0.2.1

package/docs/DEPENDENCIAS-NATIVAS.md

@@ -1,93 +1,103 @@
-# Reconstrução gratuita das DLLs Windows x64
-
-O motor Pascal usa OpenSSL 3 e libxml2 como bibliotecas dinâmicas. As DLLs distribuídas podem ser reconstruídas no Ubuntu 24.04/WSL com MinGW-w64, sem compilador comercial e sem Visual C++ Redistributable.
-
-A receita fixa OpenSSL **3.5.9** e libxml2 **2.15.4**. Usa os arquivos oficiais e confere SHA-256 antes de extrair ou compilar:
-
-| Fonte | SHA-256 |
-| --- | --- |
-| `openssl-3.5.9.tar.gz` | `603f5602e2eef00d77fbd429d34dcd5822bb301757a1bc9cdb24c670f1eb859a` |
-| `libxml2-2.15.4.tar.xz` | `98087fd181d9070724f3fbc65c7377db03038eb92bd882374daff44940138821` |
-
-Os hashes foram comparados aos arquivos publicados pelos projetos: [OpenSSL 3.5.9 e checksum](https://github.com/openssl/openssl/releases/tag/openssl-3.5.9), [checksum libxml2](https://download.gnome.org/sources/libxml2/2.15/libxml2-2.15.4.sha256sum). O script contém as URLs exatas dos tarballs e dos respectivos checksums.
-
-## Ferramentas e execução
-
-No Ubuntu 24.04/WSL:
-
-```sh
-sudo apt-get update
-sudo apt-get install gcc-mingw-w64-x86-64 g++-mingw-w64-x86-64 \
-  binutils-mingw-w64-x86-64 cmake ninja-build make perl curl tar xz-utils
-```
-
-Na raiz deste projeto:
-
-```sh
-node scripts/build-native-deps.mjs --project "$PWD"
-```
-
-O script do pacote instalado também pode ser usado:
-
-```sh
-node node_modules/cosmemilton-acbr-node/scripts/build-native-deps.mjs \
-  --project "$PWD"
-```
-
-Downloads ficam em `.acbr/deps/downloads`; fontes, objetos, instalação intermediária e logs ficam em `.acbr/deps/build/windows`. Os arquivos finais ficam em `.acbr/deps/win32-x64`. O comando não compila o motor ACBr e não acessa serviços fiscais.
-
-Para aproveitar tarballs já disponíveis, indique os arquivos. O hash continua obrigatório; os arquivos originais são somente lidos:
-
-```sh
-node scripts/build-native-deps.mjs --project "$PWD" --jobs 4 \
-  --openssl-archive /caminho/openssl-3.5.9.tar.gz \
-  --libxml2-archive /caminho/libxml2-2.15.4.tar.xz
-```
-
-Após uma interrupção, `--resume` reaproveita a configuração OpenSSL existente somente se revisão, argumentos e ambiente coincidirem. Use a mesma instalação de ferramentas; após mudar o compilador, execute o comando sem essa opção para reconfigurar. A reutilização aparece em `SOURCE.json`.
-
-Cada comando tem seu log em `.acbr/deps/build/windows/logs`. Em falhas, o script informa o caminho e o final do log. Apenas depois de todas as compilações e auditorias bem-sucedidas substitui as DLLs finais e remove os artefatos temporários conhecidos do build anterior com MSVC.
-
-## Configuração do build
-
-O OpenSSL é configurado como `mingw64 shared`, com assembly x64, `-static-libgcc`, timestamp PE fixo e provider `legacy`. A compilação cruzada segue o [procedimento oficial MinGW](https://github.com/openssl/openssl/blob/openssl-3.5.9/NOTES-WINDOWS.md) e a [documentação de instalação](https://github.com/openssl/openssl/blob/openssl-3.5.9/INSTALL.md).
-
-O libxml2 usa CMake/Ninja, compilador `x86_64-w64-mingw32-gcc-win32` e biblioteca compartilhada. XML Schema, C14N, threads, XPath e serialização permanecem habilitados. Python, iconv, ICU, zlib, HTTP e APIs legacy opcionais ficam desabilitados; os documentos NF-e usam UTF-8. As opções são as do `CMakeLists.txt` incluído no [tarball oficial libxml2 2.15.4](https://download.gnome.org/sources/libxml2/2.15/libxml2-2.15.4.tar.xz).
-
-O GCC usa o modelo de threads Win32 e o runtime GCC estático. O libxml2 também recebe `-static-libstdc++` no link, embora seu código seja C. Não se distribuem `libgcc_s`, `libstdc++`, `libwinpthread` nem `vcruntime140`; `msvcrt.dll` é um componente do próprio Windows. A auditoria dos imports PE rejeita qualquer dependência fora das quatro DLLs produzidas e da lista explícita de DLLs do sistema.
-
-`SOURCE_DATE_EPOCH=0` e `--no-insert-timestamp` reduzem variação de timestamps. O manifesto registra ferramentas, argumentos e hashes reais dos binários; não afirma identidade binária entre versões diferentes de compilador ou diretórios de build.
-
-## Artefatos, licenças e staging
-
-A saída inclui:
-
-- `libcrypto-3-x64.dll`, `libssl-3-x64.dll`, `legacy.dll` e `libxml2.dll`;
-- licença original adjacente `<DLL>.LICENSE` para cada DLL;
-- `GCC-Runtime.LICENSE`, `GCC-GPL-3.LICENSE` e `MinGW-w64.LICENSE`, que preservam os avisos do código de runtime incorporado;
-- `SOURCE.json` com URLs, versões, hashes dos fontes/binários, comandos, ferramentas e imports PE.
-
-OpenSSL preserva Apache-2.0; libxml2 preserva sua licença MIT. O arquivo do GCC contém a [GCC Runtime Library Exception 3.1](https://www.gnu.org/licenses/gcc-exception-3.1.html), além dos avisos aplicáveis. Os avisos MinGW-w64 vêm do pacote instalado, sem substituir os textos originais por uma licença genérica do projeto.
-
-Para compilar o motor Windows, configure os caminhos das DLLs no arquivo de configuração usado pelo CLI, por exemplo:
-
-```json
-{
-  "native": {
-    "libraryFiles": [
-      ".acbr/deps/win32-x64/libcrypto-3-x64.dll",
-      ".acbr/deps/win32-x64/libssl-3-x64.dll",
-      ".acbr/deps/win32-x64/libxml2.dll"
-    ],
-    "providerFiles": [".acbr/deps/win32-x64/legacy.dll"]
-  }
-}
-```
-
-Mantenha os outros campos existentes de `acbr.config.json`, como compilador, projeto Pascal e diretório Lazarus. O build do motor faz o staging das DLLs, de todas as licenças e de `SOURCE.json`. O provider vai para `ossl-modules`; o processo auxiliar recebe `OPENSSL_MODULES` e `OPENSSL_CONF` do runtime gerado, sem depender dos diretórios da máquina que compilou o OpenSSL.
-
-## Validação
-
-A receita confere arquitetura PE x64, imports de todas as DLLs e exports essenciais de libxml2 para parsing, C14N e XML Schema. A compilação cruzada não executa a suíte upstream no Linux: os testes gerados são executáveis Windows. `SOURCE.json` registra explicitamente essa limitação.
-
-Depois do staging, execute os testes offline do worker no Windows: geração de XML, assinatura com certificado temporário, validação dos schemas e TLS contra servidor local. Essa etapa comprova o funcionamento das DLLs no alvo. Os testes locais não autorizam emissão ou transmissão fiscal.
+# Reconstrução gratuita das DLLs Windows x64
+
+O motor Pascal usa OpenSSL 3 e libxml2 como bibliotecas dinâmicas. As DLLs distribuídas podem ser reconstruídas no Ubuntu 24.04/WSL com MinGW-w64, sem compilador comercial e sem Visual C++ Redistributable.
+
+A receita fixa OpenSSL **3.5.9** e libxml2 **2.15.4**. Usa os arquivos oficiais e confere SHA-256 antes de extrair ou compilar:
+
+| Fonte | SHA-256 |
+| --- | --- |
+| `openssl-3.5.9.tar.gz` | `603f5602e2eef00d77fbd429d34dcd5822bb301757a1bc9cdb24c670f1eb859a` |
+| `libxml2-2.15.4.tar.xz` | `98087fd181d9070724f3fbc65c7377db03038eb92bd882374daff44940138821` |
+
+Os hashes foram comparados aos arquivos publicados pelos projetos: [OpenSSL 3.5.9 e checksum](https://github.com/openssl/openssl/releases/tag/openssl-3.5.9), [checksum libxml2](https://download.gnome.org/sources/libxml2/2.15/libxml2-2.15.4.sha256sum). O script contém as URLs exatas dos tarballs e dos respectivos checksums.
+
+## Ferramentas e execução
+
+No Ubuntu 24.04/WSL:
+
+```sh
+sudo apt-get update
+sudo apt-get install gcc-mingw-w64-x86-64 g++-mingw-w64-x86-64 \
+  binutils-mingw-w64-x86-64 cmake ninja-build make perl curl tar xz-utils
+```
+
+Na raiz deste projeto:
+
+```sh
+node scripts/build-native-deps.mjs --project "$PWD"
+```
+
+O script do pacote instalado também pode ser usado:
+
+```sh
+node node_modules/cosmemilton-acbr-node/scripts/build-native-deps.mjs \
+  --project "$PWD"
+```
+
+Downloads ficam em `.acbr/deps/downloads`; fontes, objetos, instalação intermediária e logs ficam em `.acbr/deps/build/windows`. Os arquivos finais ficam em `.acbr/deps/win32-x64`. O comando não compila o motor ACBr e não acessa serviços fiscais.
+
+Para aproveitar tarballs já disponíveis, indique os arquivos. O hash continua obrigatório; os arquivos originais são somente lidos:
+
+```sh
+node scripts/build-native-deps.mjs --project "$PWD" --jobs 4 \
+  --openssl-archive /caminho/openssl-3.5.9.tar.gz \
+  --libxml2-archive /caminho/libxml2-2.15.4.tar.xz
+```
+
+Após uma interrupção, `--resume` reaproveita a configuração OpenSSL existente somente se revisão, argumentos e ambiente coincidirem. Use a mesma instalação de ferramentas; após mudar o compilador, execute o comando sem essa opção para reconfigurar. A reutilização aparece em `SOURCE.json`.
+
+Cada comando tem seu log em `.acbr/deps/build/windows/logs`. Em falhas, o script informa o caminho e o final do log. Apenas depois de todas as compilações e auditorias bem-sucedidas substitui as DLLs finais e remove os artefatos temporários conhecidos do build anterior com MSVC.
+
+## Configuração do build
+
+O OpenSSL é configurado como `mingw64 shared`, com assembly x64, `-static-libgcc`, timestamp PE fixo e provider `legacy`. A compilação cruzada segue o [procedimento oficial MinGW](https://github.com/openssl/openssl/blob/openssl-3.5.9/NOTES-WINDOWS.md) e a [documentação de instalação](https://github.com/openssl/openssl/blob/openssl-3.5.9/INSTALL.md).
+
+O libxml2 usa CMake/Ninja, compilador `x86_64-w64-mingw32-gcc-win32` e biblioteca compartilhada. XML Schema, C14N, threads, XPath e serialização permanecem habilitados. Python, iconv, ICU, zlib, HTTP e APIs legacy opcionais ficam desabilitados; os documentos NF-e usam UTF-8. As opções são as do `CMakeLists.txt` incluído no [tarball oficial libxml2 2.15.4](https://download.gnome.org/sources/libxml2/2.15/libxml2-2.15.4.tar.xz).
+
+O GCC usa o modelo de threads Win32 e o runtime GCC estático. O libxml2 também recebe `-static-libstdc++` no link, embora seu código seja C. Não se distribuem `libgcc_s`, `libstdc++`, `libwinpthread` nem `vcruntime140`; `msvcrt.dll` é um componente do próprio Windows. A auditoria dos imports PE rejeita qualquer dependência fora das quatro DLLs produzidas e da lista explícita de DLLs do sistema.
+
+`SOURCE_DATE_EPOCH=0` e `--no-insert-timestamp` reduzem variação de timestamps. O manifesto registra ferramentas, argumentos e hashes reais dos binários; não afirma identidade binária entre versões diferentes de compilador ou diretórios de build.
+
+## Artefatos, licenças e staging
+
+A saída inclui:
+
+- `libcrypto-3-x64.dll`, `libssl-3-x64.dll`, `legacy.dll` e `libxml2.dll`;
+- licença original adjacente `<DLL>.LICENSE` para cada DLL;
+- `GCC-Runtime.LICENSE`, `GCC-GPL-3.LICENSE` e `MinGW-w64.LICENSE`, que preservam os avisos do código de runtime incorporado;
+- `SOURCE.json` com URLs, versões, hashes dos fontes/binários, comandos, ferramentas e imports PE.
+
+OpenSSL preserva Apache-2.0; libxml2 preserva sua licença MIT. O arquivo do GCC contém a [GCC Runtime Library Exception 3.1](https://www.gnu.org/licenses/gcc-exception-3.1.html), além dos avisos aplicáveis. Os avisos MinGW-w64 vêm do pacote instalado, sem substituir os textos originais por uma licença genérica do projeto.
+
+Para compilar o motor Windows, configure os caminhos das DLLs no arquivo de configuração usado pelo CLI, por exemplo:
+
+```json
+{
+  "native": {
+    "libraryFiles": [
+      ".acbr/deps/win32-x64/libcrypto-3-x64.dll",
+      ".acbr/deps/win32-x64/libssl-3-x64.dll",
+      ".acbr/deps/win32-x64/libxml2.dll"
+    ],
+    "providerFiles": [".acbr/deps/win32-x64/legacy.dll"]
+  }
+}
+```
+
+Mantenha os outros campos existentes de `acbr.config.json`, como compilador, projeto Pascal e diretório Lazarus. O build do motor faz o staging das DLLs, de todas as licenças e de `SOURCE.json`. O provider vai para `ossl-modules`; o processo auxiliar recebe `OPENSSL_MODULES` e `OPENSSL_CONF` do runtime gerado, sem depender dos diretórios da máquina que compilou o OpenSSL.
+
+## Validação
+
+### Textos integrais nos runtimes Linux e Windows
+
+Os avisos originais de dependências permanecem com seus bytes originais em `runtime/licenses`. Alguns avisos Debian/Ubuntu remetem a `/usr/share/common-licenses/NAME`; essa referência descreve a máquina de build, e o texto também precisa acompanhar o runtime distribuído.
+
+O build usa `scripts/runtime-license-inventory.mjs` antes de gerar o manifesto. O helper copia para `runtime/licenses/common` os textos canônicos fixados em `docs/licenses/common/ORIGIN.json`, resolve referências adicionais e aliases como `GPL` e `LGPL`, e inclui Apache-2.0 nos dois sistemas. `INVENTORY.json` registra os nomes, tamanhos, SHA-256, avisos que exigem cada texto e sua origem. Os textos e o inventário entram nos hashes de `runtime/manifest.json`.
+
+O build, sua conferência, o empacotamento e a auditoria de release recusam referências desconhecidas, textos ausentes ou truncados, links e material sem hash no manifesto. A comparação usa os textos aprovados do SDK, além dos hashes do próprio runtime. O validador do bundle também compara a política e os textos dentro do SDK extraído com o checkout revisado. Assim, recalcular o manifesto de um pacote incompleto não supre o texto ausente.
+
+Uma nova referência exige acrescentar seu texto integral e origem verificável à política revisada. O processo preserva os avisos específicos dos componentes e o licenciamento próprio de cada um. Alterações nesse material geram novos manifestos e tarballs em uma nova versão; os artefatos de versões publicadas permanecem preservados.
+
+A receita confere arquitetura PE x64, imports de todas as DLLs e exports essenciais de libxml2 para parsing, C14N e XML Schema. A compilação cruzada não executa a suíte upstream no Linux: os testes gerados são executáveis Windows. `SOURCE.json` registra explicitamente essa limitação.
+
+Depois do staging, execute os testes offline do worker no Windows: geração de XML, assinatura com certificado temporário, validação dos schemas e TLS contra servidor local. Essa etapa comprova o funcionamento das DLLs no alvo. Os testes locais não autorizam emissão ou transmissão fiscal.

package/docs/VALIDACAO.md

@@ -1,67 +1,67 @@
-# Validação da implementação
-
-Validações registradas em 08/10/2026 para a versão **0.1.0**. A publicação npm e sua automação pela branch `release` foram autorizadas pelo usuário em **09/10/2026**. Os artefatos estão preparados; a publicação ainda não foi executada neste registro.
-
-Em 09/10/2026, os nomes npm foram definidos sem escopo, seguindo os pacotes existentes `cosmemilton-ui` e `cosmemilton-report`: `cosmemilton-acbr-node`, `cosmemilton-acbr-node-linux-x64` e `cosmemilton-acbr-node-win32-x64`. Duas gerações consecutivas produziram os mesmos arquivos; somente o import do cliente gerado mudou. O contrato, os 204 modelos, o mapper Pascal, o lock e todos os arquivos dos runtimes Linux/Windows permanecem idênticos. Os manifests dos runtimes atualizam somente `generatedFileHashes` para vincular o import novo. Typecheck, bundles JavaScript e 27 testes focados do gerador, supervisor e auditoria passaram com os nomes finais. Nenhum motor foi recompilado.
-
-As validações anteriores de instalação ESM/CommonJS descritas abaixo usaram o namespace `@cosmemilton`. A aceitação dos nomes finais foi concluída em 09/10/2026 com os tarballs auditados, instalados fora do repositório: Linux com Node 22.12.0/24.15.0 e Windows nativo com Node 22.12.0/24.18.0, em ESM e CommonJS. Cada execução processou quatro documentos sintéticos (dois emitentes × modelos 55/65), com geração, assinatura e validação: 96 operações reais ao todo. O runtime foi resolvido pelo pacote instalado, sem compilador no PATH. Relatórios e hashes constam em `release/0.1.0/VALIDATION.json`; evidências locais em `.acbr/unscoped-consumer-evidence/`.
-
-A verificação completa com os nomes finais aprovou o typecheck e 38 testes, com quatro suítes nativas opt-in ignoradas; os motores mantêm a evidência anterior de 52 testes Linux e 52 Windows e os mesmos hashes. Auditoria e dry run dos três tarballs aprovados. Os exemplos públicos da documentação também foram conferidos: JavaScript gerou XML sintético usando o pacote instalado e TypeScript passou em modo estrito NodeNext. Nenhuma transmissão à SEFAZ foi realizada.
-
-O snapshot principal usa ACBr SVN **48590** e **204 tipos gerados**. O contrato é:
-
-```text
-e5a497cefe8e0e350a30da5cc04e88b35c38a98535893d52f878890260d1346d
-```
-
-Revisão e inventário dos fontes constam em `acbr.lock.json`. O manifesto `.acbr/generated/manifest.json` vincula fonte, contrato e SHA-256 dos modelos TypeScript, fábrica do cliente e mapper Pascal. O build verifica esses três arquivos antes e depois da compilação. Cada runtime inventaria e verifica os seus arquivos; revisão ou contrato divergentes são recusados.
-
-## Resultado das verificações
-
-| Verificação | Estado e evidência |
-| --- | --- |
-| Gerador FCL-passrc | **6 testes aprovados**: AST real, 204 tipos e RTC, herança/aliases, precedência das unidades, enums simbólicos, coleções `New/Items`, tipos desconhecidos, mudanças de contrato, determinismo e equivalência dos modelos extraídos com condicionais Linux/Windows. |
-| Geração nativa Windows | CLI `generate` executado no Windows com Free Pascal 3.2.2/FCL-passrc: extrator `extract-model.exe` PE, 204 tipos, r48590 e contrato idêntico ao Linux. Os SHA-256 dos três arquivos gerados também coincidiram entre as plataformas. |
-| Tipos e bundle Node | Typecheck e build final aprovados, bundles ESM/CommonJS e cliente gerado com resolução NodeNext conferidos. Entradas usam enums ACBr, strings decimais e datas civis; assinatura/protocolo/suplemento gerados pelo motor não são campos de entrada. |
-| Supervisor Node | **8 testes aprovados**: UTF-8, isolamento de emitentes, integridade/contrato, fila, cancelamento, crash, timeout, recuperação de resultado incerto e ausência de retry/segredos em erros aprovados. |
-| CLI/configuração/fontes | **11 testes aprovados** no registro `.acbr/cli-tests.log`: opções/revisões, init e colisões, caminhos relativos, origem SVN, snapshots, fontes alterados e concorrência. |
-| CLI check offline Linux/Windows | Quatro operações reais aprovadas em cada sistema após integridade: gerar XML55 sintético (mapper/chave/UTF-8), validar XML assinado com certificado público sintético, recusar XML malformado e recusar DTD/entidade externa. Sem credenciais A1 na configuração do smoke, sem acesso à rede ou transmissão. |
-| Motor Linux | **52 testes aprovados**: 27 do motor/TLS e 25 dos serviços SOAP locais. Incluem NF-e/NFC-e sintéticas, assinatura e schema, dados Unicode, datas/decimais/coleções, CSC/QRCode e casos de erro. |
-| Consumidor Linux com runtime instalado | **ESM e CommonJS aprovados com Node 24.15.0 e 22.12.0**. Para cada formato/versão: quatro documentos, dois emitentes sintéticos, modelos 55 e 65, 12 processos nas operações `gerarXml → assinar → validar`. Não foram chamados compiladores. |
-| Consumidor com revisão própria | Fluxo externo completo em **r48589**: init, atualização SVN, generate, build, check, doctor, TypeScript NodeNext e XML gerado pela fábrica própria. Contrato `369de708cd42003fc02a98397346d55b842ad3cb25a8422939bd7de0a00aad91`, distinto do snapshot principal. |
-| Dependências Windows | OpenSSL 3.5.9 e libxml2 2.15.4 recompilados de fontes oficiais com MinGW x64. SHA-256 dos fontes e imports/exports PE conferidos. DLLs não dependem de VC Redistributable nem de runtime GCC dinâmico externo. Licenças e `SOURCE.json` preservados. |
-| Motor Windows | Compilação e **rodada final de 52 testes aprovadas**: 20 do motor XML/A1/protocolo, sete TLS e 25 SOAP. Inclui NFC-e autorizada simulada (cStat 100), assinatura/QRCode/UTF-8 correlacionados e encerramento ao morrer o supervisor. |
-| Consumidor Windows com Node mínimo | **ESM e CommonJS aprovados com Node 22.12.0** em diretório externo. Cada formato executou quatro documentos (dois CNPJs × modelos 55/65) e 12 operações offline. O processo consumidor tinha apenas Node no `PATH`; o worker e as DLLs vieram do runtime instalado, sem execução de compiladores ou fontes do checkout. |
-| Distribuição e licenças | **7 testes de auditoria aprovados**, staging real Linux/Windows conferido e pack/dry-run dos três pacotes aprovados. Fontes, licenças e runtime inventariados. Tarballs de revisão em `.acbr/release-artifacts`: SDK cerca de 484 KiB, Linux 50 MiB e Windows 33 MiB. |
-| Docker / CI remota dos motores | **Não executados**. O Docker Desktop não tinha daemon disponível; os motores foram validados localmente em Linux/Windows. O workflow de publicação audita e publica esses tarballs, sem reconstruir os motores. |
-| Publicação npm | **Autorizada em 09/10/2026**, ainda não executada neste registro. A automação da branch `release` confere os tarballs contra hashes fixados em `release/0.1.0/manifest.json`. |
-
-A execução final de `npm test` teve **32 testes aprovados e quatro suítes opt-in ignoradas**: seis do gerador, 11 da CLI/configuração/fontes, oito do supervisor e sete de auditoria. Os testes nativos foram habilitados e executados separadamente: **52 Linux + 52 Windows**, sem falhas.
-
-As operações marcadas como XML, assinatura, schema e SOAP foram executadas contra o componente Pascal real e serviços locais sintéticos. Respostas simuladas não comprovam aceitação fiscal na SEFAZ.
-
-## Consumo sem compilação
-
-O teste `tests/package-install.mjs` instala somente os tarballs do SDK e do runtime em um diretório externo ao checkout, com npm offline e scripts de instalação desativados. O processo consumidor importa o pacote instalado em ESM/CommonJS; `criarEmissor` resolve o executável do pacote nativo sem `runtimeDirectory` ou caminho para o motor do repositório. Cada execução capturada corresponde ao worker instalado, com `PATH` restrito ao diretório do Node.
-
-No Linux, `LD_DEBUG=libs` confirmou OpenSSL, libxml2, ICU, zlib, liblzma, libgcc, libstdc++ e provider legacy dentro do runtime instalado. O sistema forneceu apenas glibc, loader, libm, libpthread e o módulo glibc `gconv/UTF-16.so`, confirmado como arquivo do pacote Ubuntu `libc6`. A evidência corresponde ao Ubuntu 24.04/glibc; não é um teste em container limpo nem uma validação de Alpine ou de qualquer distribuição Linux.
-
-Relatórios locais:
-
-- `.acbr/validation-evidence/consumers/acbr-node-runtime-consumer-linux-final/report-esm.json` e `report-cjs.json`: Node 24.15.0.
-- `.acbr/validation-evidence/consumers/acbr-node-runtime-consumer-linux-node22/report-esm.json` e `report-cjs.json`: Node 22.12.0.
-- `C:\SRI_SERVICES\acbr-node-runtime-consumer-win32-node22-final\report-esm.json` e `report-cjs.json`: Windows com Node 22.12.0.
-- `C:\SRI_SERVICES\acbr-node-generator-win32-final\generate.log`: geração FCL-passrc executada nativamente no Windows.
-- `.acbr/finish-consumer.log`: geração pela fábrica do consumidor r48589.
-- `.acbr/final-release-staging-audit.log`: inventário final de distribuição Linux/Windows.
-- `.acbr/cli-check-linux-offline.json` e `.acbr/cli-check-windows-offline.json`: hashes do runtime e quatro probes reais do CLI por plataforma.
-
-As cinco pastas temporárias de consumidores Linux foram removidas após preservar seus relatórios, scripts, locks, modelos gerados e logs em `.acbr/validation-evidence/consumers/`. O arquivo `archive-manifest.json` registra os caminhos originais e os hashes SHA-256 dos arquivos preservados. Os caminhos dentro dos relatórios correspondem ao local da execução original. As fixtures de certificados sintéticos podem ser recriadas por `tests/package-install.mjs`.
-
-Os binários portáteis Node 22.12.0 de teste foram obtidos de `nodejs.org/dist/v22.12.0` e conferidos contra `SHASUMS256.txt`, sem alterar o Node padrão da máquina.
-
-## Homologação fiscal separada
-
-Nenhum teste deste projeto transmite documentos à SEFAZ. Certificados, CNPJs, documentos e CAs usados nos testes são sintéticos. Homologação oficial com certificado habilitado, cenários fiscais reais por UF e verificação operacional permanecem pendentes e não fazem parte da evidência dos testes locais.
-
-A verificação de TLS não inclui consulta de revogação CRL/OCSP nesta versão. DANFE, impressão e A3 ficam fora do escopo atual.
+# Validação da implementação
+
+Validações registradas em 08/10/2026 para a versão **0.1.0**. A publicação npm e sua automação pela branch `release` foram autorizadas pelo usuário em **09/10/2026**. Os artefatos estão preparados; a publicação ainda não foi executada neste registro.
+
+Em 09/10/2026, os nomes npm foram definidos sem escopo, seguindo os pacotes existentes `cosmemilton-ui` e `cosmemilton-report`: `cosmemilton-acbr-node`, `cosmemilton-acbr-node-linux-x64` e `cosmemilton-acbr-node-win32-x64`. Duas gerações consecutivas produziram os mesmos arquivos; somente o import do cliente gerado mudou. O contrato, os 204 modelos, o mapper Pascal, o lock e todos os arquivos dos runtimes Linux/Windows permanecem idênticos. Os manifests dos runtimes atualizam somente `generatedFileHashes` para vincular o import novo. Typecheck, bundles JavaScript e 27 testes focados do gerador, supervisor e auditoria passaram com os nomes finais. Nenhum motor foi recompilado.
+
+As validações anteriores de instalação ESM/CommonJS descritas abaixo usaram o namespace `@cosmemilton`. A aceitação dos nomes finais foi concluída em 09/10/2026 com os tarballs auditados, instalados fora do repositório: Linux com Node 22.12.0/24.15.0 e Windows nativo com Node 22.12.0/24.18.0, em ESM e CommonJS. Cada execução processou quatro documentos sintéticos (dois emitentes × modelos 55/65), com geração, assinatura e validação: 96 operações reais ao todo. O runtime foi resolvido pelo pacote instalado, sem compilador no PATH. Relatórios e hashes constam em `release/0.1.0/VALIDATION.json`; evidências locais em `.acbr/unscoped-consumer-evidence/`.
+
+A verificação completa com os nomes finais aprovou o typecheck e 38 testes, com quatro suítes nativas opt-in ignoradas; os motores mantêm a evidência anterior de 52 testes Linux e 52 Windows e os mesmos hashes. Auditoria e dry run dos três tarballs aprovados. Os exemplos públicos da documentação também foram conferidos: JavaScript gerou XML sintético usando o pacote instalado e TypeScript passou em modo estrito NodeNext. Nenhuma transmissão à SEFAZ foi realizada.
+
+O snapshot principal usa ACBr SVN **48590** e **204 tipos gerados**. O contrato é:
+
+```text
+e5a497cefe8e0e350a30da5cc04e88b35c38a98535893d52f878890260d1346d
+```
+
+Revisão e inventário dos fontes constam em `acbr.lock.json`. O manifesto `.acbr/generated/manifest.json` vincula fonte, contrato e SHA-256 dos modelos TypeScript, fábrica do cliente e mapper Pascal. O build verifica esses três arquivos antes e depois da compilação. Cada runtime inventaria e verifica os seus arquivos; revisão ou contrato divergentes são recusados.
+
+## Resultado das verificações
+
+| Verificação | Estado e evidência |
+| --- | --- |
+| Gerador FCL-passrc | **6 testes aprovados**: AST real, 204 tipos e RTC, herança/aliases, precedência das unidades, enums simbólicos, coleções `New/Items`, tipos desconhecidos, mudanças de contrato, determinismo e equivalência dos modelos extraídos com condicionais Linux/Windows. |
+| Geração nativa Windows | CLI `generate` executado no Windows com Free Pascal 3.2.2/FCL-passrc: extrator `extract-model.exe` PE, 204 tipos, r48590 e contrato idêntico ao Linux. Os SHA-256 dos três arquivos gerados também coincidiram entre as plataformas. |
+| Tipos e bundle Node | Typecheck e build final aprovados, bundles ESM/CommonJS e cliente gerado com resolução NodeNext conferidos. Entradas usam enums ACBr, strings decimais e datas civis; assinatura/protocolo/suplemento gerados pelo motor não são campos de entrada. |
+| Supervisor Node | **8 testes aprovados**: UTF-8, isolamento de emitentes, integridade/contrato, fila, cancelamento, crash, timeout, recuperação de resultado incerto e ausência de retry/segredos em erros aprovados. |
+| CLI/configuração/fontes | **11 testes aprovados** no registro `.acbr/cli-tests.log`: opções/revisões, init e colisões, caminhos relativos, origem SVN, snapshots, fontes alterados e concorrência. |
+| CLI check offline Linux/Windows | Quatro operações reais aprovadas em cada sistema após integridade: gerar XML55 sintético (mapper/chave/UTF-8), validar XML assinado com certificado público sintético, recusar XML malformado e recusar DTD/entidade externa. Sem credenciais A1 na configuração do smoke, sem acesso à rede ou transmissão. |
+| Motor Linux | **52 testes aprovados**: 27 do motor/TLS e 25 dos serviços SOAP locais. Incluem NF-e/NFC-e sintéticas, assinatura e schema, dados Unicode, datas/decimais/coleções, CSC/QRCode e casos de erro. |
+| Consumidor Linux com runtime instalado | **ESM e CommonJS aprovados com Node 24.15.0 e 22.12.0**. Para cada formato/versão: quatro documentos, dois emitentes sintéticos, modelos 55 e 65, 12 processos nas operações `gerarXml → assinar → validar`. Não foram chamados compiladores. |
+| Consumidor com revisão própria | Fluxo externo completo em **r48589**: init, atualização SVN, generate, build, check, doctor, TypeScript NodeNext e XML gerado pela fábrica própria. Contrato `369de708cd42003fc02a98397346d55b842ad3cb25a8422939bd7de0a00aad91`, distinto do snapshot principal. |
+| Dependências Windows | OpenSSL 3.5.9 e libxml2 2.15.4 recompilados de fontes oficiais com MinGW x64. SHA-256 dos fontes e imports/exports PE conferidos. DLLs não dependem de VC Redistributable nem de runtime GCC dinâmico externo. Licenças e `SOURCE.json` preservados. |
+| Motor Windows | Compilação e **rodada final de 52 testes aprovadas**: 20 do motor XML/A1/protocolo, sete TLS e 25 SOAP. Inclui NFC-e autorizada simulada (cStat 100), assinatura/QRCode/UTF-8 correlacionados e encerramento ao morrer o supervisor. |
+| Consumidor Windows com Node mínimo | **ESM e CommonJS aprovados com Node 22.12.0** em diretório externo. Cada formato executou quatro documentos (dois CNPJs × modelos 55/65) e 12 operações offline. O processo consumidor tinha apenas Node no `PATH`; o worker e as DLLs vieram do runtime instalado, sem execução de compiladores ou fontes do checkout. |
+| Distribuição e licenças | **7 testes de auditoria aprovados**, staging real Linux/Windows conferido e pack/dry-run dos três pacotes aprovados. Fontes, licenças e runtime inventariados. Tarballs de revisão em `.acbr/release-artifacts`: SDK cerca de 484 KiB, Linux 50 MiB e Windows 33 MiB. |
+| Docker / CI remota dos motores | **Não executados**. O Docker Desktop não tinha daemon disponível; os motores foram validados localmente em Linux/Windows. O workflow de publicação audita e publica esses tarballs, sem reconstruir os motores. |
+| Publicação npm | **Autorizada em 09/10/2026**, ainda não executada neste registro. A automação da branch `release` confere os tarballs contra hashes fixados em `release/0.1.0/manifest.json`. |
+
+A execução final de `npm test` teve **32 testes aprovados e quatro suítes opt-in ignoradas**: seis do gerador, 11 da CLI/configuração/fontes, oito do supervisor e sete de auditoria. Os testes nativos foram habilitados e executados separadamente: **52 Linux + 52 Windows**, sem falhas.
+
+As operações marcadas como XML, assinatura, schema e SOAP foram executadas contra o componente Pascal real e serviços locais sintéticos. Respostas simuladas não comprovam aceitação fiscal na SEFAZ.
+
+## Consumo sem compilação
+
+O teste `tests/package-install.mjs` instala somente os tarballs do SDK e do runtime em um diretório externo ao checkout, com npm offline e scripts de instalação desativados. O processo consumidor importa o pacote instalado em ESM/CommonJS; `criarEmissor` resolve o executável do pacote nativo sem `runtimeDirectory` ou caminho para o motor do repositório. Cada execução capturada corresponde ao worker instalado, com `PATH` restrito ao diretório do Node.
+
+No Linux, `LD_DEBUG=libs` confirmou OpenSSL, libxml2, ICU, zlib, liblzma, libgcc, libstdc++ e provider legacy dentro do runtime instalado. O sistema forneceu apenas glibc, loader, libm, libpthread e o módulo glibc `gconv/UTF-16.so`, confirmado como arquivo do pacote Ubuntu `libc6`. A evidência corresponde ao Ubuntu 24.04/glibc; não é um teste em container limpo nem uma validação de Alpine ou de qualquer distribuição Linux.
+
+Relatórios locais:
+
+- `.acbr/validation-evidence/consumers/acbr-node-runtime-consumer-linux-final/report-esm.json` e `report-cjs.json`: Node 24.15.0.
+- `.acbr/validation-evidence/consumers/acbr-node-runtime-consumer-linux-node22/report-esm.json` e `report-cjs.json`: Node 22.12.0.
+- `C:\SRI_SERVICES\acbr-node-runtime-consumer-win32-node22-final\report-esm.json` e `report-cjs.json`: Windows com Node 22.12.0.
+- `C:\SRI_SERVICES\acbr-node-generator-win32-final\generate.log`: geração FCL-passrc executada nativamente no Windows.
+- `.acbr/finish-consumer.log`: geração pela fábrica do consumidor r48589.
+- `.acbr/final-release-staging-audit.log`: inventário final de distribuição Linux/Windows.
+- `.acbr/cli-check-linux-offline.json` e `.acbr/cli-check-windows-offline.json`: hashes do runtime e quatro probes reais do CLI por plataforma.
+
+As cinco pastas temporárias de consumidores Linux foram removidas após preservar seus relatórios, scripts, locks, modelos gerados e logs em `.acbr/validation-evidence/consumers/`. O arquivo `archive-manifest.json` registra os caminhos originais e os hashes SHA-256 dos arquivos preservados. Os caminhos dentro dos relatórios correspondem ao local da execução original. As fixtures de certificados sintéticos podem ser recriadas por `tests/package-install.mjs`.
+
+Os binários portáteis Node 22.12.0 de teste foram obtidos de `nodejs.org/dist/v22.12.0` e conferidos contra `SHASUMS256.txt`, sem alterar o Node padrão da máquina.
+
+## Homologação fiscal separada
+
+Nenhum teste deste projeto transmite documentos à SEFAZ. Certificados, CNPJs, documentos e CAs usados nos testes são sintéticos. Homologação oficial com certificado habilitado, cenários fiscais reais por UF e verificação operacional permanecem pendentes e não fazem parte da evidência dos testes locais.
+
+A verificação de TLS não inclui consulta de revogação CRL/OCSP nesta versão. DANFE, impressão e A3 ficam fora do escopo atual.

package/docs/examples/recuperar-xml.mjs

@@ -0,0 +1,54 @@
+// Exemplo da aplicação, sem execução automática ao importar.
+// Nos testes: XML/A1 sintéticos e serviço SOAP local, sem SEFAZ real.
+// O chamador fornece caminhos privados, configuração, A1 e confirmação.
+// Não receba senha/PFX por argv ou env e não registre esses valores.
+// Apresente falhas ao usuário com diagnosticarErro, sem imprimir o erro bruto.
+// opcoes é opcional e aceita somente signal?: AbortSignal, de um AbortController.
+// abort() solicita cancelamento no SDK; a consulta pode já ter sido enviada.
+// Isso não cancela a autorização fiscal.
+import { readFile } from 'node:fs/promises';
+import { criarEmissor, diagnosticarResultado } from 'cosmemilton-acbr-node';
+
+export async function recuperarXmlDeArquivo({
+  arquivoAssinado,
+  configuracao,
+  certificado,
+  confirmarConsulta,
+  opcoes
+}) {
+  if (configuracao?.ambiente !== 2 || typeof confirmarConsulta !== 'function') {
+    throw new TypeError('Este exemplo exige homologação e confirmação da aplicação.');
+  }
+  const original = await readFile(arquivoAssinado);
+  const xmlAssinado = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(original);
+  if (!Buffer.from(xmlAssinado, 'utf8').equals(original)) {
+    throw new TypeError('O arquivo assinado precisa estar em UTF-8.');
+  }
+  if (await confirmarConsulta('Consultar uma vez para recuperar o XML autorizado, sem emitir ou transmitir a nota?') !== true) {
+    return { recuperado: false, confirmado: false };
+  }
+
+  const emissor = criarEmissor({ ...configuracao, ambiente: 2, certificado });
+  try {
+    // Única operação fiscal deste exemplo. É uma consulta externa com A1.
+    const resultado = await emissor.recuperarXml(xmlAssinado, opcoes);
+    const diagnostico = resultado.diagnostico ?? diagnosticarResultado(resultado, 'recuperarXml');
+    if (!(await readFile(arquivoAssinado)).equals(original)) {
+      throw new Error('O arquivo original mudou durante a operação; preserve os registros.');
+    }
+    if (resultado.sucesso !== true || resultado.estado !== 'XML_RECUPERADO'
+        || resultado.cStat !== 100 || resultado.envioIniciado === true
+        || typeof resultado.xmlBase64 !== 'string' || !resultado.xmlBase64) {
+      return { recuperado: false, diagnostico };
+    }
+    const bytes = Buffer.from(resultado.xmlBase64, 'base64');
+    if (bytes.toString('base64') !== resultado.xmlBase64) {
+      throw new Error('O motor não devolveu o XML recuperado em base64 íntegro.');
+    }
+    // Dados fiscais privados: não imprima o objeto ou os bytes em logs.
+    // O chamador pode salvar em um NOVO arquivo com writeFile(..., { flag: 'wx' }).
+    return { recuperado: true, bytes, diagnostico };
+  } finally {
+    await emissor.fechar();
+  }
+}

package/docs/licenses/common/Apache-2.0.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.