@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.
Files changed (275) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +39 -2
  3. package/build/SigningApi.d.mts +368 -0
  4. package/build/SigningApi.d.mts.map +1 -0
  5. package/build/SigningApi.mjs +516 -0
  6. package/build/SigningApi.mjs.map +1 -0
  7. package/build/SigningEvents.d.mts +71 -0
  8. package/build/SigningEvents.d.mts.map +1 -0
  9. package/build/SigningEvents.mjs +16 -0
  10. package/build/SigningEvents.mjs.map +1 -0
  11. package/build/SigningModule.d.mts +42 -0
  12. package/build/SigningModule.d.mts.map +1 -0
  13. package/build/SigningModule.mjs +91 -0
  14. package/build/SigningModule.mjs.map +1 -0
  15. package/build/SigningRole.d.mts +25 -0
  16. package/build/SigningRole.d.mts.map +1 -0
  17. package/build/SigningRole.mjs +27 -0
  18. package/build/SigningRole.mjs.map +1 -0
  19. package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorate.mjs +10 -0
  20. package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateMetadata.mjs +7 -0
  21. package/build/_virtual/_@oxc-project_runtime@0.112.0/helpers/decorateParam.mjs +9 -0
  22. package/build/compat.d.mts +24 -0
  23. package/build/compat.d.mts.map +1 -0
  24. package/build/compat.mjs +26 -0
  25. package/build/compat.mjs.map +1 -0
  26. package/build/delivery/ArtifactDeliveryStrategy.d.mts +74 -0
  27. package/build/delivery/ArtifactDeliveryStrategy.d.mts.map +1 -0
  28. package/build/delivery/InlineBase64Strategy.d.mts +50 -0
  29. package/build/delivery/InlineBase64Strategy.d.mts.map +1 -0
  30. package/build/delivery/InlineBase64Strategy.mjs +80 -0
  31. package/build/delivery/InlineBase64Strategy.mjs.map +1 -0
  32. package/build/delivery/index.mjs +1 -0
  33. package/build/errors/ArtifactTooLargeError.d.mts +12 -0
  34. package/build/errors/ArtifactTooLargeError.d.mts.map +1 -0
  35. package/build/errors/ArtifactTooLargeError.mjs +15 -0
  36. package/build/errors/ArtifactTooLargeError.mjs.map +1 -0
  37. package/build/errors/DigestMismatchError.d.mts +12 -0
  38. package/build/errors/DigestMismatchError.d.mts.map +1 -0
  39. package/build/errors/DigestMismatchError.mjs +15 -0
  40. package/build/errors/DigestMismatchError.mjs.map +1 -0
  41. package/build/errors/IdempotencyConflictError.d.mts +12 -0
  42. package/build/errors/IdempotencyConflictError.d.mts.map +1 -0
  43. package/build/errors/IdempotencyConflictError.mjs +15 -0
  44. package/build/errors/IdempotencyConflictError.mjs.map +1 -0
  45. package/build/errors/InvalidStateError.d.mts +14 -0
  46. package/build/errors/InvalidStateError.d.mts.map +1 -0
  47. package/build/errors/InvalidStateError.mjs +16 -0
  48. package/build/errors/InvalidStateError.mjs.map +1 -0
  49. package/build/errors/PolicyEnforcementError.d.mts +12 -0
  50. package/build/errors/PolicyEnforcementError.d.mts.map +1 -0
  51. package/build/errors/PolicyEnforcementError.mjs +15 -0
  52. package/build/errors/PolicyEnforcementError.mjs.map +1 -0
  53. package/build/errors/SigningError.d.mts +16 -0
  54. package/build/errors/SigningError.d.mts.map +1 -0
  55. package/build/errors/SigningError.mjs +16 -0
  56. package/build/errors/SigningError.mjs.map +1 -0
  57. package/build/errors/ThresholdNotMetError.d.mts +12 -0
  58. package/build/errors/ThresholdNotMetError.d.mts.map +1 -0
  59. package/build/errors/ThresholdNotMetError.mjs +15 -0
  60. package/build/errors/ThresholdNotMetError.mjs.map +1 -0
  61. package/build/errors/UnsupportedCanonicalizerError.d.mts +12 -0
  62. package/build/errors/UnsupportedCanonicalizerError.d.mts.map +1 -0
  63. package/build/errors/UnsupportedCanonicalizerError.mjs +16 -0
  64. package/build/errors/UnsupportedCanonicalizerError.mjs.map +1 -0
  65. package/build/errors/UnsupportedSuiteError.d.mts +12 -0
  66. package/build/errors/UnsupportedSuiteError.d.mts.map +1 -0
  67. package/build/errors/UnsupportedSuiteError.mjs +16 -0
  68. package/build/errors/UnsupportedSuiteError.mjs.map +1 -0
  69. package/build/errors/index.d.mts +9 -0
  70. package/build/errors/index.mjs +9 -0
  71. package/build/handlers/CombineMessageHandler.d.mts +22 -0
  72. package/build/handlers/CombineMessageHandler.d.mts.map +1 -0
  73. package/build/handlers/CombineMessageHandler.mjs +25 -0
  74. package/build/handlers/CombineMessageHandler.mjs.map +1 -0
  75. package/build/handlers/ConsentMessageHandler.d.mts +19 -0
  76. package/build/handlers/ConsentMessageHandler.d.mts.map +1 -0
  77. package/build/handlers/ConsentMessageHandler.mjs +21 -0
  78. package/build/handlers/ConsentMessageHandler.mjs.map +1 -0
  79. package/build/handlers/DeclineMessageHandler.d.mts +19 -0
  80. package/build/handlers/DeclineMessageHandler.d.mts.map +1 -0
  81. package/build/handlers/DeclineMessageHandler.mjs +21 -0
  82. package/build/handlers/DeclineMessageHandler.mjs.map +1 -0
  83. package/build/handlers/PartialSignatureMessageHandler.d.mts +19 -0
  84. package/build/handlers/PartialSignatureMessageHandler.d.mts.map +1 -0
  85. package/build/handlers/PartialSignatureMessageHandler.mjs +21 -0
  86. package/build/handlers/PartialSignatureMessageHandler.mjs.map +1 -0
  87. package/build/handlers/ProposeSigningMessageHandler.d.mts +19 -0
  88. package/build/handlers/ProposeSigningMessageHandler.d.mts.map +1 -0
  89. package/build/handlers/ProposeSigningMessageHandler.mjs +21 -0
  90. package/build/handlers/ProposeSigningMessageHandler.mjs.map +1 -0
  91. package/build/handlers/ProvideArtifactsMessageHandler.d.mts +19 -0
  92. package/build/handlers/ProvideArtifactsMessageHandler.d.mts.map +1 -0
  93. package/build/handlers/ProvideArtifactsMessageHandler.mjs +21 -0
  94. package/build/handlers/ProvideArtifactsMessageHandler.mjs.map +1 -0
  95. package/build/handlers/RequestSigningMessageHandler.d.mts +19 -0
  96. package/build/handlers/RequestSigningMessageHandler.d.mts.map +1 -0
  97. package/build/handlers/RequestSigningMessageHandler.mjs +21 -0
  98. package/build/handlers/RequestSigningMessageHandler.mjs.map +1 -0
  99. package/build/handlers/SigningAckMessageHandler.d.mts +22 -0
  100. package/build/handlers/SigningAckMessageHandler.d.mts.map +1 -0
  101. package/build/handlers/SigningAckMessageHandler.mjs +25 -0
  102. package/build/handlers/SigningAckMessageHandler.mjs.map +1 -0
  103. package/build/handlers/SigningProblemReportMessageHandler.d.mts +19 -0
  104. package/build/handlers/SigningProblemReportMessageHandler.d.mts.map +1 -0
  105. package/build/handlers/SigningProblemReportMessageHandler.mjs +21 -0
  106. package/build/handlers/SigningProblemReportMessageHandler.mjs.map +1 -0
  107. package/build/handlers/index.d.mts +9 -0
  108. package/build/handlers/index.mjs +9 -0
  109. package/build/index.d.mts +75 -0
  110. package/build/index.mjs +63 -0
  111. package/build/messages/CombineMessage.d.mts +32 -0
  112. package/build/messages/CombineMessage.d.mts.map +1 -0
  113. package/build/messages/CombineMessage.mjs +47 -0
  114. package/build/messages/CombineMessage.mjs.map +1 -0
  115. package/build/messages/ConsentMessage.d.mts +32 -0
  116. package/build/messages/ConsentMessage.d.mts.map +1 -0
  117. package/build/messages/ConsentMessage.mjs +46 -0
  118. package/build/messages/ConsentMessage.mjs.map +1 -0
  119. package/build/messages/DeclineMessage.d.mts +26 -0
  120. package/build/messages/DeclineMessage.d.mts.map +1 -0
  121. package/build/messages/DeclineMessage.mjs +47 -0
  122. package/build/messages/DeclineMessage.mjs.map +1 -0
  123. package/build/messages/PartialSignatureMessage.d.mts +36 -0
  124. package/build/messages/PartialSignatureMessage.d.mts.map +1 -0
  125. package/build/messages/PartialSignatureMessage.mjs +72 -0
  126. package/build/messages/PartialSignatureMessage.mjs.map +1 -0
  127. package/build/messages/ProposeSigningMessage.d.mts +27 -0
  128. package/build/messages/ProposeSigningMessage.d.mts.map +1 -0
  129. package/build/messages/ProposeSigningMessage.mjs +41 -0
  130. package/build/messages/ProposeSigningMessage.mjs.map +1 -0
  131. package/build/messages/ProvideArtifactsMessage.d.mts +62 -0
  132. package/build/messages/ProvideArtifactsMessage.d.mts.map +1 -0
  133. package/build/messages/ProvideArtifactsMessage.mjs +40 -0
  134. package/build/messages/ProvideArtifactsMessage.mjs.map +1 -0
  135. package/build/messages/RequestSigningMessage.d.mts +38 -0
  136. package/build/messages/RequestSigningMessage.d.mts.map +1 -0
  137. package/build/messages/RequestSigningMessage.mjs +62 -0
  138. package/build/messages/RequestSigningMessage.mjs.map +1 -0
  139. package/build/messages/SigningAckMessage.d.mts +26 -0
  140. package/build/messages/SigningAckMessage.d.mts.map +1 -0
  141. package/build/messages/SigningAckMessage.mjs +46 -0
  142. package/build/messages/SigningAckMessage.mjs.map +1 -0
  143. package/build/messages/SigningProblemReportMessage.d.mts +44 -0
  144. package/build/messages/SigningProblemReportMessage.d.mts.map +1 -0
  145. package/build/messages/SigningProblemReportMessage.mjs +65 -0
  146. package/build/messages/SigningProblemReportMessage.mjs.map +1 -0
  147. package/build/messages/index.d.mts +9 -0
  148. package/build/messages/index.mjs +9 -0
  149. package/build/models/AggregationResult.d.mts +85 -0
  150. package/build/models/AggregationResult.d.mts.map +1 -0
  151. package/build/models/ArtifactMetadata.d.mts +37 -0
  152. package/build/models/ArtifactMetadata.d.mts.map +1 -0
  153. package/build/models/AuthzArtifact.d.mts +178 -0
  154. package/build/models/AuthzArtifact.d.mts.map +1 -0
  155. package/build/models/Capabilities.d.mts +109 -0
  156. package/build/models/Capabilities.d.mts.map +1 -0
  157. package/build/models/JoinToken.d.mts +344 -0
  158. package/build/models/JoinToken.d.mts.map +1 -0
  159. package/build/models/JoinToken.mjs +14 -0
  160. package/build/models/JoinToken.mjs.map +1 -0
  161. package/build/models/PartialSignature.d.mts +82 -0
  162. package/build/models/PartialSignature.d.mts.map +1 -0
  163. package/build/models/PolicyContext.d.mts +55 -0
  164. package/build/models/PolicyContext.d.mts.map +1 -0
  165. package/build/models/RouterAttestation.d.mts +186 -0
  166. package/build/models/RouterAttestation.d.mts.map +1 -0
  167. package/build/models/Session.d.mts +62 -0
  168. package/build/models/Session.d.mts.map +1 -0
  169. package/build/models/Session.mjs +19 -0
  170. package/build/models/Session.mjs.map +1 -0
  171. package/build/models/SignableObject.d.mts +71 -0
  172. package/build/models/SignableObject.d.mts.map +1 -0
  173. package/build/models/SigningState.d.mts +21 -0
  174. package/build/models/SigningState.d.mts.map +1 -0
  175. package/build/models/SigningState.mjs +23 -0
  176. package/build/models/SigningState.mjs.map +1 -0
  177. package/build/models/Suite.d.mts +59 -0
  178. package/build/models/Suite.d.mts.map +1 -0
  179. package/build/models/index.d.mts +12 -0
  180. package/build/pdf/PdfUtils.d.mts +160 -0
  181. package/build/pdf/PdfUtils.d.mts.map +1 -0
  182. package/build/pdf/PdfUtils.mjs +283 -0
  183. package/build/pdf/PdfUtils.mjs.map +1 -0
  184. package/build/pdf/index.mjs +1 -0
  185. package/build/registry/aggregators/Aggregator.d.mts +85 -0
  186. package/build/registry/aggregators/Aggregator.d.mts.map +1 -0
  187. package/build/registry/aggregators/AggregatorRegistry.d.mts +55 -0
  188. package/build/registry/aggregators/AggregatorRegistry.d.mts.map +1 -0
  189. package/build/registry/aggregators/AggregatorRegistry.mjs +76 -0
  190. package/build/registry/aggregators/AggregatorRegistry.mjs.map +1 -0
  191. package/build/registry/aggregators/BundleNoneAggregator.d.mts +43 -0
  192. package/build/registry/aggregators/BundleNoneAggregator.d.mts.map +1 -0
  193. package/build/registry/aggregators/BundleNoneAggregator.mjs +65 -0
  194. package/build/registry/aggregators/BundleNoneAggregator.mjs.map +1 -0
  195. package/build/registry/aggregators/index.d.mts +3 -0
  196. package/build/registry/aggregators/index.mjs +2 -0
  197. package/build/registry/canonicalizers/Canonicalizer.d.mts +67 -0
  198. package/build/registry/canonicalizers/Canonicalizer.d.mts.map +1 -0
  199. package/build/registry/canonicalizers/CanonicalizerRegistry.d.mts +55 -0
  200. package/build/registry/canonicalizers/CanonicalizerRegistry.d.mts.map +1 -0
  201. package/build/registry/canonicalizers/CanonicalizerRegistry.mjs +78 -0
  202. package/build/registry/canonicalizers/CanonicalizerRegistry.mjs.map +1 -0
  203. package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.d.mts +126 -0
  204. package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.d.mts.map +1 -0
  205. package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.mjs +143 -0
  206. package/build/registry/canonicalizers/PdfIncrementalUpdateCanonicalizer.mjs.map +1 -0
  207. package/build/registry/canonicalizers/RawBytesCanonicalizer.d.mts +34 -0
  208. package/build/registry/canonicalizers/RawBytesCanonicalizer.d.mts.map +1 -0
  209. package/build/registry/canonicalizers/RawBytesCanonicalizer.mjs +55 -0
  210. package/build/registry/canonicalizers/RawBytesCanonicalizer.mjs.map +1 -0
  211. package/build/registry/canonicalizers/index.d.mts +4 -0
  212. package/build/registry/canonicalizers/index.mjs +3 -0
  213. package/build/registry/index.d.mts +18 -0
  214. package/build/registry/index.mjs +14 -0
  215. package/build/registry/policies/Policy.d.mts +62 -0
  216. package/build/registry/policies/Policy.d.mts.map +1 -0
  217. package/build/registry/policies/PolicyRegistry.d.mts +54 -0
  218. package/build/registry/policies/PolicyRegistry.d.mts.map +1 -0
  219. package/build/registry/policies/PolicyRegistry.mjs +73 -0
  220. package/build/registry/policies/PolicyRegistry.mjs.map +1 -0
  221. package/build/registry/policies/TimeWindowPolicy.d.mts +85 -0
  222. package/build/registry/policies/TimeWindowPolicy.d.mts.map +1 -0
  223. package/build/registry/policies/TimeWindowPolicy.mjs +111 -0
  224. package/build/registry/policies/TimeWindowPolicy.mjs.map +1 -0
  225. package/build/registry/policies/index.d.mts +3 -0
  226. package/build/registry/policies/index.mjs +2 -0
  227. package/build/registry/suites/JwsEd25519Suite.d.mts +47 -0
  228. package/build/registry/suites/JwsEd25519Suite.d.mts.map +1 -0
  229. package/build/registry/suites/JwsEd25519Suite.mjs +101 -0
  230. package/build/registry/suites/JwsEd25519Suite.mjs.map +1 -0
  231. package/build/registry/suites/PadesBLtaSuite.d.mts +106 -0
  232. package/build/registry/suites/PadesBLtaSuite.d.mts.map +1 -0
  233. package/build/registry/suites/PadesBLtaSuite.mjs +122 -0
  234. package/build/registry/suites/PadesBLtaSuite.mjs.map +1 -0
  235. package/build/registry/suites/SignatureSuite.d.mts +128 -0
  236. package/build/registry/suites/SignatureSuite.d.mts.map +1 -0
  237. package/build/registry/suites/SignatureSuiteRegistry.d.mts +62 -0
  238. package/build/registry/suites/SignatureSuiteRegistry.d.mts.map +1 -0
  239. package/build/registry/suites/SignatureSuiteRegistry.mjs +87 -0
  240. package/build/registry/suites/SignatureSuiteRegistry.mjs.map +1 -0
  241. package/build/registry/suites/index.d.mts +4 -0
  242. package/build/registry/suites/index.mjs +3 -0
  243. package/build/repository/CounterRecord.d.mts +84 -0
  244. package/build/repository/CounterRecord.d.mts.map +1 -0
  245. package/build/repository/CounterRecord.mjs +82 -0
  246. package/build/repository/CounterRecord.mjs.map +1 -0
  247. package/build/repository/CounterRepository.d.mts +22 -0
  248. package/build/repository/CounterRepository.d.mts.map +1 -0
  249. package/build/repository/CounterRepository.mjs +51 -0
  250. package/build/repository/CounterRepository.mjs.map +1 -0
  251. package/build/repository/SigningSessionRecord.d.mts +102 -0
  252. package/build/repository/SigningSessionRecord.d.mts.map +1 -0
  253. package/build/repository/SigningSessionRecord.mjs +96 -0
  254. package/build/repository/SigningSessionRecord.mjs.map +1 -0
  255. package/build/repository/SigningSessionRepository.d.mts +30 -0
  256. package/build/repository/SigningSessionRepository.d.mts.map +1 -0
  257. package/build/repository/SigningSessionRepository.mjs +52 -0
  258. package/build/repository/SigningSessionRepository.mjs.map +1 -0
  259. package/build/repository/index.d.mts +4 -0
  260. package/build/repository/index.mjs +4 -0
  261. package/build/services/CounterService.d.mts +121 -0
  262. package/build/services/CounterService.d.mts.map +1 -0
  263. package/build/services/CounterService.mjs +176 -0
  264. package/build/services/CounterService.mjs.map +1 -0
  265. package/build/services/HPKEService.d.mts +174 -0
  266. package/build/services/HPKEService.d.mts.map +1 -0
  267. package/build/services/HPKEService.mjs +195 -0
  268. package/build/services/HPKEService.mjs.map +1 -0
  269. package/build/services/SigningService.d.mts +387 -0
  270. package/build/services/SigningService.d.mts.map +1 -0
  271. package/build/services/SigningService.mjs +1104 -0
  272. package/build/services/SigningService.mjs.map +1 -0
  273. package/build/services/index.d.mts +3 -0
  274. package/build/services/index.mjs +3 -0
  275. 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"}