@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,186 @@
|
|
|
1
|
+
//#region src/models/RouterAttestation.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Router Attestation for Group Messaging Protocol
|
|
4
|
+
*
|
|
5
|
+
* Per Group Messaging Protocol v1.0 spec (Section 5):
|
|
6
|
+
* "Router attestation: `route-advertise` MUST carry a signed attestation
|
|
7
|
+
* from the router DID (optionally co-signed by admin)."
|
|
8
|
+
*
|
|
9
|
+
* Purpose:
|
|
10
|
+
* - Routers register a reach set with the Host
|
|
11
|
+
* - Attestation proves router identity and authorization
|
|
12
|
+
* - Prevents unauthorized routers from joining the mesh
|
|
13
|
+
*
|
|
14
|
+
* Security Properties:
|
|
15
|
+
* - Router identity binding via DID signature
|
|
16
|
+
* - Room-specific authorization
|
|
17
|
+
* - Time-bounded validity (expiry)
|
|
18
|
+
* - Policy hash binding (optional)
|
|
19
|
+
* - Admin co-signature support (optional)
|
|
20
|
+
*
|
|
21
|
+
* Spec Reference: group.md Lines 173-195
|
|
22
|
+
*/
|
|
23
|
+
/**
|
|
24
|
+
* Router Attestation - Signed claim from router
|
|
25
|
+
*
|
|
26
|
+
* Attests that a router is authorized to relay messages for a room
|
|
27
|
+
* to a specific reach set of DIDs.
|
|
28
|
+
*/
|
|
29
|
+
interface RouterAttestation {
|
|
30
|
+
/**
|
|
31
|
+
* Signed content
|
|
32
|
+
*/
|
|
33
|
+
signed: RouterAttestationClaim;
|
|
34
|
+
/**
|
|
35
|
+
* Signature from router DID (JWS format)
|
|
36
|
+
*/
|
|
37
|
+
sig: string;
|
|
38
|
+
/**
|
|
39
|
+
* Optional admin co-signature for additional authorization
|
|
40
|
+
* (For deployments requiring admin approval of routers)
|
|
41
|
+
*/
|
|
42
|
+
admin_sig?: string;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Router Attestation Claim - Content that gets signed
|
|
46
|
+
*/
|
|
47
|
+
interface RouterAttestationClaim {
|
|
48
|
+
/**
|
|
49
|
+
* Router DID making the attestation
|
|
50
|
+
*/
|
|
51
|
+
router: string;
|
|
52
|
+
/**
|
|
53
|
+
* Room DID this attestation is for
|
|
54
|
+
*/
|
|
55
|
+
room_did: string;
|
|
56
|
+
/**
|
|
57
|
+
* Reach set - DIDs this router can reach
|
|
58
|
+
*
|
|
59
|
+
* Router advertises it can relay to this set of member DIDs.
|
|
60
|
+
* Host uses this to decide which routers to use for fan-out.
|
|
61
|
+
*/
|
|
62
|
+
reach: string[];
|
|
63
|
+
/**
|
|
64
|
+
* Expiry timestamp (ISO 8601)
|
|
65
|
+
*
|
|
66
|
+
* Attestation expires after this time.
|
|
67
|
+
* Typical validity: 24 hours to 7 days.
|
|
68
|
+
*/
|
|
69
|
+
exp: string;
|
|
70
|
+
/**
|
|
71
|
+
* Policy hash (optional)
|
|
72
|
+
*
|
|
73
|
+
* Hash of room policy document that router agrees to follow.
|
|
74
|
+
* Format: "sha-256:base64..."
|
|
75
|
+
*/
|
|
76
|
+
policy_hash?: string;
|
|
77
|
+
/**
|
|
78
|
+
* Nonce for replay protection (optional)
|
|
79
|
+
*/
|
|
80
|
+
nonce?: string;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Options for creating a router attestation
|
|
84
|
+
*/
|
|
85
|
+
interface CreateRouterAttestationOptions {
|
|
86
|
+
/**
|
|
87
|
+
* Router DID signing the attestation
|
|
88
|
+
*/
|
|
89
|
+
routerDid: string;
|
|
90
|
+
/**
|
|
91
|
+
* Room DID
|
|
92
|
+
*/
|
|
93
|
+
roomDid: string;
|
|
94
|
+
/**
|
|
95
|
+
* Reach set - DIDs this router can reach
|
|
96
|
+
*/
|
|
97
|
+
reach: string[];
|
|
98
|
+
/**
|
|
99
|
+
* Expiry duration in seconds (default: 24 hours)
|
|
100
|
+
*/
|
|
101
|
+
expiresIn?: number;
|
|
102
|
+
/**
|
|
103
|
+
* Policy hash (optional)
|
|
104
|
+
*/
|
|
105
|
+
policyHash?: string;
|
|
106
|
+
/**
|
|
107
|
+
* Nonce (optional, for replay protection)
|
|
108
|
+
*/
|
|
109
|
+
nonce?: string;
|
|
110
|
+
/**
|
|
111
|
+
* Admin DIDs for co-signature (optional)
|
|
112
|
+
*
|
|
113
|
+
* If provided, will create an admin signature in addition to router signature.
|
|
114
|
+
* Useful for deployments requiring admin approval of routers.
|
|
115
|
+
*/
|
|
116
|
+
adminDids?: string[];
|
|
117
|
+
/**
|
|
118
|
+
* Admin signature threshold (for multi-admin)
|
|
119
|
+
*/
|
|
120
|
+
adminThreshold?: number;
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Options for verifying a router attestation
|
|
124
|
+
*/
|
|
125
|
+
interface VerifyRouterAttestationOptions {
|
|
126
|
+
/**
|
|
127
|
+
* Room DID to verify against
|
|
128
|
+
*/
|
|
129
|
+
roomDid: string;
|
|
130
|
+
/**
|
|
131
|
+
* Expected router DID (optional)
|
|
132
|
+
*/
|
|
133
|
+
expectedRouter?: string;
|
|
134
|
+
/**
|
|
135
|
+
* Enforce expiry check
|
|
136
|
+
*/
|
|
137
|
+
enforceExpiry?: boolean;
|
|
138
|
+
/**
|
|
139
|
+
* Allowed routers list (if not provided, any router is allowed)
|
|
140
|
+
*/
|
|
141
|
+
allowedRouters?: string[];
|
|
142
|
+
/**
|
|
143
|
+
* Authorized admins (for co-signature verification)
|
|
144
|
+
*/
|
|
145
|
+
authorizedAdmins?: string[];
|
|
146
|
+
/**
|
|
147
|
+
* Require admin co-signature
|
|
148
|
+
*/
|
|
149
|
+
requireAdminSignature?: boolean;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Router attestation verification result
|
|
153
|
+
*/
|
|
154
|
+
interface RouterAttestationVerificationResult {
|
|
155
|
+
/**
|
|
156
|
+
* Whether attestation is valid
|
|
157
|
+
*/
|
|
158
|
+
valid: boolean;
|
|
159
|
+
/**
|
|
160
|
+
* Reason for invalidity
|
|
161
|
+
*/
|
|
162
|
+
reason?: string;
|
|
163
|
+
/**
|
|
164
|
+
* Verified router DID
|
|
165
|
+
*/
|
|
166
|
+
routerDid?: string;
|
|
167
|
+
/**
|
|
168
|
+
* Verified reach set
|
|
169
|
+
*/
|
|
170
|
+
reach?: string[];
|
|
171
|
+
/**
|
|
172
|
+
* Admin signature verification result (if present)
|
|
173
|
+
*/
|
|
174
|
+
adminSignatureValid?: boolean;
|
|
175
|
+
/**
|
|
176
|
+
* Metadata
|
|
177
|
+
*/
|
|
178
|
+
metadata?: {
|
|
179
|
+
expired: boolean;
|
|
180
|
+
expiryDate: string;
|
|
181
|
+
policyHash?: string;
|
|
182
|
+
};
|
|
183
|
+
}
|
|
184
|
+
//#endregion
|
|
185
|
+
export { CreateRouterAttestationOptions, RouterAttestation, RouterAttestationClaim, RouterAttestationVerificationResult, VerifyRouterAttestationOptions };
|
|
186
|
+
//# sourceMappingURL=RouterAttestation.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RouterAttestation.d.mts","names":[],"sources":["../../src/models/RouterAttestation.ts"],"mappings":";;AA4BA;;;;;;;;;;AAqBA;;;;;;;;;;;;AA4CA;;;;UAjEiB,iBAAA;EA0Ef;;;EAtEA,MAAA,EAAQ,sBAAA;EA0FR;;;EArFA,GAAA;EAkGc;AAMhB;;;EAlGE,SAAA;AAAA;;;;UAMe,sBAAA;EAyHf;;;EArHA,MAAA;EA2HkD;;;EAtHlD,QAAA;EA+HA;;;;;;EAvHA,KAAA;EA8IE;;;;;;EAtIF,GAAA;;;;;;;EAQA,WAAA;;;;EAKA,KAAA;AAAA;;;;UAMe,8BAAA;;;;EAIf,SAAA;;;;EAKA,OAAA;;;;EAKA,KAAA;;;;EAKA,SAAA;;;;EAKA,UAAA;;;;EAKA,KAAA;;;;;;;EAQA,SAAA;;;;EAKA,cAAA;AAAA;;;;UAMe,8BAAA;;;;EAIf,OAAA;;;;EAKA,cAAA;;;;EAKA,aAAA;;;;EAKA,cAAA;;;;EAKA,gBAAA;;;;EAKA,qBAAA;AAAA;;;;UAMe,mCAAA;;;;EAIf,KAAA;;;;EAKA,MAAA;;;;EAKA,SAAA;;;;EAKA,KAAA;;;;EAKA,mBAAA;;;;EAKA,QAAA;IACE,OAAA;IACA,UAAA;IACA,UAAA;EAAA;AAAA"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
//#region src/models/Session.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Session mode type
|
|
4
|
+
*/
|
|
5
|
+
declare enum SessionMode {
|
|
6
|
+
/**
|
|
7
|
+
* Single signer session
|
|
8
|
+
*/
|
|
9
|
+
Single = "single",
|
|
10
|
+
/**
|
|
11
|
+
* Threshold multi-signature session (N-of-M)
|
|
12
|
+
*/
|
|
13
|
+
Threshold = "threshold"
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Threshold configuration for multi-signature sessions
|
|
17
|
+
*/
|
|
18
|
+
interface ThresholdConfig {
|
|
19
|
+
/**
|
|
20
|
+
* Threshold scheme
|
|
21
|
+
* @example "n-of-m", "weighted"
|
|
22
|
+
*/
|
|
23
|
+
scheme: string;
|
|
24
|
+
/**
|
|
25
|
+
* Number of required signatures
|
|
26
|
+
*/
|
|
27
|
+
n: number;
|
|
28
|
+
/**
|
|
29
|
+
* Total number of potential signers
|
|
30
|
+
*/
|
|
31
|
+
m: number;
|
|
32
|
+
/**
|
|
33
|
+
* List of signer DIDs
|
|
34
|
+
*/
|
|
35
|
+
signers: string[];
|
|
36
|
+
/**
|
|
37
|
+
* Aggregation method
|
|
38
|
+
* @example "none" (simple collection), "math" (crypto aggregation), "contract" (on-chain)
|
|
39
|
+
*/
|
|
40
|
+
aggregation: string;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Session configuration for a signing request
|
|
44
|
+
*/
|
|
45
|
+
interface Session {
|
|
46
|
+
/**
|
|
47
|
+
* Unique session identifier
|
|
48
|
+
* @example "sess_b5f1..."
|
|
49
|
+
*/
|
|
50
|
+
sessionId: string;
|
|
51
|
+
/**
|
|
52
|
+
* Session mode (single or threshold)
|
|
53
|
+
*/
|
|
54
|
+
mode: SessionMode;
|
|
55
|
+
/**
|
|
56
|
+
* Threshold configuration (required for threshold mode)
|
|
57
|
+
*/
|
|
58
|
+
threshold?: ThresholdConfig;
|
|
59
|
+
}
|
|
60
|
+
//#endregion
|
|
61
|
+
export { Session, SessionMode, ThresholdConfig };
|
|
62
|
+
//# sourceMappingURL=Session.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Session.d.mts","names":[],"sources":["../../src/models/Session.ts"],"mappings":";;AAGA;;aAAY,WAAA;EAIV;;AAWF;EAXE,MAAA;;;;EAKA,SAAA;AAAA;;;;UAMe,eAAA;EAgCA;;;;EA3Bf,MAAA;EAqCA;;;EAhCA,CAAA;EAqC2B;;;EAhC3B,CAAA;;;;EAKA,OAAA;;;;;EAMA,WAAA;AAAA;;;;UAMe,OAAA;;;;;EAKf,SAAA;;;;EAKA,IAAA,EAAM,WAAA;;;;EAKN,SAAA,GAAY,eAAA;AAAA"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
//#region src/models/Session.ts
|
|
2
|
+
/**
|
|
3
|
+
* Session mode type
|
|
4
|
+
*/
|
|
5
|
+
let SessionMode = /* @__PURE__ */ function(SessionMode) {
|
|
6
|
+
/**
|
|
7
|
+
* Single signer session
|
|
8
|
+
*/
|
|
9
|
+
SessionMode["Single"] = "single";
|
|
10
|
+
/**
|
|
11
|
+
* Threshold multi-signature session (N-of-M)
|
|
12
|
+
*/
|
|
13
|
+
SessionMode["Threshold"] = "threshold";
|
|
14
|
+
return SessionMode;
|
|
15
|
+
}({});
|
|
16
|
+
|
|
17
|
+
//#endregion
|
|
18
|
+
export { SessionMode };
|
|
19
|
+
//# sourceMappingURL=Session.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Session.mjs","names":[],"sources":["../../src/models/Session.ts"],"sourcesContent":["/**\n * Session mode type\n */\nexport enum SessionMode {\n /**\n * Single signer session\n */\n Single = 'single',\n\n /**\n * Threshold multi-signature session (N-of-M)\n */\n Threshold = 'threshold',\n}\n\n/**\n * Threshold configuration for multi-signature sessions\n */\nexport interface ThresholdConfig {\n /**\n * Threshold scheme\n * @example \"n-of-m\", \"weighted\"\n */\n scheme: string\n\n /**\n * Number of required signatures\n */\n n: number\n\n /**\n * Total number of potential signers\n */\n m: number\n\n /**\n * List of signer DIDs\n */\n signers: string[]\n\n /**\n * Aggregation method\n * @example \"none\" (simple collection), \"math\" (crypto aggregation), \"contract\" (on-chain)\n */\n aggregation: string\n}\n\n/**\n * Session configuration for a signing request\n */\nexport interface Session {\n /**\n * Unique session identifier\n * @example \"sess_b5f1...\"\n */\n sessionId: string\n\n /**\n * Session mode (single or threshold)\n */\n mode: SessionMode\n\n /**\n * Threshold configuration (required for threshold mode)\n */\n threshold?: ThresholdConfig\n}\n"],"mappings":";;;;AAGA,IAAY,oDAAL;;;;AAIL;;;;AAKA"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
//#region src/models/SignableObject.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Describes what is being signed (WYSIWYS core)
|
|
4
|
+
*
|
|
5
|
+
* The SignableObject contains all information needed to understand
|
|
6
|
+
* what data is being signed, how it should be canonicalized, and
|
|
7
|
+
* its cryptographic digest for verification.
|
|
8
|
+
*/
|
|
9
|
+
interface SignableObject {
|
|
10
|
+
/**
|
|
11
|
+
* Unique identifier for this signable object
|
|
12
|
+
* @example "so_7c9b..."
|
|
13
|
+
*/
|
|
14
|
+
id: string;
|
|
15
|
+
/**
|
|
16
|
+
* Media type of the content
|
|
17
|
+
* @example "application/pdf", "application/eip-712", "application/json"
|
|
18
|
+
*/
|
|
19
|
+
mediaType: string;
|
|
20
|
+
/**
|
|
21
|
+
* Canonicalization configuration
|
|
22
|
+
*/
|
|
23
|
+
canonicalization: {
|
|
24
|
+
/**
|
|
25
|
+
* Canonicalization method identifier with version
|
|
26
|
+
* @example "eip-712@1", "pdf-incremental-update@1", "raw-bytes@1"
|
|
27
|
+
*/
|
|
28
|
+
method: string;
|
|
29
|
+
/**
|
|
30
|
+
* Method-specific parameters
|
|
31
|
+
* For EIP-712: { domain, types, message }
|
|
32
|
+
* For PDF: { byteRange }
|
|
33
|
+
*/
|
|
34
|
+
parameters?: Record<string, unknown>;
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* Cryptographic digest over canonical bytes
|
|
38
|
+
*/
|
|
39
|
+
digest: {
|
|
40
|
+
/**
|
|
41
|
+
* Hash algorithm used
|
|
42
|
+
* @example "sha-256", "keccak-256", "sha-512"
|
|
43
|
+
*/
|
|
44
|
+
alg: string;
|
|
45
|
+
/**
|
|
46
|
+
* Base64-encoded hash value
|
|
47
|
+
*/
|
|
48
|
+
value: string;
|
|
49
|
+
};
|
|
50
|
+
/**
|
|
51
|
+
* Display hints for human-readable presentation
|
|
52
|
+
*/
|
|
53
|
+
displayHints?: {
|
|
54
|
+
/**
|
|
55
|
+
* Human-readable title
|
|
56
|
+
* @example "NDA Agreement v3.1"
|
|
57
|
+
*/
|
|
58
|
+
title?: string;
|
|
59
|
+
/**
|
|
60
|
+
* Brief summary of contents
|
|
61
|
+
*/
|
|
62
|
+
summary?: string;
|
|
63
|
+
/**
|
|
64
|
+
* Links to preview the content
|
|
65
|
+
*/
|
|
66
|
+
previewLinks?: string[];
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
//#endregion
|
|
70
|
+
export { SignableObject };
|
|
71
|
+
//# sourceMappingURL=SignableObject.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SignableObject.d.mts","names":[],"sources":["../../src/models/SignableObject.ts"],"mappings":";;AAOA;;;;;;UAAiB,cAAA;EAqBb;;;;EAhBF,EAAA;EAuCE;;;;EAjCF,SAAA;EAsDc;;;EAjDd,gBAAA;;;;;IAKE,MAAA;;;;;;IAOA,UAAA,GAAa,MAAA;EAAA;;;;EAMf,MAAA;;;;;IAKE,GAAA;;;;IAKA,KAAA;EAAA;;;;EAMF,YAAA;;;;;IAKE,KAAA;;;;IAKA,OAAA;;;;IAKA,YAAA;EAAA;AAAA"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
//#region src/models/SigningState.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* State machine states for the signing protocol lifecycle
|
|
4
|
+
*/
|
|
5
|
+
declare enum SigningState {
|
|
6
|
+
ProposalSent = "proposal-sent",
|
|
7
|
+
ProposalReceived = "proposal-received",
|
|
8
|
+
RequestSent = "request-sent",
|
|
9
|
+
RequestReceived = "request-received",
|
|
10
|
+
ConsentSent = "consent-sent",
|
|
11
|
+
ConsentReceived = "consent-received",
|
|
12
|
+
PartialSignatureReceived = "partial-signature-received",
|
|
13
|
+
Combining = "combining",
|
|
14
|
+
ArtifactsProvided = "artifacts-provided",
|
|
15
|
+
Completed = "completed",
|
|
16
|
+
Declined = "declined",
|
|
17
|
+
Abandoned = "abandoned"
|
|
18
|
+
}
|
|
19
|
+
//#endregion
|
|
20
|
+
export { SigningState };
|
|
21
|
+
//# sourceMappingURL=SigningState.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SigningState.d.mts","names":[],"sources":["../../src/models/SigningState.ts"],"mappings":";;AAGA;;aAAY,YAAA;EAEV,YAAA;EACA,gBAAA;EAGA,WAAA;EACA,eAAA;EAGA,WAAA;EACA,eAAA;EAGA,wBAAA;EAGA,SAAA;EACA,iBAAA;EAGA,SAAA;EACA,QAAA;EACA,SAAA;AAAA"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
//#region src/models/SigningState.ts
|
|
2
|
+
/**
|
|
3
|
+
* State machine states for the signing protocol lifecycle
|
|
4
|
+
*/
|
|
5
|
+
let SigningState = /* @__PURE__ */ function(SigningState) {
|
|
6
|
+
SigningState["ProposalSent"] = "proposal-sent";
|
|
7
|
+
SigningState["ProposalReceived"] = "proposal-received";
|
|
8
|
+
SigningState["RequestSent"] = "request-sent";
|
|
9
|
+
SigningState["RequestReceived"] = "request-received";
|
|
10
|
+
SigningState["ConsentSent"] = "consent-sent";
|
|
11
|
+
SigningState["ConsentReceived"] = "consent-received";
|
|
12
|
+
SigningState["PartialSignatureReceived"] = "partial-signature-received";
|
|
13
|
+
SigningState["Combining"] = "combining";
|
|
14
|
+
SigningState["ArtifactsProvided"] = "artifacts-provided";
|
|
15
|
+
SigningState["Completed"] = "completed";
|
|
16
|
+
SigningState["Declined"] = "declined";
|
|
17
|
+
SigningState["Abandoned"] = "abandoned";
|
|
18
|
+
return SigningState;
|
|
19
|
+
}({});
|
|
20
|
+
|
|
21
|
+
//#endregion
|
|
22
|
+
export { SigningState };
|
|
23
|
+
//# sourceMappingURL=SigningState.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SigningState.mjs","names":[],"sources":["../../src/models/SigningState.ts"],"sourcesContent":["/**\n * State machine states for the signing protocol lifecycle\n */\nexport enum SigningState {\n // Proposal phase\n ProposalSent = 'proposal-sent',\n ProposalReceived = 'proposal-received',\n\n // Request phase\n RequestSent = 'request-sent',\n RequestReceived = 'request-received',\n\n // Consent phase\n ConsentSent = 'consent-sent',\n ConsentReceived = 'consent-received',\n\n // Signing phase\n PartialSignatureReceived = 'partial-signature-received',\n\n // Aggregation phase\n Combining = 'combining',\n ArtifactsProvided = 'artifacts-provided',\n\n // Terminal states\n Completed = 'completed',\n Declined = 'declined',\n Abandoned = 'abandoned',\n}\n"],"mappings":";;;;AAGA,IAAY,sDAAL;AAEL;AACA;AAGA;AACA;AAGA;AACA;AAGA;AAGA;AACA;AAGA;AACA;AACA"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
//#region src/models/Suite.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Suite configuration with key binding and constraints
|
|
4
|
+
*/
|
|
5
|
+
interface SuiteConfig {
|
|
6
|
+
/**
|
|
7
|
+
* Signature suite identifier with version
|
|
8
|
+
* @example "evm-eip712@1", "jws-ed25519@1", "pades-b-lta@1"
|
|
9
|
+
*/
|
|
10
|
+
suite: string;
|
|
11
|
+
/**
|
|
12
|
+
* Key binding information
|
|
13
|
+
*/
|
|
14
|
+
keyBinding: {
|
|
15
|
+
/**
|
|
16
|
+
* DID controller/key identifier
|
|
17
|
+
* @example "did:ex:signer#key-1", "eip155:1:0xAbC..."
|
|
18
|
+
*/
|
|
19
|
+
controller: string;
|
|
20
|
+
/**
|
|
21
|
+
* Proof purpose
|
|
22
|
+
* @example "assertionMethod", "authentication"
|
|
23
|
+
*/
|
|
24
|
+
proofPurpose: string;
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* Optional constraints for signature validity
|
|
28
|
+
*/
|
|
29
|
+
constraints?: SuiteConstraints;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Constraints for signature validity
|
|
33
|
+
*/
|
|
34
|
+
interface SuiteConstraints {
|
|
35
|
+
/**
|
|
36
|
+
* Not valid before this time (ISO 8601)
|
|
37
|
+
*/
|
|
38
|
+
notBefore?: string;
|
|
39
|
+
/**
|
|
40
|
+
* Expires after this time (ISO 8601)
|
|
41
|
+
*/
|
|
42
|
+
expiresTime?: string;
|
|
43
|
+
/**
|
|
44
|
+
* Intended audience(s) for this signature
|
|
45
|
+
*/
|
|
46
|
+
intendedAudience?: string[];
|
|
47
|
+
/**
|
|
48
|
+
* Maximum number of times this signature can be used
|
|
49
|
+
* @example 1 for single-use signatures
|
|
50
|
+
*/
|
|
51
|
+
useLimit?: number;
|
|
52
|
+
/**
|
|
53
|
+
* URI to policy document
|
|
54
|
+
*/
|
|
55
|
+
policyUri?: string;
|
|
56
|
+
}
|
|
57
|
+
//#endregion
|
|
58
|
+
export { SuiteConfig, SuiteConstraints };
|
|
59
|
+
//# sourceMappingURL=Suite.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Suite.d.mts","names":[],"sources":["../../src/models/Suite.ts"],"mappings":";;AAGA;;UAAiB,WAAA;EA2Be;;;;EAtB9B,KAAA;EAsBA;;;EAjBA,UAAA;IAuBe;;;;IAlBb,UAAA;IA2BF;;;;IArBE,YAAA;EAAA;;;;EAMF,WAAA,GAAc,gBAAA;AAAA;;;;UAMC,gBAAA;;;;EAIf,SAAA;;;;EAKA,WAAA;;;;EAKA,gBAAA;;;;;EAMA,QAAA;;;;EAKA,SAAA;AAAA"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { SigningState } from "./SigningState.mjs";
|
|
2
|
+
import { SignableObject } from "./SignableObject.mjs";
|
|
3
|
+
import { Session, SessionMode, ThresholdConfig } from "./Session.mjs";
|
|
4
|
+
import { SuiteConfig, SuiteConstraints } from "./Suite.mjs";
|
|
5
|
+
import { ConsentData, PartialSignature, SignatureResult } from "./PartialSignature.mjs";
|
|
6
|
+
import { AggregationResult, ArtifactData, ArtifactReference } from "./AggregationResult.mjs";
|
|
7
|
+
import { ArtifactMetadata } from "./ArtifactMetadata.mjs";
|
|
8
|
+
import { AggregatorCapability, CanonicalizerCapability, PolicyCapability, SignatureSuiteCapability, SigningCapabilities } from "./Capabilities.mjs";
|
|
9
|
+
import { PolicyContext, PolicyResult } from "./PolicyContext.mjs";
|
|
10
|
+
import { ArtifactItem, AuthzVerificationResult, CreateAuthzArtifactOptions, SigningAuthz, VerifyAuthzArtifactOptions } from "./AuthzArtifact.mjs";
|
|
11
|
+
import { CreateJoinTokenOptions, DEFAULT_HPKE_CONFIG, HPKEConfig, HPKEEnvelope, JoinToken, JoinTokenVerificationResult, SigningTicket, TokenSignature, VerifyJoinTokenOptions } from "./JoinToken.mjs";
|
|
12
|
+
import { CreateRouterAttestationOptions, RouterAttestation, RouterAttestationClaim, RouterAttestationVerificationResult, VerifyRouterAttestationOptions } from "./RouterAttestation.mjs";
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
//#region src/pdf/PdfUtils.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* PDF Utilities for Digital Signatures
|
|
4
|
+
*
|
|
5
|
+
* Provides utilities for preparing PDFs for digital signatures and
|
|
6
|
+
* embedding PKCS#7 signatures into PDF documents.
|
|
7
|
+
*
|
|
8
|
+
* PDF Signature Structure:
|
|
9
|
+
* - Signature is added as an incremental update (appended to PDF)
|
|
10
|
+
* - ByteRange specifies which parts of the PDF are signed
|
|
11
|
+
* - ByteRange = [start1, length1, start2, length2] where the gap between
|
|
12
|
+
* the two ranges is where the signature hexstring is placed
|
|
13
|
+
*
|
|
14
|
+
* @see ISO 32000-2 (PDF 2.0) for signature requirements
|
|
15
|
+
* @see ETSI EN 319 142-1 for PAdES requirements
|
|
16
|
+
*/
|
|
17
|
+
/**
|
|
18
|
+
* Signature placeholder configuration
|
|
19
|
+
*/
|
|
20
|
+
interface SignaturePlaceholderOptions {
|
|
21
|
+
/** Reason for signing */
|
|
22
|
+
reason?: string;
|
|
23
|
+
/** Location of signing */
|
|
24
|
+
location?: string;
|
|
25
|
+
/** Name of signer */
|
|
26
|
+
name?: string;
|
|
27
|
+
/** Contact info */
|
|
28
|
+
contactInfo?: string;
|
|
29
|
+
/** Reserved size for signature in bytes (default: 8192) */
|
|
30
|
+
signatureSize?: number;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Result of preparing a PDF for signing
|
|
34
|
+
*/
|
|
35
|
+
interface PreparedPdfResult {
|
|
36
|
+
/** PDF bytes with signature placeholder */
|
|
37
|
+
pdfBytes: Uint8Array;
|
|
38
|
+
/** Byte range to sign [start1, len1, start2, len2] */
|
|
39
|
+
byteRange: [number, number, number, number];
|
|
40
|
+
/** Offset where signature hex string should be placed */
|
|
41
|
+
signatureOffset: number;
|
|
42
|
+
/** Length of signature placeholder */
|
|
43
|
+
signatureLength: number;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* PKCS#7 signature container options
|
|
47
|
+
*/
|
|
48
|
+
interface Pkcs7Options {
|
|
49
|
+
/** Signer's certificate in PEM format */
|
|
50
|
+
certificate: string;
|
|
51
|
+
/** Signer's private key in PEM format */
|
|
52
|
+
privateKey: string;
|
|
53
|
+
/** Hash algorithm (sha256, sha384, sha512) */
|
|
54
|
+
hashAlgorithm?: 'sha256' | 'sha384' | 'sha512';
|
|
55
|
+
/** Include signing time attribute */
|
|
56
|
+
includeSigningTime?: boolean;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* PDF Utilities class
|
|
60
|
+
*/
|
|
61
|
+
declare class PdfUtils {
|
|
62
|
+
/**
|
|
63
|
+
* Default signature placeholder size (8KB should be sufficient for most certificates)
|
|
64
|
+
*/
|
|
65
|
+
private static readonly DEFAULT_SIGNATURE_SIZE;
|
|
66
|
+
/**
|
|
67
|
+
* ByteRange placeholder - fixed size to avoid byte offset shifts
|
|
68
|
+
* Format: [0000000000 0000000000 0000000000 0000000000]
|
|
69
|
+
*/
|
|
70
|
+
private static readonly BYTE_RANGE_PLACEHOLDER;
|
|
71
|
+
/**
|
|
72
|
+
* Prepare a PDF for signing by adding a signature placeholder
|
|
73
|
+
*
|
|
74
|
+
* This method:
|
|
75
|
+
* 1. Adds a signature dictionary to the PDF
|
|
76
|
+
* 2. Creates a placeholder for the PKCS#7 signature
|
|
77
|
+
* 3. Returns the byte range that needs to be signed
|
|
78
|
+
*
|
|
79
|
+
* @param pdfBytes - Original PDF bytes
|
|
80
|
+
* @param options - Signature placeholder options
|
|
81
|
+
* @returns Prepared PDF with byte range info
|
|
82
|
+
*/
|
|
83
|
+
static preparePdfForSigning(pdfBytes: Uint8Array, options?: SignaturePlaceholderOptions): Promise<PreparedPdfResult>;
|
|
84
|
+
/**
|
|
85
|
+
* Get the bytes to sign from a prepared PDF
|
|
86
|
+
*
|
|
87
|
+
* @param pdfBytes - PDF bytes with signature placeholder
|
|
88
|
+
* @param byteRange - Byte range from preparePdfForSigning
|
|
89
|
+
* @returns Bytes that need to be hashed and signed
|
|
90
|
+
*/
|
|
91
|
+
static getBytesToSign(pdfBytes: Uint8Array, byteRange: [number, number, number, number]): Uint8Array;
|
|
92
|
+
/**
|
|
93
|
+
* Create a PKCS#7 detached signature
|
|
94
|
+
*
|
|
95
|
+
* @param data - Data to sign (the bytes from getBytesToSign)
|
|
96
|
+
* @param options - PKCS#7 options including certificate and private key
|
|
97
|
+
* @returns DER-encoded PKCS#7 signature
|
|
98
|
+
*/
|
|
99
|
+
static createPkcs7Signature(data: Uint8Array, options: Pkcs7Options): Uint8Array;
|
|
100
|
+
/**
|
|
101
|
+
* Embed a signature into a prepared PDF
|
|
102
|
+
*
|
|
103
|
+
* @param pdfBytes - PDF bytes with signature placeholder
|
|
104
|
+
* @param signature - DER-encoded PKCS#7 signature
|
|
105
|
+
* @param signatureOffset - Offset from preparePdfForSigning
|
|
106
|
+
* @param signatureLength - Length from preparePdfForSigning
|
|
107
|
+
* @returns PDF with embedded signature
|
|
108
|
+
*/
|
|
109
|
+
static embedSignature(pdfBytes: Uint8Array, signature: Uint8Array, signatureOffset: number, signatureLength: number): Uint8Array;
|
|
110
|
+
/**
|
|
111
|
+
* Sign a PDF document end-to-end
|
|
112
|
+
*
|
|
113
|
+
* Convenience method that combines all steps:
|
|
114
|
+
* 1. Prepare PDF with signature placeholder
|
|
115
|
+
* 2. Get bytes to sign
|
|
116
|
+
* 3. Create PKCS#7 signature
|
|
117
|
+
* 4. Embed signature
|
|
118
|
+
*
|
|
119
|
+
* @param pdfBytes - Original PDF bytes
|
|
120
|
+
* @param pkcs7Options - Certificate and private key
|
|
121
|
+
* @param placeholderOptions - Optional signature metadata
|
|
122
|
+
* @returns Signed PDF bytes
|
|
123
|
+
*/
|
|
124
|
+
static signPdf(pdfBytes: Uint8Array, pkcs7Options: Pkcs7Options, placeholderOptions?: SignaturePlaceholderOptions): Promise<Uint8Array>;
|
|
125
|
+
/**
|
|
126
|
+
* Verify a PDF signature
|
|
127
|
+
*
|
|
128
|
+
* @param pdfBytes - Signed PDF bytes
|
|
129
|
+
* @returns Verification result
|
|
130
|
+
*/
|
|
131
|
+
static verifyPdfSignature(pdfBytes: Uint8Array): Promise<{
|
|
132
|
+
valid: boolean;
|
|
133
|
+
signerName?: string;
|
|
134
|
+
signingTime?: Date;
|
|
135
|
+
reason?: string;
|
|
136
|
+
error?: string;
|
|
137
|
+
}>;
|
|
138
|
+
/**
|
|
139
|
+
* Extract signature info from a signed PDF
|
|
140
|
+
*
|
|
141
|
+
* @param pdfBytes - Signed PDF bytes
|
|
142
|
+
* @returns Signature information
|
|
143
|
+
*/
|
|
144
|
+
static extractSignatureInfo(pdfBytes: Uint8Array): Promise<{
|
|
145
|
+
hasSig: boolean;
|
|
146
|
+
byteRange?: [number, number, number, number];
|
|
147
|
+
signatureHex?: string;
|
|
148
|
+
signerName?: string;
|
|
149
|
+
reason?: string;
|
|
150
|
+
location?: string;
|
|
151
|
+
signingTime?: string;
|
|
152
|
+
}>;
|
|
153
|
+
/**
|
|
154
|
+
* Format a date for PDF (D:YYYYMMDDHHmmss+HH'mm')
|
|
155
|
+
*/
|
|
156
|
+
private static formatPdfDate;
|
|
157
|
+
}
|
|
158
|
+
//#endregion
|
|
159
|
+
export { PdfUtils, Pkcs7Options, PreparedPdfResult, SignaturePlaceholderOptions };
|
|
160
|
+
//# sourceMappingURL=PdfUtils.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PdfUtils.d.mts","names":[],"sources":["../../src/pdf/PdfUtils.ts"],"mappings":";;AAsBA;;;;;;;;;;;AAgBA;;;;;;UAhBiB,2BAAA;EAsBf;EApBA,MAAA;EAsBe;EApBf,QAAA;EA0Be;EAxBf,IAAA;;EAEA,WAAA;EAwBA;EAtBA,aAAA;AAAA;;;;UAMe,iBAAA;EA4BI;EA1BnB,QAAA,EAAU,UAAA;EAmDE;EAjDZ,SAAA;EAmDW;EAjDX,eAAA;EAkOuC;EAhOvC,eAAA;AAAA;;;;UAMe,YAAA;EAgTZ;EA9SH,WAAA;EAkVgB;EAhVhB,UAAA;EAkVW;EAhVX,aAAA;EAoWiD;EAlWjD,kBAAA;AAAA;;;;cAMW,QAAA;EAIa;;;EAAA,wBAAA,sBAAA;EAqBtB;;;;EAAA,wBAfsB,sBAAA;EAkMV;;;;;;;;;;;;EAAA,OApLM,oBAAA,CAClB,QAAA,EAAU,UAAA,EACV,OAAA,GAAS,2BAAA,GACR,OAAA,CAAQ,iBAAA;EAmQT;;;;;;;EAAA,OAlFY,cAAA,CAAe,QAAA,EAAU,UAAA,EAAY,SAAA,qCAA8C,UAAA;EAyH/F;;;;;;;EAAA,OApGY,oBAAA,CAAqB,IAAA,EAAM,UAAA,EAAY,OAAA,EAAS,YAAA,GAAe,UAAA;EA2H5B;;;;;;;;;EAAA,OA/DnC,cAAA,CACZ,QAAA,EAAU,UAAA,EACV,SAAA,EAAW,UAAA,EACX,eAAA,UACA,eAAA,WACC,UAAA;EA6FgD;;;;;;;;;;;;;;EAAA,OA3D/B,OAAA,CAClB,QAAA,EAAU,UAAA,EACV,YAAA,EAAc,YAAA,EACd,kBAAA,GAAoB,2BAAA,GACnB,OAAA,CAAQ,UAAA;;;;;;;SAoBS,kBAAA,CAAmB,QAAA,EAAU,UAAA,GAAa,OAAA;IAC5D,KAAA;IACA,UAAA;IACA,WAAA,GAAc,IAAA;IACd,MAAA;IACA,KAAA;EAAA;;;;;;;SA8BkB,oBAAA,CAAqB,QAAA,EAAU,UAAA,GAAa,OAAA;IAC9D,MAAA;IACA,SAAA;IACA,YAAA;IACA,UAAA;IACA,MAAA;IACA,QAAA;IACA,WAAA;EAAA;;;;iBAyCa,aAAA;AAAA"}
|