feat: add SDK support for PDF document signing and visual seal customization tools

This commit is contained in:
Claudecio Martins
2026-10-11 18:34:47 -03:00
parent d8d2e6ee46
commit b46d8b665f
12 changed files with 3497 additions and 121 deletions
+127
View File
@@ -250,4 +250,131 @@ describe('@cybercore/signer-sdk - Testes Unitários do SDK', () => {
assert.equal(res.subjectCpfCnpj, '98765432100');
assert.equal(capturedPayload.purpose, 'AUTHENTICATION');
});
it('deve consultar lista de temas de selos com getSealThemes()', async () => {
const signer = new CyberCoreSigner();
signer._fetch = async (endpoint, options) => {
assert.equal(endpoint, '/ccsp/v1/seals');
return {
version: '1',
status: 'success',
default_seal_id: 'icp-brasil',
seals: [
{ id: 'icp-brasil', name: 'ICP-Brasil Oficial' },
{ id: 'gov-br', name: 'Gov.br Oficial' }
]
};
};
const res = await signer.getSealThemes();
assert.equal(res.status, 'success');
assert.equal(res.default_seal_id, 'icp-brasil');
assert.equal(res.seals.length, 2);
});
it('deve assinar documento PDF completo em Base64 com signPdfDocument()', async () => {
const signer = new CyberCoreSigner();
let capturedPayload = null;
let calledEndpoint = null;
const fakeSignedPdfB64 = Buffer.from('%PDF-1.4 Fake Signed PDF Content').toString('base64');
signer._fetch = async (endpoint, options) => {
calledEndpoint = endpoint;
capturedPayload = JSON.parse(options.body);
return {
version: '1',
request_id: capturedPayload.request_id,
status: 'signed',
signed_pdf: fakeSignedPdfB64,
sha256: 'FAKESHA256HASH12345',
certificate: 'FAKECERTBASE64',
certificate_chain: ['FAKECERTBASE64'],
algorithm: 'SHA256withRSA',
subject_name: 'MARIA DA SILVA',
subject_cpf_cnpj: '12345678900',
document_name: capturedPayload.document_name
};
};
const rawPdfBuffer = Buffer.from('%PDF-1.4 Document Original');
const res = await signer.signPdfDocument({
pdf: rawPdfBuffer,
certificateId: 'cert-a3-win',
documentName: 'contrato.pdf',
page: 2,
x: 350.5,
y: 50.0,
scale: 1.1,
sealThemeId: 'gov-br',
customExtraInfo: 'Matrícula: 1048'
});
assert.equal(calledEndpoint, '/ccsp/v1/sign-pdf');
assert.equal(res.status, 'signed');
assert.equal(res.signedPdf, fakeSignedPdfB64);
assert.equal(res.sha256, 'FAKESHA256HASH12345');
assert.equal(res.subjectName, 'MARIA DA SILVA');
assert.equal(res.subjectCpfCnpj, '12345678900');
assert.equal(capturedPayload.page, 2);
assert.equal(capturedPayload.x, 350.5);
assert.equal(capturedPayload.y, 50.0);
assert.equal(capturedPayload.scale, 1.1);
assert.equal(capturedPayload.seal_theme_id, 'gov-br');
assert.equal(capturedPayload.custom_extra_info, 'Matrícula: 1048');
// Valida método helper de bytes
const signedBytes = res.getSignedPdfBytes();
assert.ok(signedBytes instanceof Uint8Array);
assert.ok(signedBytes.length > 0);
});
it('deve assinar documento XML completo com signXmlDocument()', async () => {
const signer = new CyberCoreSigner();
let capturedPayload = null;
let calledEndpoint = null;
const fakeSignedXml = '<nfeProc><NFe>...</NFe><ds:Signature>...</ds:Signature></nfeProc>';
signer._fetch = async (endpoint, options) => {
calledEndpoint = endpoint;
capturedPayload = JSON.parse(options.body);
return {
version: '1',
request_id: capturedPayload.request_id,
status: 'signed',
signed_xml: fakeSignedXml,
sha256: 'XMLSHA256HASH',
certificate: 'FAKECERTBASE64',
certificate_chain: ['FAKECERTBASE64'],
algorithm: 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha256',
subject_name: 'CYBERCORE LTDA',
subject_cpf_cnpj: '12345678000199',
document_name: capturedPayload.document_name
};
};
const xmlInput = '<nfeProc><NFe Id="NFe123">Dados</NFe></nfeProc>';
const res = await signer.signXmlDocument({
xml: xmlInput,
certificateId: 'cert-a1-pj',
documentName: 'nfe-123.xml',
profile: 'XADES_BES',
targetElementTag: 'NFe',
targetElementId: 'NFe123'
});
assert.equal(calledEndpoint, '/ccsp/v1/sign-xml');
assert.equal(res.status, 'signed');
assert.equal(res.signedXml, fakeSignedXml);
assert.equal(res.subjectName, 'CYBERCORE LTDA');
assert.equal(capturedPayload.profile, 'XADES_BES');
assert.equal(capturedPayload.target_element_tag, 'NFe');
assert.equal(capturedPayload.target_element_id, 'NFe123');
// Helper de bytes
const xmlBytes = res.getSignedXmlBytes();
assert.ok(xmlBytes instanceof Uint8Array);
});
});