@nestjs-fiscal/core

O pacote core contém as interfaces, entidades de domínio e os casos de uso base para emissão e assinatura de documentos fiscais. Ele define os contratos que as outras camadas do sistema deverão seguir.

Instalação

npm install @nestjs-fiscal/core

O que este pacote contém?

• Entidades de Domínio: Modelos base, como Certificate, que representam o conceito de um certificado digital.
• Interfaces: Interfaces para injeção de dependência (CertificateSignerRepository, CertificateRepository).
• DTOs: Objetos de transferência de dados padronizados (ex: CreateNFeDTO).
• Casos de Uso Base: Lógica agnóstica de frameworks para GenerateNFeUseCase e SignXmlUseCase.
• Utilitários: Funções auxiliares, como geradores de chave de acesso (NFeAccessKeyUtil).

Exemplo de Uso (Interfaces e Casos de Uso)

Geralmente, você utilizará as classes e interfaces deste pacote para construir outras funcionalidades ou ao configurar seu módulo principal.

import { SignXmlUseCase, CertificateSignerRepository, CertificateRepository } from '@nestjs-fiscal/core';

// Injeção manual ou no módulo
const signUseCase = new SignXmlUseCase(
  certificateRepo, // Implementação de CertificateRepository
  signer           // Implementação de CertificateSignerRepository
);

const signedXml = await signUseCase.execute({
  certificateId: 'id-do-certificado-no-banco',
  xml: '<nfe>...</nfe>',
  certificateFile: bufferDoPfx,
  password: 'senha do cerificado',
  referenceTag: 'infNFe',
  referenceAttribute: 'idNFe'
});

A arquitetura do projeto garante que o core seja isolado e testável sem depender de bibliotecas externas de I/O.