nfe-lib-node 1.4.0 → 1.6.0

package/README.md

@@ -82,13 +82,68 @@ async function emitirNota() {
 }
 ```
 
+### 3. Consultar Protocolo, Recibo, Cancelar, Carta de Correção, Inutilizar e Manifestar
+
+```typescript
+import { NFe, Certificado } from 'nfe-lib-node';
+import fs from 'fs';
+
+async function gerenciarNotas() {
+  const certificado = new Certificado(fs.readFileSync('./certificado.pfx'), 'SENHA_DO_CERTIFICADO');
+  const nfe = new NFe({ uf: 'DF', ambiente: 'homologacao', certificado });
+
+  const chave = '53260999999999999999550010000000011847291634';
+
+  // 1. Consulta de Protocolo por Chave de Acesso (NFeConsultaProtocolo4)
+  const consulta = await nfe.consultarProtocolo(chave);
+  console.log(`Situação: ${consulta.status} - ${consulta.motivo}`);
+
+  // 2. Consulta de Recibo de Lote de 15 dígitos (NFeRetAutorizacao4)
+  const recibo = await nfe.consultarRecibo('531000000000001');
+  console.log(`Recibo: ${recibo.status} - ${recibo.motivo}`);
+
+  // 3. Carta de Correção Eletrônica - CC-e (tpEvento 110110)
+  const cce = await nfe.cartaCorrecao({
+    chave,
+    correcao: 'Correcao na descricao complementar da mercadoria transportada.',
+    nSeqEvento: 1,
+  });
+  console.log(`CC-e: ${cce.status} - ${cce.motivo}`);
+
+  // 4. Cancelamento de NF-e (tpEvento 110111)
+  const cancelamento = await nfe.cancelar({
+    chave,
+    protocolo: '153260000000001',
+    justificativa: 'Erro no preenchimento dos dados comerciais da nota fiscal.',
+  });
+  console.log(`Cancelamento: ${cancelamento.status} - ${cancelamento.motivo}`);
+
+  // 5. Inutilização de Faixa de Numeração (NFeInutilizacao4)
+  const inutilizacao = await nfe.inutilizar({
+    cnpj: '00000000000000',
+    serie: 1,
+    numeroInicial: 10,
+    numeroFinal: 12,
+    justificativa: 'Quebra de sequencia na numeracao do sistema emissor.',
+  });
+  console.log(`Inutilização: ${inutilizacao.status} - ${inutilizacao.motivo}`);
+
+  // 6. Manifestação do Destinatário no Ambiente Nacional (210210, 210200, 210220, 210240)
+  const ciencia = await nfe.manifestar({
+    chave,
+    tipo: 'ciencia', // 'ciencia' | 'confirmacao' | 'desconhecimento' | 'nao_realizada'
+  });
+  console.log(`Manifestação: ${ciencia.status} - ${ciencia.motivo}`);
+}
+```
+
 ## ✨ Funcionalidades Atuais
 
 * 🔐 **Certificado Digital A1 (`.pfx`)**: Extração com cache em memória, inspeção de validade/titular (`getDados()`, `estaValido()`) e configuração de mTLS.
-* 🔑 **Chave de Acesso (Módulo 11)**: Geração, validação, extração de dados da chave de 44 dígitos e cálculo automático do `cDV` (`gerarChaveAcesso`, `validarChaveAcesso`, `extrairDadosChaveAcesso`, `calcularDigitoVerificador`).
-* ✍️ **Assinatura Digital XMLDSig**: Assinatura no padrão exigido pela SEFAZ (`rsa-sha1` / `enveloped-signature` / `c14n`).
-* 🗺️ **Mapeamento Completo de WebServices por UF**: Resolução automática das URLs oficiais da NF-e 4.00 para todas as 27 UFs (Autorizadores próprios: AM, BA, GO, MG, MS, MT, PE, PR, RS, SP + SVAN, SVRS e contingência SVC-AN / SVC-RS).
-* 📡 **Comunicação SEFAZ (SOAP 1.2)**: Consulta de status do serviço (`consultarStatus`) e autorização síncrona de NF-e (`emitir`) com geração automática do `<nfeProc>`.
+* 🔑 **Chave de Acesso (Módulo 11)**: Geração, validação, extração de dados da chave de 44 dígitos e cálculo automático do `cDV` (`gerarChaveAcesso`, `validarChaveAcesso`, `getDadosChaveAcesso`, `getDigitoVerificador`).
+* ✍️ **Assinatura Digital XMLDSig**: Assinatura no padrão exigido pela SEFAZ (`rsa-sha1` / `enveloped-signature` / `c14n`) para NF-e, Eventos e Inutilização (`assinarXmlNFe`, `assinarXmlEvento`, `assinarXmlInutilizacao`).
+* 🗺️ **Mapeamento Completo de WebServices por UF e Ambiente Nacional**: Resolução automática das URLs oficiais da NF-e 4.00 para todas as 27 UFs e Ambiente Nacional (`getUrlSefaz`, `getUrlAmbienteNacional`, `getAutorizadorPorUF`, `getCodigoUF` — Autorizadores próprios: AM, BA, GO, MG, MS, MT, PE, PR, RS, SP + SVAN, SVRS, AN e contingência SVC-AN / SVC-RS).
+* 📡 **Comunicação SEFAZ Completa (SOAP 1.2)**: Consulta de status (`consultarStatus`), autorização síncrona (`emitir`), consulta de protocolo por chave (`consultarProtocolo`), consulta de recibo (`consultarRecibo`), cancelamento (`cancelar`), carta de correção (`cartaCorrecao`), inutilização de numeração (`inutilizar`) e manifestação do destinatário (`manifestar`), com montagem automática de `<nfeProc>`, `<procEventoNFe>` e `<ProcInutNFe>`.
 * 📄 **Gerador de DANFE em PDF**: Geração nativa de PDF com código de barras `Code128C` via `Danfe.fromXml()`.
 * 📘 **Tipagem TypeScript Completa**: Interfaces completas da NF-e / NFC-e 4.00 (incluindo os novos grupos de IBS/CBS da Reforma Tributária).
 
@@ -99,7 +154,7 @@ async function emitirNota() {
 
 ## 🤝 Contribuições
 
-As próximas etapas envolvem suporte a eventos (Cancelamento, Carta de Correção), Consulta de Protocolo por chave e Inutilização. Toda contribuição da comunidade Node.js brasileira é bem-vinda!
+As próximas etapas envolvem suporte a Distribuição de DF-e (`NFeDistribuicaoDFe`) e geração de QR-Code para NFC-e (Modelo 65). Toda contribuição da comunidade Node.js brasileira é bem-vinda!
 
 ## 👨‍💻 Autor
 

package/dist/Assinador.d.ts

@@ -7,5 +7,13 @@ export declare class Assinador {
      * Assina o XML da Nota Fiscal Eletrônica no padrão SEFAZ (XMLDSig)
      */
     assinarXmlNFe(xmlCru: string): string;
+    /**
+     * Assina o XML de um Evento da NF-e (ex: Cancelamento ou Carta de Correção) no padrão SEFAZ (XMLDSig).
+     */
+    assinarXmlEvento(xmlCru: string): string;
+    /**
+     * Assina o XML de Inutilização de Numeração da NF-e (<inutNFe> / <infInut>) no padrão SEFAZ (XMLDSig).
+     */
+    assinarXmlInutilizacao(xmlCru: string): string;
 }
 //# sourceMappingURL=Assinador.d.ts.map

package/dist/Assinador.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Assinador.d.ts","sourceRoot":"","sources":["../src/Assinador.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAE9B,YAAY,gBAAgB,EAAE,WAAW,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAQhF;IAED;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqC3C;CACF"}
+{"version":3,"file":"Assinador.d.ts","sourceRoot":"","sources":["../src/Assinador.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAE9B,YAAY,gBAAgB,EAAE,WAAW,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAQhF;IAED;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqC3C;IAED;;OAEG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkC9C;IAED;;OAEG;IACI,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkCpD;CACF"}

package/dist/Assinador.js

@@ -47,5 +47,71 @@ export class Assinador {
         });
         return sig.getSignedXml();
     }
+    /**
+     * Assina o XML de um Evento da NF-e (ex: Cancelamento ou Carta de Correção) no padrão SEFAZ (XMLDSig).
+     */
+    assinarXmlEvento(xmlCru) {
+        const doc = new DOMParser().parseFromString(xmlCru, 'text/xml');
+        const infEvento = doc.getElementsByTagName('infEvento')[0];
+        if (!infEvento) {
+            throw new Error('Tag <infEvento> não encontrada no XML. O XML fornecido não é um evento válido.');
+        }
+        const id = infEvento.getAttribute('Id');
+        if (!id) {
+            throw new Error('A tag <infEvento> precisa ter o atributo Id (ex: Id="ID110111...")');
+        }
+        const sig = new SignedXml();
+        sig.addReference({
+            xpath: `//*[@Id='${id}']`,
+            transforms: [
+                'http://www.w3.org/2000/09/xmldsig#enveloped-signature',
+                'http://www.w3.org/TR/2001/REC-xml-c14n-20010315',
+            ],
+            digestAlgorithm: 'http://www.w3.org/2000/09/xmldsig#sha1',
+            uri: `#${id}`,
+        });
+        sig.privateKey = this.privateKeyPem;
+        sig.signatureAlgorithm = 'http://www.w3.org/2000/09/xmldsig#rsa-sha1';
+        sig.canonicalizationAlgorithm = 'http://www.w3.org/TR/2001/REC-xml-c14n-20010315';
+        sig.publicCert = Buffer.from(this.publicCertPem);
+        sig.computeSignature(xmlCru, {
+            prefix: '',
+            location: { reference: `//*[local-name(.)='evento']`, action: 'append' },
+        });
+        return sig.getSignedXml();
+    }
+    /**
+     * Assina o XML de Inutilização de Numeração da NF-e (<inutNFe> / <infInut>) no padrão SEFAZ (XMLDSig).
+     */
+    assinarXmlInutilizacao(xmlCru) {
+        const doc = new DOMParser().parseFromString(xmlCru, 'text/xml');
+        const infInut = doc.getElementsByTagName('infInut')[0];
+        if (!infInut) {
+            throw new Error('Tag <infInut> não encontrada no XML. O XML fornecido não é uma inutilização válida.');
+        }
+        const id = infInut.getAttribute('Id');
+        if (!id) {
+            throw new Error('A tag <infInut> precisa ter o atributo Id (ex: Id="ID5326...")');
+        }
+        const sig = new SignedXml();
+        sig.addReference({
+            xpath: `//*[@Id='${id}']`,
+            transforms: [
+                'http://www.w3.org/2000/09/xmldsig#enveloped-signature',
+                'http://www.w3.org/TR/2001/REC-xml-c14n-20010315',
+            ],
+            digestAlgorithm: 'http://www.w3.org/2000/09/xmldsig#sha1',
+            uri: `#${id}`,
+        });
+        sig.privateKey = this.privateKeyPem;
+        sig.signatureAlgorithm = 'http://www.w3.org/2000/09/xmldsig#rsa-sha1';
+        sig.canonicalizationAlgorithm = 'http://www.w3.org/TR/2001/REC-xml-c14n-20010315';
+        sig.publicCert = Buffer.from(this.publicCertPem);
+        sig.computeSignature(xmlCru, {
+            prefix: '',
+            location: { reference: `//*[local-name(.)='inutNFe']`, action: 'append' },
+        });
+        return sig.getSignedXml();
+    }
 }
 //# sourceMappingURL=Assinador.js.map

package/dist/Assinador.js.map

@@ -1 +1 @@
-{"version":3,"file":"Assinador.js","sourceRoot":"","sources":["../src/Assinador.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,OAAO,SAAS;IACZ,aAAa,CAAS;IACtB,aAAa,CAAS;IAE9B,YAAY,gBAAsC,EAAE,QAA6B;QAC/E,MAAM,IAAI,GACR,gBAAgB,YAAY,WAAW;YACrC,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,IAAI,WAAW,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC;QAChC,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,MAAc;QACjC,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,GAAG,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,sDAAsD;QACtD,GAAG,CAAC,YAAY,CAAC;YACf,KAAK,EAAE,YAAY,EAAE,IAAI;YACzB,UAAU,EAAE;gBACV,uDAAuD;gBACvD,iDAAiD;aAClD;YACD,eAAe,EAAE,wCAAwC;YACzD,GAAG,EAAE,IAAI,EAAE,EAAE;SACd,CAAC,CAAC;QAEH,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC;QACpC,GAAG,CAAC,kBAAkB,GAAG,4CAA4C,CAAC;QACtE,GAAG,CAAC,yBAAyB,GAAG,iDAAiD,CAAC;QAElF,8CAA8C;QAC9C,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEjD,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE;YAC3B,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE,SAAS,EAAE,0BAA0B,EAAE,MAAM,EAAE,QAAQ,EAAE;SACtE,CAAC,CAAC;QAEH,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"Assinador.js","sourceRoot":"","sources":["../src/Assinador.ts"],"names":[],"mappings":"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"}

package/dist/NFe.d.ts

@@ -8,6 +8,63 @@ export interface ConfiguracaoNFe {
     certificado: Certificado;
     contingencia?: boolean | undefined;
 }
+export interface ParametrosCancelamentoNFe {
+    /** Chave de acesso de 44 dígitos da NF-e (com ou sem o prefixo 'NFe') */
+    chave: string;
+    /** Número do protocolo de autorização da NF-e (15 dígitos) */
+    protocolo: string;
+    /** Justificativa do cancelamento (mínimo de 15 caracteres) */
+    justificativa: string;
+    /** CNPJ ou CPF do autor do evento (opcional; padrão: CNPJ extraído da chave de acesso) */
+    cnpjOuCpf?: string | undefined;
+    /** Data e hora do evento (opcional; padrão: data/hora atual no formato ISO com timezone) */
+    dhEvento?: string | Date | undefined;
+    /** Número sequencial do evento (opcional; padrão: 1) */
+    nSeqEvento?: number | string | undefined;
+}
+export interface ParametrosCartaCorrecaoNFe {
+    /** Chave de acesso de 44 dígitos da NF-e (com ou sem o prefixo 'NFe') */
+    chave: string;
+    /** Texto da correção a ser registrada (mínimo de 15 caracteres) */
+    correcao: string;
+    /** Número sequencial do evento de Carta de Correção (1 a 20; padrão: 1) */
+    nSeqEvento?: number | string | undefined;
+    /** CNPJ ou CPF do autor do evento (opcional; padrão: CNPJ extraído da chave de acesso) */
+    cnpjOuCpf?: string | undefined;
+    /** Data e hora do evento (opcional; padrão: data/hora atual no formato ISO com timezone) */
+    dhEvento?: string | Date | undefined;
+}
+export interface ParametrosInutilizacaoNFe {
+    /** CNPJ do emitente (14 dígitos) */
+    cnpj: string;
+    /** Série da numeração a ser inutilizada (0 a 999) */
+    serie: number | string;
+    /** Número inicial da faixa de NF-e a ser inutilizada */
+    numeroInicial: number | string;
+    /** Número final da faixa de NF-e a ser inutilizada (opcional; padrão igual a numeroInicial) */
+    numeroFinal?: number | string | undefined;
+    /** Justificativa do pedido de inutilização (mínimo de 15 caracteres) */
+    justificativa: string;
+    /** Ano de inutilização com 2 ou 4 dígitos (opcional; padrão: ano atual) */
+    ano?: number | string | undefined;
+    /** Modelo do documento fiscal ('55' para NF-e, '65' para NFC-e; padrão: '55') */
+    modelo?: '55' | '65' | number | string | undefined;
+}
+export type TipoManifestacao = 'confirmacao' | 'ciencia' | 'desconhecimento' | 'nao_realizada' | '210200' | '210210' | '210220' | '210240';
+export interface ParametrosManifestacaoNFe {
+    /** Chave de acesso de 44 dígitos da NF-e (com ou sem o prefixo 'NFe') */
+    chave: string;
+    /** Tipo de manifestação ('ciencia' | 'confirmacao' | 'desconhecimento' | 'nao_realizada' ou '210200' | '210210' | '210220' | '210240') */
+    tipo: TipoManifestacao;
+    /** Justificativa da manifestação (obrigatória apenas para 'nao_realizada' / '210240', entre 15 e 255 caracteres) */
+    justificativa?: string | undefined;
+    /** CNPJ ou CPF do destinatário autor do evento (opcional; padrão: extraído do Certificado A1) */
+    cnpjOuCpf?: string | undefined;
+    /** Data e hora do evento (opcional; padrão: data/hora atual no formato ISO com timezone) */
+    dhEvento?: string | Date | undefined;
+    /** Número sequencial do evento (opcional; padrão: 1) */
+    nSeqEvento?: number | string | undefined;
+}
 export declare class NFe {
     private config;
     private assinador;
@@ -15,11 +72,41 @@ export declare class NFe {
     getAutorizador(): AutorizadorSefaz;
     getUrl(servico: ServicoSefaz): string;
     getCodigoUF(): string;
+    /**
+     * Consulta o status de operação do serviço da SEFAZ para a UF configurada.
+     */
     consultarStatus(): Promise<RetornoSefaz>;
+    /**
+     * Consulta a situação atual e o protocolo de uma NF-e na SEFAZ pela chave de acesso de 44 dígitos.
+     */
+    consultarProtocolo(chaveOuId: string): Promise<RetornoSefaz>;
     /**
      * Recebe os dados da NFe em formato JS/JSON, converte para XML, assina e envia.
      */
     emitir(dadosNFe: DadosNFe): Promise<RetornoSefaz>;
+    /**
+     * Envia o evento de Cancelamento (tpEvento 110111) de uma NF-e autorizada para a SEFAZ.
+     */
+    cancelar(params: ParametrosCancelamentoNFe): Promise<RetornoSefaz>;
+    /**
+     * Envia o evento de Carta de Correção Eletrônica - CC-e (tpEvento 110110) para a SEFAZ.
+     */
+    cartaCorrecao(params: ParametrosCartaCorrecaoNFe): Promise<RetornoSefaz>;
+    /**
+     * Solicita a inutilização de uma faixa de numeração de NF-e/NFC-e na SEFAZ (NFeInutilizacao4).
+     */
+    inutilizar(params: ParametrosInutilizacaoNFe): Promise<RetornoSefaz>;
+    /**
+     * Consulta o resultado do processamento de um lote de NF-e pelo número do recibo de 15 dígitos (NFeRetAutorizacao4).
+     */
+    consultarRecibo(recibo: string): Promise<RetornoSefaz>;
+    /**
+     * Registra um evento de Manifestação do Destinatário no Ambiente Nacional (AN - cOrgao 91).
+     * Suporta Ciência da Operação (210210), Confirmação da Operação (210200),
+     * Desconhecimento da Operação (210220) e Operação não Realizada (210240).
+     */
+    manifestar(params: ParametrosManifestacaoNFe): Promise<RetornoSefaz>;
+    private enviarEvento;
     private enviarSoap;
 }
 //# sourceMappingURL=NFe.d.ts.map

package/dist/NFe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NFe.d.ts","sourceRoot":"","sources":["../src/NFe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,OAAO,EACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAED,qBAAa,GAAG;IACd,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAY;IAE7B,YAAY,MAAM,EAAE,eAAe,EAGlC;IAEM,cAAc,IAAI,gBAAgB,CAExC;IAEM,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAO3C;IAEM,WAAW,IAAI,MAAM,CAE3B;IAEY,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAOpD;IAED;;OAEG;IACU,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CA8B7D;YAEa,UAAU;CAmCzB"}
+{"version":3,"file":"NFe.d.ts","sourceRoot":"","sources":["../src/NFe.ts"],"names":[],"mappings":"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"}