@parmana/crypto 0.0.0-stage → 0.1.1

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 (209) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +8 -0
  3. package/README.md +16 -2
  4. package/dist/.tsbuildinfo +1 -0
  5. package/dist/ApprovalArtifactCrypto.d.ts +33 -0
  6. package/dist/ApprovalArtifactCrypto.d.ts.map +1 -0
  7. package/dist/ApprovalArtifactCrypto.js +54 -0
  8. package/dist/ApprovalArtifactCrypto.js.map +1 -0
  9. package/dist/ArtifactSigner.d.ts +22 -0
  10. package/dist/ArtifactSigner.d.ts.map +1 -0
  11. package/dist/ArtifactSigner.js +29 -0
  12. package/dist/ArtifactSigner.js.map +1 -0
  13. package/dist/AuditEventCrypto.d.ts +39 -0
  14. package/dist/AuditEventCrypto.d.ts.map +1 -0
  15. package/dist/AuditEventCrypto.js +57 -0
  16. package/dist/AuditEventCrypto.js.map +1 -0
  17. package/dist/AuthorizationSigner.d.ts +56 -0
  18. package/dist/AuthorizationSigner.d.ts.map +1 -0
  19. package/dist/AuthorizationSigner.js +103 -0
  20. package/dist/AuthorizationSigner.js.map +1 -0
  21. package/dist/AuthorizationVerifier.d.ts +53 -0
  22. package/dist/AuthorizationVerifier.d.ts.map +1 -0
  23. package/dist/AuthorizationVerifier.js +66 -0
  24. package/dist/AuthorizationVerifier.js.map +1 -0
  25. package/dist/CallerAuditChainVerifier.d.ts +62 -0
  26. package/dist/CallerAuditChainVerifier.d.ts.map +1 -0
  27. package/dist/CallerAuditChainVerifier.js +97 -0
  28. package/dist/CallerAuditChainVerifier.js.map +1 -0
  29. package/dist/CanonicalSerializer.d.ts +26 -0
  30. package/dist/CanonicalSerializer.d.ts.map +1 -0
  31. package/dist/CanonicalSerializer.js +78 -0
  32. package/dist/CanonicalSerializer.js.map +1 -0
  33. package/dist/CryptoBootstrap.d.ts +27 -0
  34. package/dist/CryptoBootstrap.d.ts.map +1 -0
  35. package/dist/CryptoBootstrap.js +70 -0
  36. package/dist/CryptoBootstrap.js.map +1 -0
  37. package/dist/CryptoBuilder.d.ts +27 -0
  38. package/dist/CryptoBuilder.d.ts.map +1 -0
  39. package/dist/CryptoBuilder.js +42 -0
  40. package/dist/CryptoBuilder.js.map +1 -0
  41. package/dist/ExecutableContentHasher.d.ts +22 -0
  42. package/dist/ExecutableContentHasher.d.ts.map +1 -0
  43. package/dist/ExecutableContentHasher.js +25 -0
  44. package/dist/ExecutableContentHasher.js.map +1 -0
  45. package/dist/ExecutionChainCrypto.d.ts +78 -0
  46. package/dist/ExecutionChainCrypto.d.ts.map +1 -0
  47. package/dist/ExecutionChainCrypto.js +165 -0
  48. package/dist/ExecutionChainCrypto.js.map +1 -0
  49. package/dist/ExecutionChainHasher.d.ts +10 -0
  50. package/dist/ExecutionChainHasher.d.ts.map +1 -0
  51. package/dist/ExecutionChainHasher.js +13 -0
  52. package/dist/ExecutionChainHasher.js.map +1 -0
  53. package/dist/ExecutionIntentCanonicalView.d.ts +28 -0
  54. package/dist/ExecutionIntentCanonicalView.d.ts.map +1 -0
  55. package/dist/ExecutionIntentCanonicalView.js +29 -0
  56. package/dist/ExecutionIntentCanonicalView.js.map +1 -0
  57. package/dist/ExecutionIntentCrypto.d.ts +21 -0
  58. package/dist/ExecutionIntentCrypto.d.ts.map +1 -0
  59. package/dist/ExecutionIntentCrypto.js +47 -0
  60. package/dist/ExecutionIntentCrypto.js.map +1 -0
  61. package/dist/ExecutionTrustRecordCanonicalView.d.ts +89 -0
  62. package/dist/ExecutionTrustRecordCanonicalView.d.ts.map +1 -0
  63. package/dist/ExecutionTrustRecordCanonicalView.js +106 -0
  64. package/dist/ExecutionTrustRecordCanonicalView.js.map +1 -0
  65. package/dist/HybridSignatureProvider.d.ts +48 -0
  66. package/dist/HybridSignatureProvider.d.ts.map +1 -0
  67. package/dist/HybridSignatureProvider.js +90 -0
  68. package/dist/HybridSignatureProvider.js.map +1 -0
  69. package/dist/KeyBootstrap.d.ts +23 -0
  70. package/dist/KeyBootstrap.d.ts.map +1 -0
  71. package/dist/KeyBootstrap.js +37 -0
  72. package/dist/KeyBootstrap.js.map +1 -0
  73. package/dist/KeyExpiry.d.ts +34 -0
  74. package/dist/KeyExpiry.d.ts.map +1 -0
  75. package/dist/KeyExpiry.js +66 -0
  76. package/dist/KeyExpiry.js.map +1 -0
  77. package/dist/KeyPair.d.ts +25 -0
  78. package/dist/KeyPair.d.ts.map +1 -0
  79. package/dist/KeyPair.js +37 -0
  80. package/dist/KeyPair.js.map +1 -0
  81. package/dist/KeyProvider.d.ts +98 -0
  82. package/dist/KeyProvider.d.ts.map +1 -0
  83. package/dist/KeyProvider.js +57 -0
  84. package/dist/KeyProvider.js.map +1 -0
  85. package/dist/KeyStore.d.ts +35 -0
  86. package/dist/KeyStore.d.ts.map +1 -0
  87. package/dist/KeyStore.js +2 -0
  88. package/dist/KeyStore.js.map +1 -0
  89. package/dist/OfflineVerifier.d.ts +80 -0
  90. package/dist/OfflineVerifier.d.ts.map +1 -0
  91. package/dist/OfflineVerifier.js +271 -0
  92. package/dist/OfflineVerifier.js.map +1 -0
  93. package/dist/PolicyChangeCrypto.d.ts +44 -0
  94. package/dist/PolicyChangeCrypto.d.ts.map +1 -0
  95. package/dist/PolicyChangeCrypto.js +79 -0
  96. package/dist/PolicyChangeCrypto.js.map +1 -0
  97. package/dist/PolicyChangeStepUpAuthorizationCrypto.d.ts +55 -0
  98. package/dist/PolicyChangeStepUpAuthorizationCrypto.d.ts.map +1 -0
  99. package/dist/PolicyChangeStepUpAuthorizationCrypto.js +107 -0
  100. package/dist/PolicyChangeStepUpAuthorizationCrypto.js.map +1 -0
  101. package/dist/ReceiptCrypto.d.ts +44 -0
  102. package/dist/ReceiptCrypto.d.ts.map +1 -0
  103. package/dist/ReceiptCrypto.js +84 -0
  104. package/dist/ReceiptCrypto.js.map +1 -0
  105. package/dist/ReceiptHasher.d.ts +10 -0
  106. package/dist/ReceiptHasher.d.ts.map +1 -0
  107. package/dist/ReceiptHasher.js +13 -0
  108. package/dist/ReceiptHasher.js.map +1 -0
  109. package/dist/RefusalCrypto.d.ts +35 -0
  110. package/dist/RefusalCrypto.d.ts.map +1 -0
  111. package/dist/RefusalCrypto.js +73 -0
  112. package/dist/RefusalCrypto.js.map +1 -0
  113. package/dist/SignatureCommitment.d.ts +33 -0
  114. package/dist/SignatureCommitment.d.ts.map +1 -0
  115. package/dist/SignatureCommitment.js +42 -0
  116. package/dist/SignatureCommitment.js.map +1 -0
  117. package/dist/SignatureVerifier.d.ts +20 -0
  118. package/dist/SignatureVerifier.d.ts.map +1 -0
  119. package/dist/SignatureVerifier.js +25 -0
  120. package/dist/SignatureVerifier.js.map +1 -0
  121. package/dist/Signer.d.ts +49 -0
  122. package/dist/Signer.d.ts.map +1 -0
  123. package/dist/Signer.js +2 -0
  124. package/dist/Signer.js.map +1 -0
  125. package/dist/SignerBootstrap.d.ts +37 -0
  126. package/dist/SignerBootstrap.d.ts.map +1 -0
  127. package/dist/SignerBootstrap.js +52 -0
  128. package/dist/SignerBootstrap.js.map +1 -0
  129. package/dist/TrustRecordHasher.d.ts +18 -0
  130. package/dist/TrustRecordHasher.d.ts.map +1 -0
  131. package/dist/TrustRecordHasher.js +23 -0
  132. package/dist/TrustRecordHasher.js.map +1 -0
  133. package/dist/VerificationCrypto.d.ts +132 -0
  134. package/dist/VerificationCrypto.d.ts.map +1 -0
  135. package/dist/VerificationCrypto.js +229 -0
  136. package/dist/VerificationCrypto.js.map +1 -0
  137. package/dist/errors/CryptoError.d.ts +14 -0
  138. package/dist/errors/CryptoError.d.ts.map +1 -0
  139. package/dist/errors/CryptoError.js +18 -0
  140. package/dist/errors/CryptoError.js.map +1 -0
  141. package/dist/index.d.ts +49 -0
  142. package/dist/index.d.ts.map +1 -0
  143. package/dist/index.js +73 -0
  144. package/dist/index.js.map +1 -0
  145. package/dist/models/HybridCryptoProvider.d.ts +9 -0
  146. package/dist/models/HybridCryptoProvider.d.ts.map +1 -0
  147. package/dist/models/HybridCryptoProvider.js +2 -0
  148. package/dist/models/HybridCryptoProvider.js.map +1 -0
  149. package/dist/providers/CryptoProvider.d.ts +15 -0
  150. package/dist/providers/CryptoProvider.d.ts.map +1 -0
  151. package/dist/providers/CryptoProvider.js +2 -0
  152. package/dist/providers/CryptoProvider.js.map +1 -0
  153. package/dist/providers/HashProvider.d.ts +17 -0
  154. package/dist/providers/HashProvider.d.ts.map +1 -0
  155. package/dist/providers/HashProvider.js +2 -0
  156. package/dist/providers/HashProvider.js.map +1 -0
  157. package/dist/providers/HashRegistry.d.ts +11 -0
  158. package/dist/providers/HashRegistry.d.ts.map +1 -0
  159. package/dist/providers/HashRegistry.js +18 -0
  160. package/dist/providers/HashRegistry.js.map +1 -0
  161. package/dist/providers/ProviderFactory.d.ts +11 -0
  162. package/dist/providers/ProviderFactory.d.ts.map +1 -0
  163. package/dist/providers/ProviderFactory.js +13 -0
  164. package/dist/providers/ProviderFactory.js.map +1 -0
  165. package/dist/providers/SignatureProvider.d.ts +25 -0
  166. package/dist/providers/SignatureProvider.d.ts.map +1 -0
  167. package/dist/providers/SignatureProvider.js +2 -0
  168. package/dist/providers/SignatureProvider.js.map +1 -0
  169. package/dist/providers/SignatureRegistry.d.ts +11 -0
  170. package/dist/providers/SignatureRegistry.d.ts.map +1 -0
  171. package/dist/providers/SignatureRegistry.js +18 -0
  172. package/dist/providers/SignatureRegistry.js.map +1 -0
  173. package/dist/providers/SignerKeyProviderAdapter.d.ts +50 -0
  174. package/dist/providers/SignerKeyProviderAdapter.d.ts.map +1 -0
  175. package/dist/providers/SignerKeyProviderAdapter.js +66 -0
  176. package/dist/providers/SignerKeyProviderAdapter.js.map +1 -0
  177. package/dist/providers/hash/SHA256HashProvider.d.ts +10 -0
  178. package/dist/providers/hash/SHA256HashProvider.d.ts.map +1 -0
  179. package/dist/providers/hash/SHA256HashProvider.js +12 -0
  180. package/dist/providers/hash/SHA256HashProvider.js.map +1 -0
  181. package/dist/providers/key/FileKeyProvider.d.ts +85 -0
  182. package/dist/providers/key/FileKeyProvider.d.ts.map +1 -0
  183. package/dist/providers/key/FileKeyProvider.js +163 -0
  184. package/dist/providers/key/FileKeyProvider.js.map +1 -0
  185. package/dist/providers/signature/Dilithium3SignatureProvider.d.ts +23 -0
  186. package/dist/providers/signature/Dilithium3SignatureProvider.d.ts.map +1 -0
  187. package/dist/providers/signature/Dilithium3SignatureProvider.js +33 -0
  188. package/dist/providers/signature/Dilithium3SignatureProvider.js.map +1 -0
  189. package/dist/providers/signature/Ed25519SignatureProvider.d.ts +17 -0
  190. package/dist/providers/signature/Ed25519SignatureProvider.d.ts.map +1 -0
  191. package/dist/providers/signature/Ed25519SignatureProvider.js +40 -0
  192. package/dist/providers/signature/Ed25519SignatureProvider.js.map +1 -0
  193. package/dist/providers/signature/assertKeyType.d.ts +14 -0
  194. package/dist/providers/signature/assertKeyType.d.ts.map +1 -0
  195. package/dist/providers/signature/assertKeyType.js +19 -0
  196. package/dist/providers/signature/assertKeyType.js.map +1 -0
  197. package/dist/providers/signer/KmsSigner.d.ts +71 -0
  198. package/dist/providers/signer/KmsSigner.d.ts.map +1 -0
  199. package/dist/providers/signer/KmsSigner.js +270 -0
  200. package/dist/providers/signer/KmsSigner.js.map +1 -0
  201. package/dist/providers/signer/LocalFileSigner.d.ts +28 -0
  202. package/dist/providers/signer/LocalFileSigner.d.ts.map +1 -0
  203. package/dist/providers/signer/LocalFileSigner.js +38 -0
  204. package/dist/providers/signer/LocalFileSigner.js.map +1 -0
  205. package/dist/support/MlDsaSupport.d.ts +9 -0
  206. package/dist/support/MlDsaSupport.d.ts.map +1 -0
  207. package/dist/support/MlDsaSupport.js +23 -0
  208. package/dist/support/MlDsaSupport.js.map +1 -0
  209. package/package.json +45 -4
@@ -0,0 +1,90 @@
1
+ import { ArtifactSigner } from "./ArtifactSigner.js";
2
+ import { CanonicalSerializer } from "./CanonicalSerializer.js";
3
+ import { SignatureVerifier } from "./SignatureVerifier.js";
4
+ /**
5
+ * Signs and verifies an artifact with two independent signature
6
+ * algorithms at once (Hybrid Signature Support milestone, Phase A):
7
+ * "harvest now, decrypt/forge later" defense for the classical-to-
8
+ * post-quantum transition -- if a future quantum computer breaks the
9
+ * primary (classical) algorithm, the secondary (post-quantum)
10
+ * signature alone still holds, and vice versa if any weakness is ever
11
+ * found in the newer PQ scheme.
12
+ *
13
+ * Not a SignatureProvider implementer: that interface signs/verifies
14
+ * with exactly one key in, one signature out. Hybrid fundamentally
15
+ * needs two keys and produces two independent signatures, so this is
16
+ * a purpose-built composition on top of two SignatureProviders
17
+ * (via HybridCryptoProvider) and a KeyProvider, mirroring how
18
+ * VerificationCrypto/ReceiptCrypto already resolve keys by id rather
19
+ * than requiring callers to pre-fetch raw KeyObjects.
20
+ */
21
+ export class HybridSignatureProvider {
22
+ crypto;
23
+ keys;
24
+ serializer;
25
+ constructor(crypto, keys, serializer = new CanonicalSerializer()) {
26
+ this.crypto = crypto;
27
+ this.keys = keys;
28
+ this.serializer = serializer;
29
+ }
30
+ /**
31
+ * Signs the artifact with both configured algorithms, returning
32
+ * both entries in fixed [primary, secondary] order.
33
+ */
34
+ async sign(artifact, primaryKeyId, secondaryKeyId) {
35
+ const primarySigner = new ArtifactSigner(this.crypto.primary, this.serializer);
36
+ const secondarySigner = new ArtifactSigner(this.crypto.secondary, this.serializer);
37
+ const primaryPrivateKey = await this.keys.getPrivateKey(primaryKeyId);
38
+ const secondaryPrivateKey = await this.keys.getPrivateKey(secondaryKeyId);
39
+ const [primarySignature, secondarySignature] = await Promise.all([
40
+ primarySigner.sign(artifact, primaryPrivateKey),
41
+ secondarySigner.sign(artifact, secondaryPrivateKey),
42
+ ]);
43
+ return [
44
+ {
45
+ algorithm: this.crypto.primary.signature.algorithm,
46
+ keyId: primaryKeyId,
47
+ signature: primarySignature,
48
+ },
49
+ {
50
+ algorithm: this.crypto.secondary.signature.algorithm,
51
+ keyId: secondaryKeyId,
52
+ signature: secondarySignature,
53
+ },
54
+ ];
55
+ }
56
+ /**
57
+ * Verifies every entry in `signatures`. Fail-closed: requires
58
+ * exactly one entry for the primary algorithm and one for the
59
+ * secondary algorithm -- a missing, extra, duplicated, or
60
+ * mismatched-algorithm entry is a rejection, never a partial pass.
61
+ * Both entries must independently verify against their own
62
+ * algorithm's public key (resolved by the entry's own keyId).
63
+ *
64
+ * Key lookup failures (missing/mismatched key material) are not
65
+ * caught here and propagate as thrown errors, mirroring
66
+ * VerificationCrypto.verifySignature()'s existing precedent: a
67
+ * malformed *signature* is a verification failure (returns false);
68
+ * missing *key infrastructure* is an operational error (throws).
69
+ */
70
+ async verify(artifact, signatures) {
71
+ if (signatures.length !== 2) {
72
+ return false;
73
+ }
74
+ const primaryEntry = signatures.find((entry) => entry.algorithm === this.crypto.primary.signature.algorithm);
75
+ const secondaryEntry = signatures.find((entry) => entry.algorithm === this.crypto.secondary.signature.algorithm);
76
+ if (!primaryEntry || !secondaryEntry || primaryEntry === secondaryEntry) {
77
+ return false;
78
+ }
79
+ const primaryVerifier = new SignatureVerifier(this.crypto.primary, this.serializer);
80
+ const secondaryVerifier = new SignatureVerifier(this.crypto.secondary, this.serializer);
81
+ const primaryPublicKey = await this.keys.getPublicKey(primaryEntry.keyId);
82
+ const secondaryPublicKey = await this.keys.getPublicKey(secondaryEntry.keyId);
83
+ const [primaryVerified, secondaryVerified] = await Promise.all([
84
+ primaryVerifier.verify(artifact, primaryEntry.signature, primaryPublicKey),
85
+ secondaryVerifier.verify(artifact, secondaryEntry.signature, secondaryPublicKey),
86
+ ]);
87
+ return primaryVerified && secondaryVerified;
88
+ }
89
+ }
90
+ //# sourceMappingURL=HybridSignatureProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"HybridSignatureProvider.js","sourceRoot":"","sources":["../src/HybridSignatureProvider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import type { KeyProvider } from "./KeyProvider.js";
2
+ /**
3
+ * Key Bootstrap.
4
+ *
5
+ * Composition root for key management.
6
+ *
7
+ * KEY_PROVIDER accepts "local", "aws-kms", "azure-key-vault",
8
+ * "gcp-kms", and "hsm" (see packages/shared/src/config/KeyProviders.ts)
9
+ * for forward-compatible configuration, but only FileKeyProvider
10
+ * ("local") is actually implemented. Before this check existed, setting
11
+ * KEY_PROVIDER=aws-kms (or any other non-local value) parsed and
12
+ * validated cleanly, then silently constructed a FileKeyProvider anyway
13
+ * — an operator who configured real KMS custody got private-key-on-disk
14
+ * instead, with no error. Failing loudly here, at startup, turns that
15
+ * silent misconfiguration into an immediate, actionable error instead
16
+ * of a false sense of custody. Remove this check only once a real
17
+ * provider class exists for the value being unblocked.
18
+ */
19
+ export declare class KeyBootstrap {
20
+ private static provider;
21
+ static create(): KeyProvider;
22
+ }
23
+ //# sourceMappingURL=KeyBootstrap.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyBootstrap.d.ts","sourceRoot":"","sources":["../src/KeyBootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IAErC,MAAM,CAAC,MAAM,IAAI,WAAW,CAkB3B;CACF"}
@@ -0,0 +1,37 @@
1
+ import { KeyProviders, loadConfig } from "@parmana/shared";
2
+ import { FileKeyProvider } from "./providers/key/FileKeyProvider.js";
3
+ /**
4
+ * Key Bootstrap.
5
+ *
6
+ * Composition root for key management.
7
+ *
8
+ * KEY_PROVIDER accepts "local", "aws-kms", "azure-key-vault",
9
+ * "gcp-kms", and "hsm" (see packages/shared/src/config/KeyProviders.ts)
10
+ * for forward-compatible configuration, but only FileKeyProvider
11
+ * ("local") is actually implemented. Before this check existed, setting
12
+ * KEY_PROVIDER=aws-kms (or any other non-local value) parsed and
13
+ * validated cleanly, then silently constructed a FileKeyProvider anyway
14
+ * — an operator who configured real KMS custody got private-key-on-disk
15
+ * instead, with no error. Failing loudly here, at startup, turns that
16
+ * silent misconfiguration into an immediate, actionable error instead
17
+ * of a false sense of custody. Remove this check only once a real
18
+ * provider class exists for the value being unblocked.
19
+ */
20
+ export class KeyBootstrap {
21
+ static provider;
22
+ static create() {
23
+ if (!this.provider) {
24
+ const configuredProvider = loadConfig().keys.provider;
25
+ if (configuredProvider !== KeyProviders.LOCAL) {
26
+ throw new Error(`KEY_PROVIDER=${configuredProvider} is not implemented. Only "${KeyProviders.LOCAL}" ` +
27
+ "(FileKeyProvider, keys read from PARMANA_KEY_DIR on local disk) has a real " +
28
+ "implementation today. Refusing to start with a configured key custody model " +
29
+ "(aws-kms, azure-key-vault, gcp-kms, hsm) that would silently fall back to " +
30
+ "file-based keys instead of the KMS/HSM custody the configuration requested.");
31
+ }
32
+ this.provider = new FileKeyProvider();
33
+ }
34
+ return this.provider;
35
+ }
36
+ }
37
+ //# sourceMappingURL=KeyBootstrap.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyBootstrap.js","sourceRoot":"","sources":["../src/KeyBootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI3D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,QAAQ,CAAc;IAErC,MAAM,CAAC,MAAM;QACX,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,kBAAkB,GAAG,UAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;YAEtD,IAAI,kBAAkB,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,gBAAgB,kBAAkB,8BAA8B,YAAY,CAAC,KAAK,IAAI;oBACpF,6EAA6E;oBAC7E,8EAA8E;oBAC9E,4EAA4E;oBAC5E,6EAA6E,CAChF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * One key's expiry/revocation metadata.
3
+ */
4
+ export interface KeyExpiryEntry {
5
+ readonly expiresAt?: Date;
6
+ readonly revoked?: boolean;
7
+ }
8
+ /**
9
+ * Looks up expiry/revocation metadata for a keyId.
10
+ */
11
+ export interface KeyExpiryStore {
12
+ get(keyId: string): Promise<KeyExpiryEntry | undefined>;
13
+ }
14
+ /**
15
+ * File Key Expiry Store.
16
+ *
17
+ * Reads one small sidecar JSON file beside the PEM key files
18
+ * FileKeyProvider already reads from the same configured key
19
+ * directory: `<keyDirectory>/key-expiry.json`, shape
20
+ * `{ "<keyId>": { "expiresAt"?: ISO string, "revoked"?: boolean } }`.
21
+ *
22
+ * A keyId absent from the file, or the file itself being absent,
23
+ * means "no expiry, always valid" -- the safe default that keeps
24
+ * every deployment that doesn't opt into key expiry behaving exactly
25
+ * as it does today. Consistent with FileKeyProvider's own documented
26
+ * scope: intended for development and self-hosted deployments: no
27
+ * external KMS/vault dependency, no env-var-encoded key material.
28
+ */
29
+ export declare class FileKeyExpiryStore implements KeyExpiryStore {
30
+ private readonly config;
31
+ private readonly keyDirectory;
32
+ get(keyId: string): Promise<KeyExpiryEntry | undefined>;
33
+ }
34
+ //# sourceMappingURL=KeyExpiry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyExpiry.d.ts","sourceRoot":"","sources":["../src/KeyExpiry.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CACzD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6C;IAEpE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA8D5D;CACF"}
@@ -0,0 +1,66 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { loadConfig } from "@parmana/shared";
4
+ /**
5
+ * File Key Expiry Store.
6
+ *
7
+ * Reads one small sidecar JSON file beside the PEM key files
8
+ * FileKeyProvider already reads from the same configured key
9
+ * directory: `<keyDirectory>/key-expiry.json`, shape
10
+ * `{ "<keyId>": { "expiresAt"?: ISO string, "revoked"?: boolean } }`.
11
+ *
12
+ * A keyId absent from the file, or the file itself being absent,
13
+ * means "no expiry, always valid" -- the safe default that keeps
14
+ * every deployment that doesn't opt into key expiry behaving exactly
15
+ * as it does today. Consistent with FileKeyProvider's own documented
16
+ * scope: intended for development and self-hosted deployments: no
17
+ * external KMS/vault dependency, no env-var-encoded key material.
18
+ */
19
+ export class FileKeyExpiryStore {
20
+ config = loadConfig();
21
+ keyDirectory = this.config.keys.keyDirectory ?? "./keys";
22
+ async get(keyId) {
23
+ const path = join(this.keyDirectory, "key-expiry.json");
24
+ if (!existsSync(path)) {
25
+ return undefined;
26
+ }
27
+ const raw = readFileSync(path, "utf8");
28
+ let parsed;
29
+ try {
30
+ parsed = JSON.parse(raw);
31
+ }
32
+ catch {
33
+ throw new Error(`${path} is not valid JSON.`);
34
+ }
35
+ if (typeof parsed !== "object" ||
36
+ parsed === null ||
37
+ Array.isArray(parsed)) {
38
+ throw new Error(`${path} must be a JSON object keyed by keyId.`);
39
+ }
40
+ const entry = parsed[keyId];
41
+ if (entry === undefined) {
42
+ return undefined;
43
+ }
44
+ const { expiresAt, revoked } = entry;
45
+ if (expiresAt !== undefined &&
46
+ (typeof expiresAt !== "string" || Number.isNaN(Date.parse(expiresAt)))) {
47
+ //
48
+ // An unparseable date became an Invalid Date, and EnvelopeVerifier's
49
+ // `expiresAt <= now` is false for it, so a typo silently left the
50
+ // key valid forever. Refused instead, like every other malformed
51
+ // entry in this file.
52
+ //
53
+ throw new Error(`${path}["${keyId}"].expiresAt must be an ISO 8601 date string.`);
54
+ }
55
+ if (revoked !== undefined && typeof revoked !== "boolean") {
56
+ throw new Error(`${path}["${keyId}"].revoked must be a boolean.`);
57
+ }
58
+ return {
59
+ ...(expiresAt !== undefined && {
60
+ expiresAt: new Date(expiresAt),
61
+ }),
62
+ ...(revoked !== undefined && { revoked }),
63
+ };
64
+ }
65
+ }
66
+ //# sourceMappingURL=KeyExpiry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyExpiry.js","sourceRoot":"","sources":["../src/KeyExpiry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiB7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAG,UAAU,EAAE,CAAC;IAEtB,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC;IAE1E,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;QAExD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEvC,IAAI,MAAe,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qBAAqB,CAAC,CAAC;QAChD,CAAC;QAED,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACrB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,wCAAwC,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,KAAK,GAAI,MAAkC,CAAC,KAAK,CAAC,CAAC;QAEzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAG9B,CAAC;QAEF,IACE,SAAS,KAAK,SAAS;YACvB,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EACtE,CAAC;YACD,EAAE;YACF,qEAAqE;YACrE,kEAAkE;YAClE,iEAAiE;YACjE,sBAAsB;YACtB,EAAE;YACF,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,KAAK,KAAK,+CAA+C,CACjE,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,KAAK,+BAA+B,CAAC,CAAC;QACpE,CAAC;QAED,OAAO;YACL,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI;gBAC7B,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC;aAC/B,CAAC;YAEF,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Represents a cryptographic key pair used for signing and verification.
3
+ *
4
+ * This is a simple immutable container for public and private key material.
5
+ */
6
+ export declare class KeyPair {
7
+ /**
8
+ * Public key (used for verification).
9
+ */
10
+ readonly publicKey: Uint8Array;
11
+ /**
12
+ * Private key (used for signing).
13
+ */
14
+ readonly privateKey: Uint8Array;
15
+ constructor(publicKey: Uint8Array, privateKey: Uint8Array);
16
+ /**
17
+ * Returns a JSON-safe representation.
18
+ * WARNING: does not expose private key in raw form.
19
+ */
20
+ toJSON(): {
21
+ publicKey: string;
22
+ privateKey: string;
23
+ };
24
+ }
25
+ //# sourceMappingURL=KeyPair.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyPair.d.ts","sourceRoot":"","sources":["../src/KeyPair.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,OAAO;IAClB;;OAEG;IACH,SAAgB,SAAS,EAAE,UAAU,CAAC;IAEtC;;OAEG;IACH,SAAgB,UAAU,EAAE,UAAU,CAAC;IAEvC,YAAY,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAaxD;IAED;;;OAGG;IACI,MAAM;QAET,SAAS;QACT,UAAU;MAEb;CACF"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Represents a cryptographic key pair used for signing and verification.
3
+ *
4
+ * This is a simple immutable container for public and private key material.
5
+ */
6
+ export class KeyPair {
7
+ /**
8
+ * Public key (used for verification).
9
+ */
10
+ publicKey;
11
+ /**
12
+ * Private key (used for signing).
13
+ */
14
+ privateKey;
15
+ constructor(publicKey, privateKey) {
16
+ if (!publicKey || publicKey.length === 0) {
17
+ throw new Error("Public key cannot be empty.");
18
+ }
19
+ if (!privateKey || privateKey.length === 0) {
20
+ throw new Error("Private key cannot be empty.");
21
+ }
22
+ this.publicKey = new Uint8Array(publicKey);
23
+ this.privateKey = new Uint8Array(privateKey);
24
+ Object.freeze(this);
25
+ }
26
+ /**
27
+ * Returns a JSON-safe representation.
28
+ * WARNING: does not expose private key in raw form.
29
+ */
30
+ toJSON() {
31
+ return {
32
+ publicKey: Buffer.from(this.publicKey).toString("base64"),
33
+ privateKey: "***REDACTED***",
34
+ };
35
+ }
36
+ }
37
+ //# sourceMappingURL=KeyPair.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyPair.js","sourceRoot":"","sources":["../src/KeyPair.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,OAAO;IAClB;;OAEG;IACa,SAAS,CAAa;IAEtC;;OAEG;IACa,UAAU,CAAa;IAEvC,YAAY,SAAqB,EAAE,UAAsB;QACvD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACI,MAAM;QACX,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACzD,UAAU,EAAE,gBAAgB;SAC7B,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,98 @@
1
+ import type { KeyObject } from "node:crypto";
2
+ import type { SignatureAlgorithm } from "@parmana/shared";
3
+ /**
4
+ * Canonical key identifier used when no other keyId is
5
+ * specified. Every Parmana process that signs or verifies
6
+ * with the default key uses this identifier, so key material
7
+ * generated by scripts/generate-keypair.ts is found
8
+ * consistently across the crypto and runtime packages.
9
+ */
10
+ export declare const DEFAULT_KEY_ID = "default";
11
+ /**
12
+ * Keyid for the secondary (hybrid-mode) signing key, living alongside
13
+ * DEFAULT_KEY_ID under the same PARMANA_KEY_DIR (Hybrid Signature
14
+ * Support milestone, Phase A). Only read when CRYPTO_MODE=hybrid;
15
+ * generate it with `npm run generate:hybrid-secondary-key`. Deliberately
16
+ * a distinct keyId rather than reusing DEFAULT_KEY_ID -- FileKeyProvider
17
+ * resolves keys purely by keyId (`<keyId>.private.pem`), and one keyId
18
+ * can only ever hold one algorithm's key material at a time.
19
+ */
20
+ export declare const DEFAULT_SECONDARY_KEY_ID = "default-secondary";
21
+ /**
22
+ * Resolves the keyId that VerificationCrypto/RefusalCrypto/
23
+ * AuditEventCrypto -- the durable-evidence signers (Trust Records,
24
+ * Refusal Records, Audit Events) -- use for NEW signatures (PQC audit
25
+ * RED-3, docs/VERIFICATION-GAPS.md). Every one of these three signers
26
+ * previously hardcoded DEFAULT_KEY_ID directly, so the only way to
27
+ * "rotate" was to overwrite default.private.pem/default.public.pem in
28
+ * place -- which silently invalidates every record ever signed under
29
+ * that keyId, since verification always resolves the public key by
30
+ * the *stored* record's own keyId (already true, and unaffected by
31
+ * this function).
32
+ *
33
+ * Read fresh on every call (mirrors
34
+ * packages/api/src/bootstrap/createGatewayKeyPair.ts's own
35
+ * PARMANA_GATEWAY_KEY_ID pattern), not cached, so a rotation takes
36
+ * effect on redeploy without any other code change: generate a new
37
+ * keyId's key pair (scripts/generate-keypair.ts already supports an
38
+ * arbitrary --key-id and refuses to overwrite an existing one without
39
+ * --force), point PARMANA_VERIFICATION_KEY_ID at it, and every
40
+ * already-issued record -- still referencing the old keyId -- keeps
41
+ * verifying as long as its key file is not deleted. Unset (the
42
+ * default) behaves exactly as before this function existed.
43
+ *
44
+ * FileKeyProvider's own assertValidKeyId() rejects an unsafe value
45
+ * the moment this is used to look up a key file, so no separate
46
+ * validation is duplicated here.
47
+ */
48
+ export declare function currentVerificationKeyId(): string;
49
+ /**
50
+ * Same rotation mechanism as currentVerificationKeyId(), for the
51
+ * hybrid-mode secondary signing key.
52
+ */
53
+ export declare function currentVerificationSecondaryKeyId(): string;
54
+ /**
55
+ * Signing key metadata.
56
+ */
57
+ export interface KeyMetadata {
58
+ readonly keyId: string;
59
+ readonly algorithm: SignatureAlgorithm;
60
+ }
61
+ /**
62
+ * Key management abstraction.
63
+ */
64
+ export interface KeyProvider {
65
+ /**
66
+ * Returns metadata for the specified key.
67
+ */
68
+ getMetadata(keyId: string): Promise<KeyMetadata>;
69
+ /**
70
+ * Returns the private key.
71
+ */
72
+ getPrivateKey(keyId: string): Promise<KeyObject>;
73
+ /**
74
+ * Returns the public key.
75
+ */
76
+ getPublicKey(keyId: string): Promise<KeyObject>;
77
+ /**
78
+ * Returns true if the key exists.
79
+ */
80
+ hasKey(keyId: string): Promise<boolean>;
81
+ /**
82
+ * Lists every keyId this provider can currently load a public key
83
+ * for (PQC audit RED-2, docs/VERIFICATION-GAPS.md) -- used by the
84
+ * key-discovery endpoints (packages/api/src/routes/keys.ts) to
85
+ * enumerate every key an auditor might need, not only whichever one
86
+ * happens to be "current."
87
+ *
88
+ * Optional: every pre-existing test fake implementing this
89
+ * interface (several across packages/crypto, packages/envelope-
90
+ * verifier, packages/runtime, packages/connector-hubspot) keeps
91
+ * compiling unchanged without adding it, the same "add capability
92
+ * without breaking existing implementers" precedent
93
+ * ExecutionTrustRecordRepository.sumSuccessfulExecutionAmounts?
94
+ * already set.
95
+ */
96
+ listKeys?(): Promise<string[]>;
97
+ }
98
+ //# sourceMappingURL=KeyProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyProvider.d.ts","sourceRoot":"","sources":["../src/KeyProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,MAAM,CAK1D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAChC"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Canonical key identifier used when no other keyId is
3
+ * specified. Every Parmana process that signs or verifies
4
+ * with the default key uses this identifier, so key material
5
+ * generated by scripts/generate-keypair.ts is found
6
+ * consistently across the crypto and runtime packages.
7
+ */
8
+ export const DEFAULT_KEY_ID = "default";
9
+ /**
10
+ * Keyid for the secondary (hybrid-mode) signing key, living alongside
11
+ * DEFAULT_KEY_ID under the same PARMANA_KEY_DIR (Hybrid Signature
12
+ * Support milestone, Phase A). Only read when CRYPTO_MODE=hybrid;
13
+ * generate it with `npm run generate:hybrid-secondary-key`. Deliberately
14
+ * a distinct keyId rather than reusing DEFAULT_KEY_ID -- FileKeyProvider
15
+ * resolves keys purely by keyId (`<keyId>.private.pem`), and one keyId
16
+ * can only ever hold one algorithm's key material at a time.
17
+ */
18
+ export const DEFAULT_SECONDARY_KEY_ID = "default-secondary";
19
+ /**
20
+ * Resolves the keyId that VerificationCrypto/RefusalCrypto/
21
+ * AuditEventCrypto -- the durable-evidence signers (Trust Records,
22
+ * Refusal Records, Audit Events) -- use for NEW signatures (PQC audit
23
+ * RED-3, docs/VERIFICATION-GAPS.md). Every one of these three signers
24
+ * previously hardcoded DEFAULT_KEY_ID directly, so the only way to
25
+ * "rotate" was to overwrite default.private.pem/default.public.pem in
26
+ * place -- which silently invalidates every record ever signed under
27
+ * that keyId, since verification always resolves the public key by
28
+ * the *stored* record's own keyId (already true, and unaffected by
29
+ * this function).
30
+ *
31
+ * Read fresh on every call (mirrors
32
+ * packages/api/src/bootstrap/createGatewayKeyPair.ts's own
33
+ * PARMANA_GATEWAY_KEY_ID pattern), not cached, so a rotation takes
34
+ * effect on redeploy without any other code change: generate a new
35
+ * keyId's key pair (scripts/generate-keypair.ts already supports an
36
+ * arbitrary --key-id and refuses to overwrite an existing one without
37
+ * --force), point PARMANA_VERIFICATION_KEY_ID at it, and every
38
+ * already-issued record -- still referencing the old keyId -- keeps
39
+ * verifying as long as its key file is not deleted. Unset (the
40
+ * default) behaves exactly as before this function existed.
41
+ *
42
+ * FileKeyProvider's own assertValidKeyId() rejects an unsafe value
43
+ * the moment this is used to look up a key file, so no separate
44
+ * validation is duplicated here.
45
+ */
46
+ export function currentVerificationKeyId() {
47
+ return process.env.PARMANA_VERIFICATION_KEY_ID ?? DEFAULT_KEY_ID;
48
+ }
49
+ /**
50
+ * Same rotation mechanism as currentVerificationKeyId(), for the
51
+ * hybrid-mode secondary signing key.
52
+ */
53
+ export function currentVerificationSecondaryKeyId() {
54
+ return (process.env.PARMANA_VERIFICATION_SECONDARY_KEY_ID ??
55
+ DEFAULT_SECONDARY_KEY_ID);
56
+ }
57
+ //# sourceMappingURL=KeyProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyProvider.js","sourceRoot":"","sources":["../src/KeyProvider.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,cAAc,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC;IAC/C,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,qCAAqC;QACjD,wBAAwB,CACzB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,35 @@
1
+ import type { KeyPair } from "./KeyPair.js";
2
+ /**
3
+ * Abstract key storage interface.
4
+ *
5
+ * KeyStore is responsible for persisting and retrieving cryptographic
6
+ * key pairs. Implementations may be in-memory, file-based, or external
7
+ * secure vaults (HSM, KMS, etc.).
8
+ */
9
+ export interface KeyStore {
10
+ /**
11
+ * Stores a key pair under a given identifier.
12
+ *
13
+ * @param id Unique key identifier.
14
+ * @param keyPair Cryptographic key pair.
15
+ */
16
+ set(id: string, keyPair: KeyPair): Promise<void>;
17
+ /**
18
+ * Retrieves a key pair by identifier.
19
+ *
20
+ * @param id Key identifier.
21
+ * @returns Key pair or null if not found.
22
+ */
23
+ get(id: string): Promise<KeyPair | null>;
24
+ /**
25
+ * Deletes a key pair by identifier.
26
+ *
27
+ * @param id Key identifier.
28
+ */
29
+ delete(id: string): Promise<void>;
30
+ /**
31
+ * Lists all stored key identifiers.
32
+ */
33
+ list(): Promise<string[]>;
34
+ }
35
+ //# sourceMappingURL=KeyStore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyStore.d.ts","sourceRoot":"","sources":["../src/KeyStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAEzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3B"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=KeyStore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KeyStore.js","sourceRoot":"","sources":["../src/KeyStore.ts"],"names":[],"mappings":""}
@@ -0,0 +1,80 @@
1
+ import type { ExecutionIntent, ExecutionTrustRecord } from "@parmana/shared";
2
+ export interface OfflineVerificationResult {
3
+ /**
4
+ * Overall result: hash matches, the legacy signature verifies, and
5
+ * -- only when the record carries a `signatures` array at all --
6
+ * every entry in it also verifies. `false` on any error (missing
7
+ * key, unsupported algorithm, malformed input) as well as any
8
+ * cryptographic failure; see `errors` for which.
9
+ */
10
+ readonly valid: boolean;
11
+ /**
12
+ * Whether the record's own `trustRecordHash` matches a fresh hash
13
+ * of its canonical content. Recomputed using SHA-256 -- the only
14
+ * hash algorithm this codebase actually implements today (sha3-512/
15
+ * blake3 are declared config values with no real provider); a
16
+ * record hashed under a different algorithm cannot be distinguished
17
+ * from a tampered one by this check alone, since the algorithm used
18
+ * is not itself recorded on the artifact.
19
+ */
20
+ readonly hashValid: boolean;
21
+ /**
22
+ * Whether the always-present legacy `signature` field verifies.
23
+ */
24
+ readonly legacySignatureValid: boolean;
25
+ /**
26
+ * Whether the hybrid `signatures` array verifies -- present only
27
+ * when the record actually carries one. `undefined` means "this
28
+ * record has no `signatures` array to check," not "it failed."
29
+ * Mirrors VerificationCrypto.verifySignature()'s own "absent means
30
+ * not covered" semantics, deliberately: this function reports facts
31
+ * about what is present, it does not enforce a policy about what
32
+ * *should* be present (the equivalent of the online verifier's
33
+ * HYBRID_SIGNATURE_REQUIRED flag is a decision for the caller to
34
+ * make from this result, not something an offline, stateless
35
+ * function can decide on the record's own say-so).
36
+ */
37
+ readonly hybridSignaturesValid?: boolean;
38
+ /**
39
+ * Every algorithm identifier this call actually attempted to
40
+ * verify, legacy and hybrid combined, in the order checked.
41
+ */
42
+ readonly algorithmsChecked: readonly string[];
43
+ /**
44
+ * Human-readable reasons for any check that failed or could not be
45
+ * attempted (missing key material for a keyId, an unsupported
46
+ * algorithm, a malformed `signatures` array). Empty when `valid` is
47
+ * true.
48
+ */
49
+ readonly errors: readonly string[];
50
+ }
51
+ /**
52
+ * `publicKeys` maps keyId -> PEM-encoded public key (SPKI). Supply an
53
+ * entry for every keyId the record's `signature.keyId` and (if
54
+ * present) each `signatures[].keyId` reference -- typically fetched
55
+ * once from a key-discovery endpoint (see the `/keys` and
56
+ * `/.well-known/jwks.json` routes) and cached by the caller, not
57
+ * re-fetched per verification.
58
+ */
59
+ export declare function verifyExecutionTrustRecordOffline(trustRecord: ExecutionTrustRecord, publicKeys: Readonly<Record<string, string>>, options?: {
60
+ readonly hybridRequiredFrom?: string;
61
+ /**
62
+ * Explicit opt-in to accept a record with no hybrid envelope. Off by
63
+ * default: a legacy-only record is refused unless it predates a cutover
64
+ * the caller supplied, or this is set.
65
+ */
66
+ readonly allowLegacyOnly?: boolean;
67
+ }): Promise<OfflineVerificationResult>;
68
+ /**
69
+ * Verifies an Execution Intent (ADR-0012) with no network call, no database and
70
+ * no key directory: only the intent and the public key(s) are needed. Checks
71
+ * that the recorded hash matches the canonical intent and that the signature
72
+ * verifies against the public key for the intent's keyId.
73
+ *
74
+ * A valid result proves the intent was signed by the holder of that key and has
75
+ * not been altered. It does not prove the action was released, or what the
76
+ * result was: an intent is written BEFORE release. Whether a signed Execution
77
+ * Trust Record exists for the same businessTransactionId is a separate check.
78
+ */
79
+ export declare function verifyExecutionIntentOffline(intent: ExecutionIntent, publicKeys: Readonly<Record<string, string>>): Promise<OfflineVerificationResult>;
80
+ //# sourceMappingURL=OfflineVerifier.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OfflineVerifier.d.ts","sourceRoot":"","sources":["../src/OfflineVerifier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAErB,MAAM,iBAAiB,CAAC;AA+DzB,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAEvC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEzC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAsB,iCAAiC,CACrD,WAAW,EAAE,oBAAoB,EACjC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,OAAO,GAAE;IACP,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC/B,GACL,OAAO,CAAC,yBAAyB,CAAC,CAmKpC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC3C,OAAO,CAAC,yBAAyB,CAAC,CA8CpC"}