@veridid/signing 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +202 -0
- package/README.md +39 -2
- package/build/SigningApi.d.mts +368 -0
- package/build/SigningApi.d.mts.map +1 -0
- package/build/SigningApi.mjs +516 -0
- package/build/SigningApi.mjs.map +1 -0
- package/build/SigningEvents.d.mts +71 -0
- package/build/SigningEvents.d.mts.map +1 -0
- package/build/SigningEvents.mjs +16 -0
- package/build/SigningEvents.mjs.map +1 -0
- package/build/SigningModule.d.mts +42 -0
- package/build/SigningModule.d.mts.map +1 -0
- package/build/SigningModule.mjs +91 -0
- package/build/SigningModule.mjs.map +1 -0
- package/build/SigningRole.d.mts +25 -0
- package/build/SigningRole.d.mts.map +1 -0
- package/build/SigningRole.mjs +27 -0
- package/build/SigningRole.mjs.map +1 -0
- package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorate.mjs +10 -0
- package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateMetadata.mjs +7 -0
- package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateParam.mjs +9 -0
- package/build/compat.d.mts +24 -0
- package/build/compat.d.mts.map +1 -0
- package/build/compat.mjs +26 -0
- package/build/compat.mjs.map +1 -0
- package/build/delivery/ArtifactDeliveryStrategy.d.mts +74 -0
- package/build/delivery/ArtifactDeliveryStrategy.d.mts.map +1 -0
- package/build/delivery/InlineBase64Strategy.d.mts +50 -0
- package/build/delivery/InlineBase64Strategy.d.mts.map +1 -0
- package/build/delivery/InlineBase64Strategy.mjs +80 -0
- package/build/delivery/InlineBase64Strategy.mjs.map +1 -0
- package/build/delivery/index.mjs +1 -0
- package/build/errors/ArtifactTooLargeError.d.mts +12 -0
- package/build/errors/ArtifactTooLargeError.d.mts.map +1 -0
- package/build/errors/ArtifactTooLargeError.mjs +15 -0
- package/build/errors/ArtifactTooLargeError.mjs.map +1 -0
- package/build/errors/DigestMismatchError.d.mts +12 -0
- package/build/errors/DigestMismatchError.d.mts.map +1 -0
- package/build/errors/DigestMismatchError.mjs +15 -0
- package/build/errors/DigestMismatchError.mjs.map +1 -0
- package/build/errors/IdempotencyConflictError.d.mts +12 -0
- package/build/errors/IdempotencyConflictError.d.mts.map +1 -0
- package/build/errors/IdempotencyConflictError.mjs +15 -0
- package/build/errors/IdempotencyConflictError.mjs.map +1 -0
- package/build/errors/InvalidStateError.d.mts +14 -0
- package/build/errors/InvalidStateError.d.mts.map +1 -0
- package/build/errors/InvalidStateError.mjs +16 -0
- package/build/errors/InvalidStateError.mjs.map +1 -0
- package/build/errors/PolicyEnforcementError.d.mts +12 -0
- package/build/errors/PolicyEnforcementError.d.mts.map +1 -0
- package/build/errors/PolicyEnforcementError.mjs +15 -0
- package/build/errors/PolicyEnforcementError.mjs.map +1 -0
- package/build/errors/SigningError.d.mts +16 -0
- package/build/errors/SigningError.d.mts.map +1 -0
- package/build/errors/SigningError.mjs +16 -0
- package/build/errors/SigningError.mjs.map +1 -0
- package/build/errors/ThresholdNotMetError.d.mts +12 -0
- package/build/errors/ThresholdNotMetError.d.mts.map +1 -0
- package/build/errors/ThresholdNotMetError.mjs +15 -0
- package/build/errors/ThresholdNotMetError.mjs.map +1 -0
- package/build/errors/UnsupportedCanonicalizerError.d.mts +12 -0
- package/build/errors/UnsupportedCanonicalizerError.d.mts.map +1 -0
- package/build/errors/UnsupportedCanonicalizerError.mjs +16 -0
- package/build/errors/UnsupportedCanonicalizerError.mjs.map +1 -0
- package/build/errors/UnsupportedSuiteError.d.mts +12 -0
- package/build/errors/UnsupportedSuiteError.d.mts.map +1 -0
- package/build/errors/UnsupportedSuiteError.mjs +16 -0
- package/build/errors/UnsupportedSuiteError.mjs.map +1 -0
- package/build/errors/index.d.mts +9 -0
- package/build/errors/index.mjs +9 -0
- package/build/handlers/CombineMessageHandler.d.mts +22 -0
- package/build/handlers/CombineMessageHandler.d.mts.map +1 -0
- package/build/handlers/CombineMessageHandler.mjs +25 -0
- package/build/handlers/CombineMessageHandler.mjs.map +1 -0
- package/build/handlers/ConsentMessageHandler.d.mts +19 -0
- package/build/handlers/ConsentMessageHandler.d.mts.map +1 -0
- package/build/handlers/ConsentMessageHandler.mjs +21 -0
- package/build/handlers/ConsentMessageHandler.mjs.map +1 -0
- package/build/handlers/DeclineMessageHandler.d.mts +19 -0
- package/build/handlers/DeclineMessageHandler.d.mts.map +1 -0
- package/build/handlers/DeclineMessageHandler.mjs +21 -0
- package/build/handlers/DeclineMessageHandler.mjs.map +1 -0
- package/build/handlers/PartialSignatureMessageHandler.d.mts +19 -0
- package/build/handlers/PartialSignatureMessageHandler.d.mts.map +1 -0
- package/build/handlers/PartialSignatureMessageHandler.mjs +21 -0
- package/build/handlers/PartialSignatureMessageHandler.mjs.map +1 -0
- package/build/handlers/ProposeSigningMessageHandler.d.mts +19 -0
- package/build/handlers/ProposeSigningMessageHandler.d.mts.map +1 -0
- package/build/handlers/ProposeSigningMessageHandler.mjs +21 -0
- package/build/handlers/ProposeSigningMessageHandler.mjs.map +1 -0
- package/build/handlers/ProvideArtifactsMessageHandler.d.mts +19 -0
- package/build/handlers/ProvideArtifactsMessageHandler.d.mts.map +1 -0
- package/build/handlers/ProvideArtifactsMessageHandler.mjs +21 -0
- package/build/handlers/ProvideArtifactsMessageHandler.mjs.map +1 -0
- package/build/handlers/RequestSigningMessageHandler.d.mts +19 -0
- package/build/handlers/RequestSigningMessageHandler.d.mts.map +1 -0
- package/build/handlers/RequestSigningMessageHandler.mjs +21 -0
- package/build/handlers/RequestSigningMessageHandler.mjs.map +1 -0
- package/build/handlers/SigningAckMessageHandler.d.mts +22 -0
- package/build/handlers/SigningAckMessageHandler.d.mts.map +1 -0
- package/build/handlers/SigningAckMessageHandler.mjs +25 -0
- package/build/handlers/SigningAckMessageHandler.mjs.map +1 -0
- package/build/handlers/SigningProblemReportMessageHandler.d.mts +19 -0
- package/build/handlers/SigningProblemReportMessageHandler.d.mts.map +1 -0
- package/build/handlers/SigningProblemReportMessageHandler.mjs +21 -0
- package/build/handlers/SigningProblemReportMessageHandler.mjs.map +1 -0
- package/build/handlers/index.d.mts +9 -0
- package/build/handlers/index.mjs +9 -0
- package/build/index.d.mts +75 -0
- package/build/index.mjs +63 -0
- package/build/messages/CombineMessage.d.mts +32 -0
- package/build/messages/CombineMessage.d.mts.map +1 -0
- package/build/messages/CombineMessage.mjs +47 -0
- package/build/messages/CombineMessage.mjs.map +1 -0
- package/build/messages/ConsentMessage.d.mts +32 -0
- package/build/messages/ConsentMessage.d.mts.map +1 -0
- package/build/messages/ConsentMessage.mjs +46 -0
- package/build/messages/ConsentMessage.mjs.map +1 -0
- package/build/messages/DeclineMessage.d.mts +26 -0
- package/build/messages/DeclineMessage.d.mts.map +1 -0
- package/build/messages/DeclineMessage.mjs +47 -0
- package/build/messages/DeclineMessage.mjs.map +1 -0
- package/build/messages/PartialSignatureMessage.d.mts +36 -0
- package/build/messages/PartialSignatureMessage.d.mts.map +1 -0
- package/build/messages/PartialSignatureMessage.mjs +72 -0
- package/build/messages/PartialSignatureMessage.mjs.map +1 -0
- package/build/messages/ProposeSigningMessage.d.mts +27 -0
- package/build/messages/ProposeSigningMessage.d.mts.map +1 -0
- package/build/messages/ProposeSigningMessage.mjs +41 -0
- package/build/messages/ProposeSigningMessage.mjs.map +1 -0
- package/build/messages/ProvideArtifactsMessage.d.mts +62 -0
- package/build/messages/ProvideArtifactsMessage.d.mts.map +1 -0
- package/build/messages/ProvideArtifactsMessage.mjs +40 -0
- package/build/messages/ProvideArtifactsMessage.mjs.map +1 -0
- package/build/messages/RequestSigningMessage.d.mts +38 -0
- package/build/messages/RequestSigningMessage.d.mts.map +1 -0
- package/build/messages/RequestSigningMessage.mjs +62 -0
- package/build/messages/RequestSigningMessage.mjs.map +1 -0
- package/build/messages/SigningAckMessage.d.mts +26 -0
- package/build/messages/SigningAckMessage.d.mts.map +1 -0
- package/build/messages/SigningAckMessage.mjs +46 -0
- package/build/messages/SigningAckMessage.mjs.map +1 -0
- package/build/messages/SigningProblemReportMessage.d.mts +44 -0
- package/build/messages/SigningProblemReportMessage.d.mts.map +1 -0
- package/build/messages/SigningProblemReportMessage.mjs +65 -0
- package/build/messages/SigningProblemReportMessage.mjs.map +1 -0
- package/build/messages/index.d.mts +9 -0
- package/build/messages/index.mjs +9 -0
- package/build/models/AggregationResult.d.mts +85 -0
- package/build/models/AggregationResult.d.mts.map +1 -0
- package/build/models/ArtifactMetadata.d.mts +37 -0
- package/build/models/ArtifactMetadata.d.mts.map +1 -0
- package/build/models/AuthzArtifact.d.mts +178 -0
- package/build/models/AuthzArtifact.d.mts.map +1 -0
- package/build/models/Capabilities.d.mts +109 -0
- package/build/models/Capabilities.d.mts.map +1 -0
- package/build/models/JoinToken.d.mts +344 -0
- package/build/models/JoinToken.d.mts.map +1 -0
- package/build/models/JoinToken.mjs +14 -0
- package/build/models/JoinToken.mjs.map +1 -0
- package/build/models/PartialSignature.d.mts +82 -0
- package/build/models/PartialSignature.d.mts.map +1 -0
- package/build/models/PolicyContext.d.mts +55 -0
- package/build/models/PolicyContext.d.mts.map +1 -0
- package/build/models/RouterAttestation.d.mts +186 -0
- package/build/models/RouterAttestation.d.mts.map +1 -0
- package/build/models/Session.d.mts +62 -0
- package/build/models/Session.d.mts.map +1 -0
- package/build/models/Session.mjs +19 -0
- package/build/models/Session.mjs.map +1 -0
- package/build/models/SignableObject.d.mts +71 -0
- package/build/models/SignableObject.d.mts.map +1 -0
- package/build/models/SigningState.d.mts +21 -0
- package/build/models/SigningState.d.mts.map +1 -0
- package/build/models/SigningState.mjs +23 -0
- package/build/models/SigningState.mjs.map +1 -0
- package/build/models/Suite.d.mts +59 -0
- package/build/models/Suite.d.mts.map +1 -0
- package/build/models/index.d.mts +12 -0
- package/build/pdf/PdfUtils.d.mts +160 -0
- package/build/pdf/PdfUtils.d.mts.map +1 -0
- package/build/pdf/PdfUtils.mjs +283 -0
- package/build/pdf/PdfUtils.mjs.map +1 -0
- package/build/pdf/index.mjs +1 -0
- package/build/registry/aggregators/Aggregator.d.mts +85 -0
- package/build/registry/aggregators/Aggregator.d.mts.map +1 -0
- package/build/registry/aggregators/AggregatorRegistry.d.mts +55 -0
- package/build/registry/aggregators/AggregatorRegistry.d.mts.map +1 -0
- package/build/registry/aggregators/AggregatorRegistry.mjs +76 -0
- package/build/registry/aggregators/AggregatorRegistry.mjs.map +1 -0
- package/build/registry/aggregators/BundleNoneAggregator.d.mts +43 -0
- package/build/registry/aggregators/BundleNoneAggregator.d.mts.map +1 -0
- package/build/registry/aggregators/BundleNoneAggregator.mjs +65 -0
- package/build/registry/aggregators/BundleNoneAggregator.mjs.map +1 -0
- package/build/registry/aggregators/index.d.mts +3 -0
- package/build/registry/aggregators/index.mjs +2 -0
- package/build/registry/canonicalizers/Canonicalizer.d.mts +67 -0
- package/build/registry/canonicalizers/Canonicalizer.d.mts.map +1 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.d.mts +55 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.d.mts.map +1 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.mjs +78 -0
- package/build/registry/canonicalizers/CanonicalizerRegistry.mjs.map +1 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.d.mts +126 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.d.mts.map +1 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.mjs +143 -0
- package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.mjs.map +1 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.d.mts +34 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.d.mts.map +1 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.mjs +55 -0
- package/build/registry/canonicalizers/RawBytesCanonicalizer.mjs.map +1 -0
- package/build/registry/canonicalizers/index.d.mts +4 -0
- package/build/registry/canonicalizers/index.mjs +3 -0
- package/build/registry/index.d.mts +18 -0
- package/build/registry/index.mjs +14 -0
- package/build/registry/policies/Policy.d.mts +62 -0
- package/build/registry/policies/Policy.d.mts.map +1 -0
- package/build/registry/policies/PolicyRegistry.d.mts +54 -0
- package/build/registry/policies/PolicyRegistry.d.mts.map +1 -0
- package/build/registry/policies/PolicyRegistry.mjs +73 -0
- package/build/registry/policies/PolicyRegistry.mjs.map +1 -0
- package/build/registry/policies/TimeWindowPolicy.d.mts +85 -0
- package/build/registry/policies/TimeWindowPolicy.d.mts.map +1 -0
- package/build/registry/policies/TimeWindowPolicy.mjs +111 -0
- package/build/registry/policies/TimeWindowPolicy.mjs.map +1 -0
- package/build/registry/policies/index.d.mts +3 -0
- package/build/registry/policies/index.mjs +2 -0
- package/build/registry/suites/JwsEd25519Suite.d.mts +47 -0
- package/build/registry/suites/JwsEd25519Suite.d.mts.map +1 -0
- package/build/registry/suites/JwsEd25519Suite.mjs +101 -0
- package/build/registry/suites/JwsEd25519Suite.mjs.map +1 -0
- package/build/registry/suites/PadesBLtaSuite.d.mts +106 -0
- package/build/registry/suites/PadesBLtaSuite.d.mts.map +1 -0
- package/build/registry/suites/PadesBLtaSuite.mjs +122 -0
- package/build/registry/suites/PadesBLtaSuite.mjs.map +1 -0
- package/build/registry/suites/SignatureSuite.d.mts +128 -0
- package/build/registry/suites/SignatureSuite.d.mts.map +1 -0
- package/build/registry/suites/SignatureSuiteRegistry.d.mts +62 -0
- package/build/registry/suites/SignatureSuiteRegistry.d.mts.map +1 -0
- package/build/registry/suites/SignatureSuiteRegistry.mjs +87 -0
- package/build/registry/suites/SignatureSuiteRegistry.mjs.map +1 -0
- package/build/registry/suites/index.d.mts +4 -0
- package/build/registry/suites/index.mjs +3 -0
- package/build/repository/CounterRecord.d.mts +84 -0
- package/build/repository/CounterRecord.d.mts.map +1 -0
- package/build/repository/CounterRecord.mjs +82 -0
- package/build/repository/CounterRecord.mjs.map +1 -0
- package/build/repository/CounterRepository.d.mts +22 -0
- package/build/repository/CounterRepository.d.mts.map +1 -0
- package/build/repository/CounterRepository.mjs +51 -0
- package/build/repository/CounterRepository.mjs.map +1 -0
- package/build/repository/SigningSessionRecord.d.mts +102 -0
- package/build/repository/SigningSessionRecord.d.mts.map +1 -0
- package/build/repository/SigningSessionRecord.mjs +96 -0
- package/build/repository/SigningSessionRecord.mjs.map +1 -0
- package/build/repository/SigningSessionRepository.d.mts +30 -0
- package/build/repository/SigningSessionRepository.d.mts.map +1 -0
- package/build/repository/SigningSessionRepository.mjs +52 -0
- package/build/repository/SigningSessionRepository.mjs.map +1 -0
- package/build/repository/index.d.mts +4 -0
- package/build/repository/index.mjs +4 -0
- package/build/services/CounterService.d.mts +121 -0
- package/build/services/CounterService.d.mts.map +1 -0
- package/build/services/CounterService.mjs +176 -0
- package/build/services/CounterService.mjs.map +1 -0
- package/build/services/HPKEService.d.mts +174 -0
- package/build/services/HPKEService.d.mts.map +1 -0
- package/build/services/HPKEService.mjs +195 -0
- package/build/services/HPKEService.mjs.map +1 -0
- package/build/services/SigningService.d.mts +387 -0
- package/build/services/SigningService.d.mts.map +1 -0
- package/build/services/SigningService.mjs +1104 -0
- package/build/services/SigningService.mjs.map +1 -0
- package/build/services/index.d.mts +3 -0
- package/build/services/index.mjs +3 -0
- package/package.json +44 -3
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
import { PDFArray, PDFDocument, PDFHexString, PDFName, PDFNumber, PDFString } from "pdf-lib";
|
|
2
|
+
import * as forge from "node-forge";
|
|
3
|
+
|
|
4
|
+
//#region src/pdf/PdfUtils.ts
|
|
5
|
+
/**
|
|
6
|
+
* PDF Utilities for Digital Signatures
|
|
7
|
+
*
|
|
8
|
+
* Provides utilities for preparing PDFs for digital signatures and
|
|
9
|
+
* embedding PKCS#7 signatures into PDF documents.
|
|
10
|
+
*
|
|
11
|
+
* PDF Signature Structure:
|
|
12
|
+
* - Signature is added as an incremental update (appended to PDF)
|
|
13
|
+
* - ByteRange specifies which parts of the PDF are signed
|
|
14
|
+
* - ByteRange = [start1, length1, start2, length2] where the gap between
|
|
15
|
+
* the two ranges is where the signature hexstring is placed
|
|
16
|
+
*
|
|
17
|
+
* @see ISO 32000-2 (PDF 2.0) for signature requirements
|
|
18
|
+
* @see ETSI EN 319 142-1 for PAdES requirements
|
|
19
|
+
*/
|
|
20
|
+
/**
|
|
21
|
+
* PDF Utilities class
|
|
22
|
+
*/
|
|
23
|
+
var PdfUtils = class {
|
|
24
|
+
/**
|
|
25
|
+
* Prepare a PDF for signing by adding a signature placeholder
|
|
26
|
+
*
|
|
27
|
+
* This method:
|
|
28
|
+
* 1. Adds a signature dictionary to the PDF
|
|
29
|
+
* 2. Creates a placeholder for the PKCS#7 signature
|
|
30
|
+
* 3. Returns the byte range that needs to be signed
|
|
31
|
+
*
|
|
32
|
+
* @param pdfBytes - Original PDF bytes
|
|
33
|
+
* @param options - Signature placeholder options
|
|
34
|
+
* @returns Prepared PDF with byte range info
|
|
35
|
+
*/
|
|
36
|
+
static async preparePdfForSigning(pdfBytes, options = {}) {
|
|
37
|
+
const signatureSize = options.signatureSize ?? this.DEFAULT_SIGNATURE_SIZE;
|
|
38
|
+
const pdfDoc = await PDFDocument.load(pdfBytes, { updateMetadata: false });
|
|
39
|
+
const byteRangeArray = pdfDoc.context.obj([
|
|
40
|
+
PDFNumber.of(0),
|
|
41
|
+
PDFNumber.of(0),
|
|
42
|
+
PDFNumber.of(0),
|
|
43
|
+
PDFNumber.of(0)
|
|
44
|
+
]);
|
|
45
|
+
const signatureDict = pdfDoc.context.obj({
|
|
46
|
+
Type: PDFName.of("Sig"),
|
|
47
|
+
Filter: PDFName.of("Adobe.PPKLite"),
|
|
48
|
+
SubFilter: PDFName.of("adbe.pkcs7.detached"),
|
|
49
|
+
ByteRange: byteRangeArray,
|
|
50
|
+
Contents: PDFHexString.of("0".repeat(signatureSize * 2)),
|
|
51
|
+
M: PDFString.of(this.formatPdfDate(/* @__PURE__ */ new Date()))
|
|
52
|
+
});
|
|
53
|
+
if (options.reason) signatureDict.set(PDFName.of("Reason"), PDFString.of(options.reason));
|
|
54
|
+
if (options.location) signatureDict.set(PDFName.of("Location"), PDFString.of(options.location));
|
|
55
|
+
if (options.name) signatureDict.set(PDFName.of("Name"), PDFString.of(options.name));
|
|
56
|
+
if (options.contactInfo) signatureDict.set(PDFName.of("ContactInfo"), PDFString.of(options.contactInfo));
|
|
57
|
+
const signatureDictRef = pdfDoc.context.register(signatureDict);
|
|
58
|
+
const sigFieldDict = pdfDoc.context.obj({
|
|
59
|
+
FT: PDFName.of("Sig"),
|
|
60
|
+
T: PDFString.of("Signature1"),
|
|
61
|
+
V: signatureDictRef,
|
|
62
|
+
F: 4
|
|
63
|
+
});
|
|
64
|
+
const sigFieldRef = pdfDoc.context.register(sigFieldDict);
|
|
65
|
+
let acroFormDict = pdfDoc.catalog.lookup(PDFName.of("AcroForm"));
|
|
66
|
+
if (!acroFormDict) {
|
|
67
|
+
acroFormDict = pdfDoc.context.obj({
|
|
68
|
+
Fields: pdfDoc.context.obj([sigFieldRef]),
|
|
69
|
+
SigFlags: PDFNumber.of(3)
|
|
70
|
+
});
|
|
71
|
+
pdfDoc.catalog.set(PDFName.of("AcroForm"), acroFormDict);
|
|
72
|
+
} else {
|
|
73
|
+
const fields = acroFormDict.lookup(PDFName.of("Fields"));
|
|
74
|
+
if (fields instanceof PDFArray) fields.push(sigFieldRef);
|
|
75
|
+
else acroFormDict.set(PDFName.of("Fields"), pdfDoc.context.obj([sigFieldRef]));
|
|
76
|
+
acroFormDict.set(PDFName.of("SigFlags"), PDFNumber.of(3));
|
|
77
|
+
}
|
|
78
|
+
let modifiedPdfBytes = await pdfDoc.save({
|
|
79
|
+
useObjectStreams: false,
|
|
80
|
+
addDefaultPage: false,
|
|
81
|
+
updateFieldAppearances: false
|
|
82
|
+
});
|
|
83
|
+
let pdfString = Buffer.from(modifiedPdfBytes).toString("latin1");
|
|
84
|
+
const contentsMatch = pdfString.match(/\/Contents\s*<([0-9A-Fa-f]+)>/);
|
|
85
|
+
if (!contentsMatch) throw new Error("Could not find signature Contents placeholder");
|
|
86
|
+
const hexStart = pdfString.indexOf(contentsMatch[0]) + contentsMatch[0].indexOf("<") + 1;
|
|
87
|
+
const hexEnd = hexStart + contentsMatch[1].length;
|
|
88
|
+
const byteRangeMatch = pdfString.match(/\/ByteRange\s*\[\s*0\s+0\s+0\s+0\s*\]/);
|
|
89
|
+
if (!byteRangeMatch) throw new Error("Could not find ByteRange placeholder");
|
|
90
|
+
pdfString.indexOf(byteRangeMatch[0]);
|
|
91
|
+
const originalByteRangeStr = byteRangeMatch[0];
|
|
92
|
+
const formatNum = (n) => n.toString().padStart(10, "0");
|
|
93
|
+
const byteRange = [
|
|
94
|
+
0,
|
|
95
|
+
hexStart - 1,
|
|
96
|
+
hexEnd + 1,
|
|
97
|
+
modifiedPdfBytes.length - (hexEnd + 1)
|
|
98
|
+
];
|
|
99
|
+
const newByteRangeStr = `/ByteRange [${formatNum(byteRange[0])} ${formatNum(byteRange[1])} ${formatNum(byteRange[2])} ${formatNum(byteRange[3])}]`;
|
|
100
|
+
if (newByteRangeStr.length !== originalByteRangeStr.length) {
|
|
101
|
+
const paddedByteRange = newByteRangeStr.replace(/\]$/, " ".repeat(Math.max(0, originalByteRangeStr.length - newByteRangeStr.length)) + "]");
|
|
102
|
+
pdfString = pdfString.replace(originalByteRangeStr, paddedByteRange.length === originalByteRangeStr.length ? paddedByteRange : newByteRangeStr);
|
|
103
|
+
} else pdfString = pdfString.replace(originalByteRangeStr, newByteRangeStr);
|
|
104
|
+
modifiedPdfBytes = Buffer.from(pdfString, "latin1");
|
|
105
|
+
const finalPdfString = Buffer.from(modifiedPdfBytes).toString("latin1");
|
|
106
|
+
const finalContentsMatch = finalPdfString.match(/\/Contents\s*<([0-9A-Fa-f]+)>/);
|
|
107
|
+
if (!finalContentsMatch) throw new Error("Could not find signature Contents after ByteRange update");
|
|
108
|
+
const finalHexStart = finalPdfString.indexOf(finalContentsMatch[0]) + finalContentsMatch[0].indexOf("<") + 1;
|
|
109
|
+
const finalHexEnd = finalHexStart + finalContentsMatch[1].length;
|
|
110
|
+
const finalByteRange = [
|
|
111
|
+
0,
|
|
112
|
+
finalHexStart - 1,
|
|
113
|
+
finalHexEnd + 1,
|
|
114
|
+
modifiedPdfBytes.length - (finalHexEnd + 1)
|
|
115
|
+
];
|
|
116
|
+
const finalByteRangeMatch = finalPdfString.match(/\/ByteRange\s*\[\s*[\d\s]+\]/);
|
|
117
|
+
if (finalByteRangeMatch) {
|
|
118
|
+
const paddedFinalByteRange = `/ByteRange [${finalByteRange[0]} ${finalByteRange[1]} ${finalByteRange[2]} ${finalByteRange[3]}]`.padEnd(finalByteRangeMatch[0].length, " ");
|
|
119
|
+
const updatedPdfString = finalPdfString.replace(finalByteRangeMatch[0], paddedFinalByteRange);
|
|
120
|
+
modifiedPdfBytes = Buffer.from(updatedPdfString, "latin1");
|
|
121
|
+
}
|
|
122
|
+
return {
|
|
123
|
+
pdfBytes: new Uint8Array(modifiedPdfBytes),
|
|
124
|
+
byteRange: finalByteRange,
|
|
125
|
+
signatureOffset: finalHexStart,
|
|
126
|
+
signatureLength: signatureSize * 2
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Get the bytes to sign from a prepared PDF
|
|
131
|
+
*
|
|
132
|
+
* @param pdfBytes - PDF bytes with signature placeholder
|
|
133
|
+
* @param byteRange - Byte range from preparePdfForSigning
|
|
134
|
+
* @returns Bytes that need to be hashed and signed
|
|
135
|
+
*/
|
|
136
|
+
static getBytesToSign(pdfBytes, byteRange) {
|
|
137
|
+
const [start1, length1, start2, length2] = byteRange;
|
|
138
|
+
const part1 = pdfBytes.slice(start1, start1 + length1);
|
|
139
|
+
const part2 = pdfBytes.slice(start2, start2 + length2);
|
|
140
|
+
const result = new Uint8Array(length1 + length2);
|
|
141
|
+
result.set(part1, 0);
|
|
142
|
+
result.set(part2, length1);
|
|
143
|
+
return result;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Create a PKCS#7 detached signature
|
|
147
|
+
*
|
|
148
|
+
* @param data - Data to sign (the bytes from getBytesToSign)
|
|
149
|
+
* @param options - PKCS#7 options including certificate and private key
|
|
150
|
+
* @returns DER-encoded PKCS#7 signature
|
|
151
|
+
*/
|
|
152
|
+
static createPkcs7Signature(data, options) {
|
|
153
|
+
const hashAlg = options.hashAlgorithm ?? "sha256";
|
|
154
|
+
const cert = forge.pki.certificateFromPem(options.certificate);
|
|
155
|
+
const privateKey = forge.pki.privateKeyFromPem(options.privateKey);
|
|
156
|
+
const p7 = forge.pkcs7.createSignedData();
|
|
157
|
+
p7.content = forge.util.createBuffer("");
|
|
158
|
+
p7.addCertificate(cert);
|
|
159
|
+
p7.addSigner({
|
|
160
|
+
key: privateKey,
|
|
161
|
+
certificate: cert,
|
|
162
|
+
digestAlgorithm: forge.pki.oids[hashAlg],
|
|
163
|
+
authenticatedAttributes: [
|
|
164
|
+
{
|
|
165
|
+
type: forge.pki.oids.contentType,
|
|
166
|
+
value: forge.pki.oids.data
|
|
167
|
+
},
|
|
168
|
+
{
|
|
169
|
+
type: forge.pki.oids.signingTime,
|
|
170
|
+
value: /* @__PURE__ */ new Date()
|
|
171
|
+
},
|
|
172
|
+
{ type: forge.pki.oids.messageDigest }
|
|
173
|
+
]
|
|
174
|
+
});
|
|
175
|
+
forge.md[hashAlg].create().update(forge.util.binary.raw.encode(data));
|
|
176
|
+
p7.sign({ detached: true });
|
|
177
|
+
const asn1 = p7.toAsn1();
|
|
178
|
+
const der = forge.asn1.toDer(asn1);
|
|
179
|
+
return new Uint8Array(Buffer.from(der.getBytes(), "binary"));
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* Embed a signature into a prepared PDF
|
|
183
|
+
*
|
|
184
|
+
* @param pdfBytes - PDF bytes with signature placeholder
|
|
185
|
+
* @param signature - DER-encoded PKCS#7 signature
|
|
186
|
+
* @param signatureOffset - Offset from preparePdfForSigning
|
|
187
|
+
* @param signatureLength - Length from preparePdfForSigning
|
|
188
|
+
* @returns PDF with embedded signature
|
|
189
|
+
*/
|
|
190
|
+
static embedSignature(pdfBytes, signature, signatureOffset, signatureLength) {
|
|
191
|
+
const hexSignature = Buffer.from(signature).toString("hex").toUpperCase();
|
|
192
|
+
if (hexSignature.length > signatureLength) throw new Error(`Signature too large: ${hexSignature.length} > ${signatureLength}`);
|
|
193
|
+
const paddedSignature = hexSignature.padEnd(signatureLength, "0");
|
|
194
|
+
const result = Buffer.from(pdfBytes);
|
|
195
|
+
result.write(paddedSignature, signatureOffset, "latin1");
|
|
196
|
+
return new Uint8Array(result);
|
|
197
|
+
}
|
|
198
|
+
/**
|
|
199
|
+
* Sign a PDF document end-to-end
|
|
200
|
+
*
|
|
201
|
+
* Convenience method that combines all steps:
|
|
202
|
+
* 1. Prepare PDF with signature placeholder
|
|
203
|
+
* 2. Get bytes to sign
|
|
204
|
+
* 3. Create PKCS#7 signature
|
|
205
|
+
* 4. Embed signature
|
|
206
|
+
*
|
|
207
|
+
* @param pdfBytes - Original PDF bytes
|
|
208
|
+
* @param pkcs7Options - Certificate and private key
|
|
209
|
+
* @param placeholderOptions - Optional signature metadata
|
|
210
|
+
* @returns Signed PDF bytes
|
|
211
|
+
*/
|
|
212
|
+
static async signPdf(pdfBytes, pkcs7Options, placeholderOptions = {}) {
|
|
213
|
+
const prepared = await this.preparePdfForSigning(pdfBytes, placeholderOptions);
|
|
214
|
+
const bytesToSign = this.getBytesToSign(prepared.pdfBytes, prepared.byteRange);
|
|
215
|
+
const signature = this.createPkcs7Signature(bytesToSign, pkcs7Options);
|
|
216
|
+
return this.embedSignature(prepared.pdfBytes, signature, prepared.signatureOffset, prepared.signatureLength);
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* Verify a PDF signature
|
|
220
|
+
*
|
|
221
|
+
* @param pdfBytes - Signed PDF bytes
|
|
222
|
+
* @returns Verification result
|
|
223
|
+
*/
|
|
224
|
+
static async verifyPdfSignature(pdfBytes) {
|
|
225
|
+
try {
|
|
226
|
+
if (!(await PDFDocument.load(pdfBytes, { updateMetadata: false })).catalog.get(PDFName.of("AcroForm"))) return {
|
|
227
|
+
valid: false,
|
|
228
|
+
error: "No AcroForm found"
|
|
229
|
+
};
|
|
230
|
+
return { valid: true };
|
|
231
|
+
} catch (error) {
|
|
232
|
+
return {
|
|
233
|
+
valid: false,
|
|
234
|
+
error: String(error)
|
|
235
|
+
};
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* Extract signature info from a signed PDF
|
|
240
|
+
*
|
|
241
|
+
* @param pdfBytes - Signed PDF bytes
|
|
242
|
+
* @returns Signature information
|
|
243
|
+
*/
|
|
244
|
+
static async extractSignatureInfo(pdfBytes) {
|
|
245
|
+
const pdfString = Buffer.from(pdfBytes).toString("latin1");
|
|
246
|
+
const byteRangeMatch = pdfString.match(/\/ByteRange\s*\[\s*(\d+)\s+(\d+)\s+(\d+)\s+(\d+)\s*\]/);
|
|
247
|
+
if (!byteRangeMatch) return { hasSig: false };
|
|
248
|
+
const byteRange = [
|
|
249
|
+
parseInt(byteRangeMatch[1]),
|
|
250
|
+
parseInt(byteRangeMatch[2]),
|
|
251
|
+
parseInt(byteRangeMatch[3]),
|
|
252
|
+
parseInt(byteRangeMatch[4])
|
|
253
|
+
];
|
|
254
|
+
const contentsMatch = pdfString.match(/\/Contents\s*<([0-9A-Fa-f]+)>/);
|
|
255
|
+
const signatureHex = contentsMatch ? contentsMatch[1].replace(/0+$/, "") : void 0;
|
|
256
|
+
const nameMatch = pdfString.match(/\/Name\s*\(([^)]+)\)/);
|
|
257
|
+
const reasonMatch = pdfString.match(/\/Reason\s*\(([^)]+)\)/);
|
|
258
|
+
const locationMatch = pdfString.match(/\/Location\s*\(([^)]+)\)/);
|
|
259
|
+
const timeMatch = pdfString.match(/\/M\s*\(D:([^)]+)\)/);
|
|
260
|
+
return {
|
|
261
|
+
hasSig: true,
|
|
262
|
+
byteRange,
|
|
263
|
+
signatureHex,
|
|
264
|
+
signerName: nameMatch?.[1],
|
|
265
|
+
reason: reasonMatch?.[1],
|
|
266
|
+
location: locationMatch?.[1],
|
|
267
|
+
signingTime: timeMatch?.[1]
|
|
268
|
+
};
|
|
269
|
+
}
|
|
270
|
+
/**
|
|
271
|
+
* Format a date for PDF (D:YYYYMMDDHHmmss+HH'mm')
|
|
272
|
+
*/
|
|
273
|
+
static formatPdfDate(date) {
|
|
274
|
+
const pad = (n) => n.toString().padStart(2, "0");
|
|
275
|
+
return `D:${date.getUTCFullYear()}${pad(date.getUTCMonth() + 1)}${pad(date.getUTCDate())}${pad(date.getUTCHours())}${pad(date.getUTCMinutes())}${pad(date.getUTCSeconds())}Z`;
|
|
276
|
+
}
|
|
277
|
+
};
|
|
278
|
+
PdfUtils.DEFAULT_SIGNATURE_SIZE = 8192;
|
|
279
|
+
PdfUtils.BYTE_RANGE_PLACEHOLDER = "0000000000 0000000000 0000000000 0000000000";
|
|
280
|
+
|
|
281
|
+
//#endregion
|
|
282
|
+
export { PdfUtils };
|
|
283
|
+
//# sourceMappingURL=PdfUtils.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PdfUtils.mjs","names":[],"sources":["../../src/pdf/PdfUtils.ts"],"sourcesContent":["/**\n * PDF Utilities for Digital Signatures\n *\n * Provides utilities for preparing PDFs for digital signatures and\n * embedding PKCS#7 signatures into PDF documents.\n *\n * PDF Signature Structure:\n * - Signature is added as an incremental update (appended to PDF)\n * - ByteRange specifies which parts of the PDF are signed\n * - ByteRange = [start1, length1, start2, length2] where the gap between\n * the two ranges is where the signature hexstring is placed\n *\n * @see ISO 32000-2 (PDF 2.0) for signature requirements\n * @see ETSI EN 319 142-1 for PAdES requirements\n */\n\nimport { PDFDocument, PDFName, PDFDict, PDFHexString, PDFArray, PDFNumber, PDFString } from 'pdf-lib'\nimport * as forge from 'node-forge'\n\n/**\n * Signature placeholder configuration\n */\nexport interface SignaturePlaceholderOptions {\n /** Reason for signing */\n reason?: string\n /** Location of signing */\n location?: string\n /** Name of signer */\n name?: string\n /** Contact info */\n contactInfo?: string\n /** Reserved size for signature in bytes (default: 8192) */\n signatureSize?: number\n}\n\n/**\n * Result of preparing a PDF for signing\n */\nexport interface PreparedPdfResult {\n /** PDF bytes with signature placeholder */\n pdfBytes: Uint8Array\n /** Byte range to sign [start1, len1, start2, len2] */\n byteRange: [number, number, number, number]\n /** Offset where signature hex string should be placed */\n signatureOffset: number\n /** Length of signature placeholder */\n signatureLength: number\n}\n\n/**\n * PKCS#7 signature container options\n */\nexport interface Pkcs7Options {\n /** Signer's certificate in PEM format */\n certificate: string\n /** Signer's private key in PEM format */\n privateKey: string\n /** Hash algorithm (sha256, sha384, sha512) */\n hashAlgorithm?: 'sha256' | 'sha384' | 'sha512'\n /** Include signing time attribute */\n includeSigningTime?: boolean\n}\n\n/**\n * PDF Utilities class\n */\nexport class PdfUtils {\n /**\n * Default signature placeholder size (8KB should be sufficient for most certificates)\n */\n private static readonly DEFAULT_SIGNATURE_SIZE = 8192\n\n /**\n * ByteRange placeholder - fixed size to avoid byte offset shifts\n * Format: [0000000000 0000000000 0000000000 0000000000]\n */\n private static readonly BYTE_RANGE_PLACEHOLDER = '0000000000 0000000000 0000000000 0000000000'\n\n /**\n * Prepare a PDF for signing by adding a signature placeholder\n *\n * This method:\n * 1. Adds a signature dictionary to the PDF\n * 2. Creates a placeholder for the PKCS#7 signature\n * 3. Returns the byte range that needs to be signed\n *\n * @param pdfBytes - Original PDF bytes\n * @param options - Signature placeholder options\n * @returns Prepared PDF with byte range info\n */\n public static async preparePdfForSigning(\n pdfBytes: Uint8Array,\n options: SignaturePlaceholderOptions = {}\n ): Promise<PreparedPdfResult> {\n const signatureSize = options.signatureSize ?? this.DEFAULT_SIGNATURE_SIZE\n\n // Load the PDF\n const pdfDoc = await PDFDocument.load(pdfBytes, {\n updateMetadata: false,\n })\n\n // Create ByteRange array with placeholder values (fixed size)\n const byteRangeArray = pdfDoc.context.obj([\n PDFNumber.of(0),\n PDFNumber.of(0),\n PDFNumber.of(0),\n PDFNumber.of(0),\n ])\n\n // Create signature dictionary\n const signatureDict = pdfDoc.context.obj({\n Type: PDFName.of('Sig'),\n Filter: PDFName.of('Adobe.PPKLite'),\n SubFilter: PDFName.of('adbe.pkcs7.detached'),\n ByteRange: byteRangeArray,\n Contents: PDFHexString.of('0'.repeat(signatureSize * 2)), // Placeholder\n M: PDFString.of(this.formatPdfDate(new Date())),\n })\n\n // Add optional fields\n if (options.reason) {\n signatureDict.set(PDFName.of('Reason'), PDFString.of(options.reason))\n }\n if (options.location) {\n signatureDict.set(PDFName.of('Location'), PDFString.of(options.location))\n }\n if (options.name) {\n signatureDict.set(PDFName.of('Name'), PDFString.of(options.name))\n }\n if (options.contactInfo) {\n signatureDict.set(PDFName.of('ContactInfo'), PDFString.of(options.contactInfo))\n }\n\n // Register the signature dictionary\n const signatureDictRef = pdfDoc.context.register(signatureDict)\n\n // Create signature field\n const sigFieldDict = pdfDoc.context.obj({\n FT: PDFName.of('Sig'),\n T: PDFString.of('Signature1'),\n V: signatureDictRef,\n F: 4, // Print flag\n })\n\n const sigFieldRef = pdfDoc.context.register(sigFieldDict)\n\n // Get or create AcroForm\n let acroFormDict = pdfDoc.catalog.lookup(PDFName.of('AcroForm')) as PDFDict | undefined\n if (!acroFormDict) {\n acroFormDict = pdfDoc.context.obj({\n Fields: pdfDoc.context.obj([sigFieldRef]),\n SigFlags: PDFNumber.of(3), // SignaturesExist | AppendOnly\n })\n pdfDoc.catalog.set(PDFName.of('AcroForm'), acroFormDict)\n } else {\n // Add field to existing AcroForm\n const fields = acroFormDict.lookup(PDFName.of('Fields'))\n if (fields instanceof PDFArray) {\n fields.push(sigFieldRef)\n } else {\n acroFormDict.set(PDFName.of('Fields'), pdfDoc.context.obj([sigFieldRef]))\n }\n // Set signature flags\n acroFormDict.set(PDFName.of('SigFlags'), PDFNumber.of(3))\n }\n\n // Save the PDF\n let modifiedPdfBytes = await pdfDoc.save({\n useObjectStreams: false,\n addDefaultPage: false,\n updateFieldAppearances: false,\n })\n\n // Find the ByteRange and Contents placeholders\n let pdfString = Buffer.from(modifiedPdfBytes).toString('latin1')\n\n // Find Contents placeholder\n const contentsMatch = pdfString.match(/\\/Contents\\s*<([0-9A-Fa-f]+)>/)\n if (!contentsMatch) {\n throw new Error('Could not find signature Contents placeholder')\n }\n\n const contentsStart = pdfString.indexOf(contentsMatch[0])\n const hexStart = contentsStart + contentsMatch[0].indexOf('<') + 1\n const hexEnd = hexStart + contentsMatch[1].length\n\n // Find ByteRange placeholder - it's now [0 0 0 0]\n const byteRangeMatch = pdfString.match(/\\/ByteRange\\s*\\[\\s*0\\s+0\\s+0\\s+0\\s*\\]/)\n if (!byteRangeMatch) {\n throw new Error('Could not find ByteRange placeholder')\n }\n\n const byteRangeStart = pdfString.indexOf(byteRangeMatch[0])\n const originalByteRangeStr = byteRangeMatch[0]\n\n // Calculate the actual byte range values\n // First, we need to know how big the new ByteRange string will be\n // We'll format it with padded numbers to maintain consistent size\n const formatNum = (n: number) => n.toString().padStart(10, '0')\n\n // Calculate byte range (before replacement)\n // ByteRange = [0, hexStart-1, hexEnd+1, fileLength - (hexEnd+1)]\n const byteRange: [number, number, number, number] = [\n 0,\n hexStart - 1,\n hexEnd + 1,\n modifiedPdfBytes.length - (hexEnd + 1),\n ]\n\n // Create the replacement ByteRange string with exact same length\n const newByteRangeStr = `/ByteRange [${formatNum(byteRange[0])} ${formatNum(byteRange[1])} ${formatNum(byteRange[2])} ${formatNum(byteRange[3])}]`\n\n // Pad the original to match if needed, or use the exact replacement\n // The key is that we need consistent sizing\n if (newByteRangeStr.length !== originalByteRangeStr.length) {\n // Pad the new string to match original length (add spaces before closing bracket)\n const paddedByteRange = newByteRangeStr.replace(/\\]$/, ' '.repeat(Math.max(0, originalByteRangeStr.length - newByteRangeStr.length)) + ']')\n\n // Replace in the PDF\n pdfString = pdfString.replace(originalByteRangeStr, paddedByteRange.length === originalByteRangeStr.length ? paddedByteRange : newByteRangeStr)\n } else {\n pdfString = pdfString.replace(originalByteRangeStr, newByteRangeStr)\n }\n\n modifiedPdfBytes = Buffer.from(pdfString, 'latin1')\n\n // Recalculate positions after replacement if lengths changed\n const finalPdfString = Buffer.from(modifiedPdfBytes).toString('latin1')\n const finalContentsMatch = finalPdfString.match(/\\/Contents\\s*<([0-9A-Fa-f]+)>/)\n if (!finalContentsMatch) {\n throw new Error('Could not find signature Contents after ByteRange update')\n }\n\n const finalContentsStart = finalPdfString.indexOf(finalContentsMatch[0])\n const finalHexStart = finalContentsStart + finalContentsMatch[0].indexOf('<') + 1\n const finalHexEnd = finalHexStart + finalContentsMatch[1].length\n\n // Recalculate final byte range\n const finalByteRange: [number, number, number, number] = [\n 0,\n finalHexStart - 1,\n finalHexEnd + 1,\n modifiedPdfBytes.length - (finalHexEnd + 1),\n ]\n\n // Update ByteRange again with final values\n const finalByteRangeMatch = finalPdfString.match(/\\/ByteRange\\s*\\[\\s*[\\d\\s]+\\]/)\n if (finalByteRangeMatch) {\n const finalByteRangeStr = `/ByteRange [${finalByteRange[0]} ${finalByteRange[1]} ${finalByteRange[2]} ${finalByteRange[3]}]`\n const paddedFinalByteRange = finalByteRangeStr.padEnd(finalByteRangeMatch[0].length, ' ')\n\n const updatedPdfString = finalPdfString.replace(finalByteRangeMatch[0], paddedFinalByteRange)\n modifiedPdfBytes = Buffer.from(updatedPdfString, 'latin1')\n }\n\n return {\n pdfBytes: new Uint8Array(modifiedPdfBytes),\n byteRange: finalByteRange,\n signatureOffset: finalHexStart,\n signatureLength: signatureSize * 2,\n }\n }\n\n /**\n * Get the bytes to sign from a prepared PDF\n *\n * @param pdfBytes - PDF bytes with signature placeholder\n * @param byteRange - Byte range from preparePdfForSigning\n * @returns Bytes that need to be hashed and signed\n */\n public static getBytesToSign(pdfBytes: Uint8Array, byteRange: [number, number, number, number]): Uint8Array {\n const [start1, length1, start2, length2] = byteRange\n\n // Concatenate the two ranges\n const part1 = pdfBytes.slice(start1, start1 + length1)\n const part2 = pdfBytes.slice(start2, start2 + length2)\n\n const result = new Uint8Array(length1 + length2)\n result.set(part1, 0)\n result.set(part2, length1)\n\n return result\n }\n\n /**\n * Create a PKCS#7 detached signature\n *\n * @param data - Data to sign (the bytes from getBytesToSign)\n * @param options - PKCS#7 options including certificate and private key\n * @returns DER-encoded PKCS#7 signature\n */\n public static createPkcs7Signature(data: Uint8Array, options: Pkcs7Options): Uint8Array {\n const hashAlg = options.hashAlgorithm ?? 'sha256'\n\n // Parse certificate and private key\n const cert = forge.pki.certificateFromPem(options.certificate)\n const privateKey = forge.pki.privateKeyFromPem(options.privateKey)\n\n // Create PKCS#7 signed data\n const p7 = forge.pkcs7.createSignedData()\n\n // Set content (empty for detached signature, but we need to set the hash)\n p7.content = forge.util.createBuffer('')\n\n // Add certificate\n p7.addCertificate(cert)\n\n // Add signer (type cast needed as node-forge types are incomplete)\n p7.addSigner({\n key: privateKey,\n certificate: cert,\n digestAlgorithm: forge.pki.oids[hashAlg],\n authenticatedAttributes: [\n {\n type: forge.pki.oids.contentType,\n value: forge.pki.oids.data,\n },\n {\n type: forge.pki.oids.signingTime,\n value: new Date(),\n },\n {\n type: forge.pki.oids.messageDigest,\n // Will be calculated automatically\n },\n ],\n } as any)\n\n // Compute the message digest manually for detached signature\n const md = forge.md[hashAlg].create()\n md.update(forge.util.binary.raw.encode(data))\n\n // Sign with the digest\n p7.sign({ detached: true })\n\n // Get DER-encoded signature\n const asn1 = p7.toAsn1()\n const der = forge.asn1.toDer(asn1)\n\n return new Uint8Array(Buffer.from(der.getBytes(), 'binary'))\n }\n\n /**\n * Embed a signature into a prepared PDF\n *\n * @param pdfBytes - PDF bytes with signature placeholder\n * @param signature - DER-encoded PKCS#7 signature\n * @param signatureOffset - Offset from preparePdfForSigning\n * @param signatureLength - Length from preparePdfForSigning\n * @returns PDF with embedded signature\n */\n public static embedSignature(\n pdfBytes: Uint8Array,\n signature: Uint8Array,\n signatureOffset: number,\n signatureLength: number\n ): Uint8Array {\n // Convert signature to hex string\n const hexSignature = Buffer.from(signature).toString('hex').toUpperCase()\n\n // Pad to fit the placeholder\n if (hexSignature.length > signatureLength) {\n throw new Error(`Signature too large: ${hexSignature.length} > ${signatureLength}`)\n }\n\n const paddedSignature = hexSignature.padEnd(signatureLength, '0')\n\n // Create result buffer\n const result = Buffer.from(pdfBytes)\n\n // Write signature at offset\n result.write(paddedSignature, signatureOffset, 'latin1')\n\n return new Uint8Array(result)\n }\n\n /**\n * Sign a PDF document end-to-end\n *\n * Convenience method that combines all steps:\n * 1. Prepare PDF with signature placeholder\n * 2. Get bytes to sign\n * 3. Create PKCS#7 signature\n * 4. Embed signature\n *\n * @param pdfBytes - Original PDF bytes\n * @param pkcs7Options - Certificate and private key\n * @param placeholderOptions - Optional signature metadata\n * @returns Signed PDF bytes\n */\n public static async signPdf(\n pdfBytes: Uint8Array,\n pkcs7Options: Pkcs7Options,\n placeholderOptions: SignaturePlaceholderOptions = {}\n ): Promise<Uint8Array> {\n // Step 1: Prepare PDF\n const prepared = await this.preparePdfForSigning(pdfBytes, placeholderOptions)\n\n // Step 2: Get bytes to sign\n const bytesToSign = this.getBytesToSign(prepared.pdfBytes, prepared.byteRange)\n\n // Step 3: Create signature\n const signature = this.createPkcs7Signature(bytesToSign, pkcs7Options)\n\n // Step 4: Embed signature\n return this.embedSignature(prepared.pdfBytes, signature, prepared.signatureOffset, prepared.signatureLength)\n }\n\n /**\n * Verify a PDF signature\n *\n * @param pdfBytes - Signed PDF bytes\n * @returns Verification result\n */\n public static async verifyPdfSignature(pdfBytes: Uint8Array): Promise<{\n valid: boolean\n signerName?: string\n signingTime?: Date\n reason?: string\n error?: string\n }> {\n try {\n const pdfDoc = await PDFDocument.load(pdfBytes, { updateMetadata: false })\n\n // Find signature field\n const acroForm = pdfDoc.catalog.get(PDFName.of('AcroForm'))\n if (!acroForm) {\n return { valid: false, error: 'No AcroForm found' }\n }\n\n // This is a simplified verification - full verification would need to:\n // 1. Parse ByteRange from signature dict\n // 2. Extract PKCS#7 from Contents\n // 3. Verify the PKCS#7 signature over the byte ranges\n // 4. Validate certificate chain\n\n // For now, return basic structure validation\n return { valid: true }\n } catch (error) {\n return { valid: false, error: String(error) }\n }\n }\n\n /**\n * Extract signature info from a signed PDF\n *\n * @param pdfBytes - Signed PDF bytes\n * @returns Signature information\n */\n public static async extractSignatureInfo(pdfBytes: Uint8Array): Promise<{\n hasSig: boolean\n byteRange?: [number, number, number, number]\n signatureHex?: string\n signerName?: string\n reason?: string\n location?: string\n signingTime?: string\n }> {\n const pdfString = Buffer.from(pdfBytes).toString('latin1')\n\n // Find ByteRange\n const byteRangeMatch = pdfString.match(/\\/ByteRange\\s*\\[\\s*(\\d+)\\s+(\\d+)\\s+(\\d+)\\s+(\\d+)\\s*\\]/)\n if (!byteRangeMatch) {\n return { hasSig: false }\n }\n\n const byteRange: [number, number, number, number] = [\n parseInt(byteRangeMatch[1]),\n parseInt(byteRangeMatch[2]),\n parseInt(byteRangeMatch[3]),\n parseInt(byteRangeMatch[4]),\n ]\n\n // Find Contents (signature)\n const contentsMatch = pdfString.match(/\\/Contents\\s*<([0-9A-Fa-f]+)>/)\n const signatureHex = contentsMatch ? contentsMatch[1].replace(/0+$/, '') : undefined\n\n // Extract optional fields\n const nameMatch = pdfString.match(/\\/Name\\s*\\(([^)]+)\\)/)\n const reasonMatch = pdfString.match(/\\/Reason\\s*\\(([^)]+)\\)/)\n const locationMatch = pdfString.match(/\\/Location\\s*\\(([^)]+)\\)/)\n const timeMatch = pdfString.match(/\\/M\\s*\\(D:([^)]+)\\)/)\n\n return {\n hasSig: true,\n byteRange,\n signatureHex,\n signerName: nameMatch?.[1],\n reason: reasonMatch?.[1],\n location: locationMatch?.[1],\n signingTime: timeMatch?.[1],\n }\n }\n\n /**\n * Format a date for PDF (D:YYYYMMDDHHmmss+HH'mm')\n */\n private static formatPdfDate(date: Date): string {\n const pad = (n: number) => n.toString().padStart(2, '0')\n\n const year = date.getUTCFullYear()\n const month = pad(date.getUTCMonth() + 1)\n const day = pad(date.getUTCDate())\n const hours = pad(date.getUTCHours())\n const minutes = pad(date.getUTCMinutes())\n const seconds = pad(date.getUTCSeconds())\n\n return `D:${year}${month}${day}${hours}${minutes}${seconds}Z`\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import { PdfUtils } from "./PdfUtils.mjs";
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { SignableObject } from "../../models/SignableObject.mjs";
|
|
2
|
+
import { Session } from "../../models/Session.mjs";
|
|
3
|
+
import { PartialSignature } from "../../models/PartialSignature.mjs";
|
|
4
|
+
import { AggregationResult } from "../../models/AggregationResult.mjs";
|
|
5
|
+
import "../../models/index.mjs";
|
|
6
|
+
import { AgentContext } from "@credo-ts/core";
|
|
7
|
+
|
|
8
|
+
//#region src/registry/aggregators/Aggregator.d.ts
|
|
9
|
+
/**
|
|
10
|
+
* Aggregator type
|
|
11
|
+
*/
|
|
12
|
+
type AggregationType = 'none' | 'math' | 'contract' | 'bundle';
|
|
13
|
+
/**
|
|
14
|
+
* Metadata for an aggregator
|
|
15
|
+
*/
|
|
16
|
+
interface AggregatorMetadata {
|
|
17
|
+
/**
|
|
18
|
+
* Unique identifier with version
|
|
19
|
+
* @example "math-aggregate@1"
|
|
20
|
+
*/
|
|
21
|
+
readonly id: string;
|
|
22
|
+
/**
|
|
23
|
+
* Version number
|
|
24
|
+
*/
|
|
25
|
+
readonly version: number;
|
|
26
|
+
/**
|
|
27
|
+
* Aggregator name
|
|
28
|
+
* @example "math-aggregate"
|
|
29
|
+
*/
|
|
30
|
+
readonly name: string;
|
|
31
|
+
/**
|
|
32
|
+
* Aggregation type
|
|
33
|
+
*/
|
|
34
|
+
readonly aggregationType: AggregationType;
|
|
35
|
+
/**
|
|
36
|
+
* Signature suites this aggregator supports
|
|
37
|
+
* @example ["schnorr-musig2@1", "bls-aggregate@1"]
|
|
38
|
+
*/
|
|
39
|
+
readonly supportedSuites: string[];
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Input for aggregation operation
|
|
43
|
+
*/
|
|
44
|
+
interface AggregateInput {
|
|
45
|
+
/**
|
|
46
|
+
* Partial signatures to aggregate
|
|
47
|
+
*/
|
|
48
|
+
partialSignatures: PartialSignature[];
|
|
49
|
+
/**
|
|
50
|
+
* Session configuration
|
|
51
|
+
*/
|
|
52
|
+
session: Session;
|
|
53
|
+
/**
|
|
54
|
+
* Object being signed
|
|
55
|
+
*/
|
|
56
|
+
object: SignableObject;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Aggregator interface - combines multiple signatures
|
|
60
|
+
*
|
|
61
|
+
* Aggregators handle combining partial signatures using different
|
|
62
|
+
* strategies: simple collection, cryptographic aggregation, or
|
|
63
|
+
* contract-based execution.
|
|
64
|
+
*/
|
|
65
|
+
interface Aggregator extends AggregatorMetadata {
|
|
66
|
+
/**
|
|
67
|
+
* Aggregate partial signatures
|
|
68
|
+
*
|
|
69
|
+
* @param agentContext - Agent context
|
|
70
|
+
* @param input - Aggregation input
|
|
71
|
+
* @returns Aggregation result with final artifact
|
|
72
|
+
*/
|
|
73
|
+
aggregate(agentContext: AgentContext, input: AggregateInput): Promise<AggregationResult>;
|
|
74
|
+
/**
|
|
75
|
+
* Check if aggregation can be performed
|
|
76
|
+
*
|
|
77
|
+
* @param partialSignatures - Partial signatures available
|
|
78
|
+
* @param session - Session configuration
|
|
79
|
+
* @returns True if can aggregate
|
|
80
|
+
*/
|
|
81
|
+
canAggregate(partialSignatures: PartialSignature[], session: Session): Promise<boolean>;
|
|
82
|
+
}
|
|
83
|
+
//#endregion
|
|
84
|
+
export { AggregateInput, AggregationType, Aggregator, AggregatorMetadata };
|
|
85
|
+
//# sourceMappingURL=Aggregator.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Aggregator.d.mts","names":[],"sources":["../../../src/registry/aggregators/Aggregator.ts"],"mappings":";;;;;;;;;;;KAMY,eAAA;;;AAAZ;UAKiB,kBAAA;;;;AAAjB;WAKW,EAAA;;;;WAKA,OAAA;EAMA;;;;EAAA,SAAA,IAAA;EAWe;AAM1B;;EAN0B,SANf,eAAA,EAAiB,eAAA;EAgBP;;;;EAAA,SAVV,eAAA;AAAA;;;;UAMM,cAAA;EAcP;;;EAVR,iBAAA,EAAmB,gBAAA;EAoBO;;;EAf1B,OAAA,EAAS,OAAA;EAuB6D;;;EAlBtE,MAAA,EAAQ,cAAA;AAAA;;;;;;;;UAUO,UAAA,SAAmB,kBAAA;EAQI;;;;;;;EAAtC,SAAA,CAAU,YAAA,EAAc,YAAA,EAAc,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,iBAAA;EASC;;;;;;;EAAvE,YAAA,CAAa,iBAAA,EAAmB,gBAAA,IAAoB,OAAA,EAAS,OAAA,GAAU,OAAA;AAAA"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { AggregatorCapability } from "../../models/Capabilities.mjs";
|
|
2
|
+
import "../../models/index.mjs";
|
|
3
|
+
import { Aggregator } from "./Aggregator.mjs";
|
|
4
|
+
|
|
5
|
+
//#region src/registry/aggregators/AggregatorRegistry.d.ts
|
|
6
|
+
declare const AggregatorToken: unique symbol;
|
|
7
|
+
/**
|
|
8
|
+
* Registry for aggregator modules
|
|
9
|
+
*
|
|
10
|
+
* Uses dependency injection to allow pluggable aggregators.
|
|
11
|
+
* Aggregators can be registered by adding them to the module config.
|
|
12
|
+
*/
|
|
13
|
+
declare class AggregatorRegistry {
|
|
14
|
+
private aggregators;
|
|
15
|
+
constructor(aggregators: Array<Aggregator | 'default'>);
|
|
16
|
+
/**
|
|
17
|
+
* Get aggregator by ID
|
|
18
|
+
*
|
|
19
|
+
* @param id - Aggregator ID (e.g., "math-aggregate@1")
|
|
20
|
+
* @throws {CredoError} if not found
|
|
21
|
+
*/
|
|
22
|
+
getById(id: string): Aggregator;
|
|
23
|
+
/**
|
|
24
|
+
* Get all aggregators that support a suite
|
|
25
|
+
*
|
|
26
|
+
* @param suiteId - Suite ID to search for
|
|
27
|
+
* @returns Array of matching aggregators
|
|
28
|
+
*/
|
|
29
|
+
getBySuite(suiteId: string): Aggregator[];
|
|
30
|
+
/**
|
|
31
|
+
* Get aggregators by type
|
|
32
|
+
*
|
|
33
|
+
* @param type - Aggregation type
|
|
34
|
+
* @returns Array of aggregators
|
|
35
|
+
*/
|
|
36
|
+
getByType(type: 'none' | 'math' | 'contract' | 'bundle'): Aggregator[];
|
|
37
|
+
/**
|
|
38
|
+
* Check if an aggregator is supported
|
|
39
|
+
*
|
|
40
|
+
* @param id - Aggregator ID
|
|
41
|
+
* @returns True if supported
|
|
42
|
+
*/
|
|
43
|
+
isSupported(id: string): boolean;
|
|
44
|
+
/**
|
|
45
|
+
* Get all supported aggregator IDs
|
|
46
|
+
*/
|
|
47
|
+
get supportedIds(): string[];
|
|
48
|
+
/**
|
|
49
|
+
* Get capabilities for proposal/negotiation
|
|
50
|
+
*/
|
|
51
|
+
get capabilities(): AggregatorCapability[];
|
|
52
|
+
}
|
|
53
|
+
//#endregion
|
|
54
|
+
export { AggregatorRegistry, AggregatorToken };
|
|
55
|
+
//# sourceMappingURL=AggregatorRegistry.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AggregatorRegistry.d.mts","names":[],"sources":["../../../src/registry/aggregators/AggregatorRegistry.ts"],"mappings":";;;;;cAKa,eAAA;;;AAAb;;;;cASa,kBAAA;EAAA,QACH,WAAA;cAEuC,WAAA,EAAa,KAAA,CAAM,UAAA;;;;;;;EAW3D,OAAA,CAAQ,EAAA,WAAa,UAAA;EAoDmB;;;;;;EApCxC,UAAA,CAAW,OAAA,WAAkB,UAAA;EAhB7B;;;;;;EA4BA,SAAA,CAAU,IAAA,4CAAgD,UAAA;EAAhD;;;;;;EAUV,WAAA,CAAY,EAAA;EAc4B;;;EAAA,IAPpC,YAAA,CAAA;;;;MAOA,YAAA,CAAA,GAAgB,oBAAA;AAAA"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateMetadata.mjs";
|
|
2
|
+
import { __decorateParam } from "../../_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateParam.mjs";
|
|
3
|
+
import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.112.0/helpers/decorate.mjs";
|
|
4
|
+
import { CredoError, injectAll, injectable } from "@credo-ts/core";
|
|
5
|
+
|
|
6
|
+
//#region src/registry/aggregators/AggregatorRegistry.ts
|
|
7
|
+
var _ref;
|
|
8
|
+
const AggregatorToken = Symbol("AggregatorToken");
|
|
9
|
+
let AggregatorRegistry = class AggregatorRegistry {
|
|
10
|
+
constructor(aggregators) {
|
|
11
|
+
this.aggregators = aggregators.filter((a) => a !== "default");
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Get aggregator by ID
|
|
15
|
+
*
|
|
16
|
+
* @param id - Aggregator ID (e.g., "math-aggregate@1")
|
|
17
|
+
* @throws {CredoError} if not found
|
|
18
|
+
*/
|
|
19
|
+
getById(id) {
|
|
20
|
+
const aggregator = this.aggregators.find((a) => a.id === id);
|
|
21
|
+
if (!aggregator) throw new CredoError(`Aggregator not found: ${id}. Available: ${this.supportedIds.join(", ")}`);
|
|
22
|
+
return aggregator;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Get all aggregators that support a suite
|
|
26
|
+
*
|
|
27
|
+
* @param suiteId - Suite ID to search for
|
|
28
|
+
* @returns Array of matching aggregators
|
|
29
|
+
*/
|
|
30
|
+
getBySuite(suiteId) {
|
|
31
|
+
return this.aggregators.filter((a) => a.supportedSuites.includes("*") || a.supportedSuites.includes(suiteId));
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Get aggregators by type
|
|
35
|
+
*
|
|
36
|
+
* @param type - Aggregation type
|
|
37
|
+
* @returns Array of aggregators
|
|
38
|
+
*/
|
|
39
|
+
getByType(type) {
|
|
40
|
+
return this.aggregators.filter((a) => a.aggregationType === type);
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Check if an aggregator is supported
|
|
44
|
+
*
|
|
45
|
+
* @param id - Aggregator ID
|
|
46
|
+
* @returns True if supported
|
|
47
|
+
*/
|
|
48
|
+
isSupported(id) {
|
|
49
|
+
return this.aggregators.some((a) => a.id === id);
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Get all supported aggregator IDs
|
|
53
|
+
*/
|
|
54
|
+
get supportedIds() {
|
|
55
|
+
return this.aggregators.map((a) => a.id);
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Get capabilities for proposal/negotiation
|
|
59
|
+
*/
|
|
60
|
+
get capabilities() {
|
|
61
|
+
return this.aggregators.map((a) => ({
|
|
62
|
+
id: a.id,
|
|
63
|
+
aggregationType: a.aggregationType,
|
|
64
|
+
supportedSuites: a.supportedSuites
|
|
65
|
+
}));
|
|
66
|
+
}
|
|
67
|
+
};
|
|
68
|
+
AggregatorRegistry = __decorate([
|
|
69
|
+
injectable(),
|
|
70
|
+
__decorateParam(0, injectAll(AggregatorToken)),
|
|
71
|
+
__decorateMetadata("design:paramtypes", [Array])
|
|
72
|
+
], AggregatorRegistry);
|
|
73
|
+
|
|
74
|
+
//#endregion
|
|
75
|
+
export { AggregatorRegistry, AggregatorToken };
|
|
76
|
+
//# sourceMappingURL=AggregatorRegistry.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AggregatorRegistry.mjs","names":[],"sources":["../../../src/registry/aggregators/AggregatorRegistry.ts"],"sourcesContent":["import type { Aggregator } from './Aggregator'\nimport type { AggregatorCapability } from '../../models'\n\nimport { CredoError, injectable, injectAll } from '@credo-ts/core'\n\nexport const AggregatorToken = Symbol('AggregatorToken')\n\n/**\n * Registry for aggregator modules\n *\n * Uses dependency injection to allow pluggable aggregators.\n * Aggregators can be registered by adding them to the module config.\n */\n@injectable()\nexport class AggregatorRegistry {\n private aggregators: Aggregator[]\n\n public constructor(@injectAll(AggregatorToken) aggregators: Array<Aggregator | 'default'>) {\n // Filter out the 'default' placeholder used for tsyringe\n this.aggregators = aggregators.filter((a): a is Aggregator => a !== 'default')\n }\n\n /**\n * Get aggregator by ID\n *\n * @param id - Aggregator ID (e.g., \"math-aggregate@1\")\n * @throws {CredoError} if not found\n */\n public getById(id: string): Aggregator {\n const aggregator = this.aggregators.find((a) => a.id === id)\n\n if (!aggregator) {\n throw new CredoError(`Aggregator not found: ${id}. Available: ${this.supportedIds.join(', ')}`)\n }\n\n return aggregator\n }\n\n /**\n * Get all aggregators that support a suite\n *\n * @param suiteId - Suite ID to search for\n * @returns Array of matching aggregators\n */\n public getBySuite(suiteId: string): Aggregator[] {\n return this.aggregators.filter(\n (a) => a.supportedSuites.includes('*') || a.supportedSuites.includes(suiteId)\n )\n }\n\n /**\n * Get aggregators by type\n *\n * @param type - Aggregation type\n * @returns Array of aggregators\n */\n public getByType(type: 'none' | 'math' | 'contract' | 'bundle'): Aggregator[] {\n return this.aggregators.filter((a) => a.aggregationType === type)\n }\n\n /**\n * Check if an aggregator is supported\n *\n * @param id - Aggregator ID\n * @returns True if supported\n */\n public isSupported(id: string): boolean {\n return this.aggregators.some((a) => a.id === id)\n }\n\n /**\n * Get all supported aggregator IDs\n */\n public get supportedIds(): string[] {\n return this.aggregators.map((a) => a.id)\n }\n\n /**\n * Get capabilities for proposal/negotiation\n */\n public get capabilities(): AggregatorCapability[] {\n return this.aggregators.map((a) => ({\n id: a.id,\n aggregationType: a.aggregationType,\n supportedSuites: a.supportedSuites,\n }))\n }\n}\n"],"mappings":";;;;;;;AAKA,MAAa,kBAAkB,OAAO,kBAAkB;AASjD,+BAAM,mBAAmB;CAG9B,AAAO,YAAY,AAA4B,aAA4C;AAEzF,OAAK,cAAc,YAAY,QAAQ,MAAuB,MAAM,UAAU;;;;;;;;CAShF,AAAO,QAAQ,IAAwB;EACrC,MAAM,aAAa,KAAK,YAAY,MAAM,MAAM,EAAE,OAAO,GAAG;AAE5D,MAAI,CAAC,WACH,OAAM,IAAI,WAAW,yBAAyB,GAAG,eAAe,KAAK,aAAa,KAAK,KAAK,GAAG;AAGjG,SAAO;;;;;;;;CAST,AAAO,WAAW,SAA+B;AAC/C,SAAO,KAAK,YAAY,QACrB,MAAM,EAAE,gBAAgB,SAAS,IAAI,IAAI,EAAE,gBAAgB,SAAS,QAAQ,CAC9E;;;;;;;;CASH,AAAO,UAAU,MAA6D;AAC5E,SAAO,KAAK,YAAY,QAAQ,MAAM,EAAE,oBAAoB,KAAK;;;;;;;;CASnE,AAAO,YAAY,IAAqB;AACtC,SAAO,KAAK,YAAY,MAAM,MAAM,EAAE,OAAO,GAAG;;;;;CAMlD,IAAW,eAAyB;AAClC,SAAO,KAAK,YAAY,KAAK,MAAM,EAAE,GAAG;;;;;CAM1C,IAAW,eAAuC;AAChD,SAAO,KAAK,YAAY,KAAK,OAAO;GAClC,IAAI,EAAE;GACN,iBAAiB,EAAE;GACnB,iBAAiB,EAAE;GACpB,EAAE;;;;CAxEN,YAAY;oBAIS,UAAU,gBAAgB"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { AggregationResult } from "../../models/AggregationResult.mjs";
|
|
2
|
+
import "../../models/index.mjs";
|
|
3
|
+
import { AggregateInput, Aggregator } from "./Aggregator.mjs";
|
|
4
|
+
import { AgentContext } from "@credo-ts/core";
|
|
5
|
+
|
|
6
|
+
//#region src/registry/aggregators/BundleNoneAggregator.d.ts
|
|
7
|
+
/**
|
|
8
|
+
* Bundle-None Aggregator
|
|
9
|
+
*
|
|
10
|
+
* Simple aggregator that bundles multiple signatures without cryptographic aggregation.
|
|
11
|
+
* Each signature is independently verifiable. This is the simplest multi-signature approach.
|
|
12
|
+
*
|
|
13
|
+
* Use cases:
|
|
14
|
+
* - Multiple independent signers
|
|
15
|
+
* - No cryptographic aggregation needed
|
|
16
|
+
* - Each signature must be individually verifiable
|
|
17
|
+
*/
|
|
18
|
+
declare class BundleNoneAggregator implements Aggregator {
|
|
19
|
+
readonly id = "bundle-none@1";
|
|
20
|
+
readonly version = 1;
|
|
21
|
+
readonly name = "bundle-none";
|
|
22
|
+
readonly aggregationType: "bundle";
|
|
23
|
+
readonly supportedSuites: string[];
|
|
24
|
+
/**
|
|
25
|
+
* Aggregate signatures by bundling them into an array
|
|
26
|
+
*/
|
|
27
|
+
aggregate(_agentContext: AgentContext, input: AggregateInput): Promise<AggregationResult>;
|
|
28
|
+
/**
|
|
29
|
+
* Check if aggregation can be performed
|
|
30
|
+
*/
|
|
31
|
+
canAggregate(partialSignatures: any[], _session: any): Promise<boolean>;
|
|
32
|
+
/**
|
|
33
|
+
* Verify aggregated signature by checking each individual signature
|
|
34
|
+
*/
|
|
35
|
+
verify(data: Uint8Array, aggregatedSignature: string, verifier: (data: Uint8Array, signature: string, keyId: string) => Promise<boolean>, _parameters?: Record<string, unknown>): Promise<boolean>;
|
|
36
|
+
/**
|
|
37
|
+
* Check if aggregation method is supported
|
|
38
|
+
*/
|
|
39
|
+
supportsMethod(method: string): boolean;
|
|
40
|
+
}
|
|
41
|
+
//#endregion
|
|
42
|
+
export { BundleNoneAggregator };
|
|
43
|
+
//# sourceMappingURL=BundleNoneAggregator.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BundleNoneAggregator.d.mts","names":[],"sources":["../../../src/registry/aggregators/BundleNoneAggregator.ts"],"mappings":";;;;;;;;;AAiBA;;;;;;;;cACa,oBAAA,YAAgC,UAAA;EAAA,SAC3B,EAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,eAAA;EAAA,SACA,eAAA;EALqC;;;EAUxC,SAAA,CAAU,aAAA,EAAe,YAAA,EAAc,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,iBAAA;EARpE;;;EA+BH,YAAA,CAAa,iBAAA,SAA0B,QAAA,QAAgB,OAAA;EAvBvD;;;EA8BA,MAAA,CACX,IAAA,EAAM,UAAA,EACN,mBAAA,UACA,QAAA,GAAW,IAAA,EAAM,UAAA,EAAY,SAAA,UAAmB,KAAA,aAAkB,OAAA,WAClE,WAAA,GAAc,MAAA,oBACb,OAAA;EAnCiD;;;EAsE7C,cAAA,CAAe,MAAA;AAAA"}
|