@preeternal/jws-verifier 0.0.0-stage → 0.0.1-rc.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 (40) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/LICENSE +21 -0
  3. package/README.md +85 -2
  4. package/dist/asn1/ber-reader.d.ts +57 -0
  5. package/dist/asn1/ber-reader.d.ts.map +1 -0
  6. package/dist/asn1/ber-reader.js +202 -0
  7. package/dist/asn1/der-reader.d.ts +68 -0
  8. package/dist/asn1/der-reader.d.ts.map +1 -0
  9. package/dist/asn1/der-reader.js +181 -0
  10. package/dist/index.d.ts +7 -0
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +5 -0
  13. package/dist/jws/es256-signature.d.ts +3 -0
  14. package/dist/jws/es256-signature.d.ts.map +1 -0
  15. package/dist/jws/es256-signature.js +22 -0
  16. package/dist/jws/verifier.d.ts +94 -0
  17. package/dist/jws/verifier.d.ts.map +1 -0
  18. package/dist/jws/verifier.js +718 -0
  19. package/dist/ocsp/codec.d.ts +55 -0
  20. package/dist/ocsp/codec.d.ts.map +1 -0
  21. package/dist/ocsp/codec.js +465 -0
  22. package/dist/ocsp/transport.d.ts +6 -0
  23. package/dist/ocsp/transport.d.ts.map +1 -0
  24. package/dist/ocsp/transport.js +69 -0
  25. package/dist/receipt/utility.d.ts +27 -0
  26. package/dist/receipt/utility.d.ts.map +1 -0
  27. package/dist/receipt/utility.js +296 -0
  28. package/dist/types/index.d.ts +4 -0
  29. package/dist/types/index.d.ts.map +1 -0
  30. package/dist/types/index.js +1 -0
  31. package/dist/utils/formatting.d.ts +2 -0
  32. package/dist/utils/formatting.d.ts.map +1 -0
  33. package/dist/utils/formatting.js +9 -0
  34. package/dist/x509/certificate-metadata.d.ts +91 -0
  35. package/dist/x509/certificate-metadata.d.ts.map +1 -0
  36. package/dist/x509/certificate-metadata.js +588 -0
  37. package/dist/x509/prepared-certificates.d.ts +22 -0
  38. package/dist/x509/prepared-certificates.d.ts.map +1 -0
  39. package/dist/x509/prepared-certificates.js +27 -0
  40. package/package.json +81 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"es256-signature.d.ts","sourceRoot":"","sources":["../../source/jws/es256-signature.ts"],"names":[],"mappings":"AAaA,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,GAAI,WAAW,UAAU,KAAG,UAQ3D,CAAC"}
@@ -0,0 +1,22 @@
1
+ const scalarBytes = 32;
2
+ const writeDerInteger = (output, offset, scalar) => {
3
+ let start = 0;
4
+ while (start < scalarBytes - 1 && scalar[start] === 0)
5
+ start += 1;
6
+ const padding = (scalar[start] ?? 0) >= 0x80 ? 1 : 0;
7
+ const length = scalarBytes - start + padding;
8
+ output[offset] = 0x02;
9
+ output[offset + 1] = length;
10
+ output.set(scalar.subarray(start), offset + 2 + padding);
11
+ return offset + 2 + length;
12
+ };
13
+ /** Encode the two unsigned 32-byte scalars of a length-checked ES256 signature. */
14
+ export const es256SignatureToDer = (signature) => {
15
+ // Each DER INTEGER may need one sign byte, in addition to its tag and length.
16
+ const output = new Uint8Array(72);
17
+ const offset = writeDerInteger(output, 2, signature.subarray(0, scalarBytes));
18
+ const end = writeDerInteger(output, offset, signature.subarray(scalarBytes));
19
+ output[0] = 0x30;
20
+ output[1] = end - 2;
21
+ return output.subarray(0, end);
22
+ };
@@ -0,0 +1,94 @@
1
+ export interface OcspTransportRequest {
2
+ readonly url: string;
3
+ readonly body: Uint8Array;
4
+ readonly signal: AbortSignal;
5
+ }
6
+ export type OcspTransport = (request: OcspTransportRequest) => Promise<Uint8Array>;
7
+ export type VerificationMode = "offline" | "online";
8
+ export type VerificationErrorCode = "invalid-jws" | "invalid-header" | "unsupported-algorithm" | "invalid-signature" | "certificate-chain" | "certificate-policy" | "claim-policy" | "invalid-effective-time" | "online-unavailable" | "invalid-trust-anchor" | "ocsp-format" | "ocsp-policy" | "ocsp-status" | "ocsp-signature" | "ocsp-revoked" | "ocsp-unknown" | "ocsp-stale" | "transport-error";
9
+ export declare class VerificationError extends Error {
10
+ readonly code: VerificationErrorCode;
11
+ constructor(code: VerificationErrorCode, message: string, cause?: unknown);
12
+ }
13
+ export interface OcspPolicy {
14
+ /** Exact OCSP URLs allowed by the host. An omitted list permits no endpoints. */
15
+ readonly allowedEndpoints?: readonly string[];
16
+ readonly timeoutMs?: number;
17
+ readonly maxResponseBytes?: number;
18
+ readonly allowMissingNextUpdate?: boolean;
19
+ readonly maxAgeMs?: number;
20
+ /** Signature algorithm OIDs accepted for BasicOCSPResponse. */
21
+ readonly allowedSignatureAlgorithms?: readonly string[];
22
+ }
23
+ export interface VerifierPolicy {
24
+ readonly mode?: VerificationMode;
25
+ readonly algorithm?: "ES256";
26
+ readonly application?: string;
27
+ readonly environment?: string;
28
+ readonly claimPaths?: {
29
+ readonly application?: readonly string[];
30
+ readonly environment?: readonly string[];
31
+ };
32
+ /** Unix milliseconds at this exact payload path, read after signature verification. */
33
+ readonly signedTimePath?: readonly string[];
34
+ /** Extension OIDs that must be present in the named certificate. */
35
+ readonly requiredExtensions?: {
36
+ readonly leaf?: readonly string[];
37
+ readonly intermediate?: readonly string[];
38
+ };
39
+ readonly ocsp?: OcspPolicy;
40
+ readonly validateClaims?: (payload: unknown) => boolean;
41
+ }
42
+ export interface VerifierLimits {
43
+ readonly maxCompactJwsBytes?: number;
44
+ readonly maxProtectedHeaderBytes?: number;
45
+ readonly maxPayloadBytes?: number;
46
+ readonly maxX5cEntries?: number;
47
+ readonly maxCertificateBytes?: number;
48
+ /** Maximum number of prepared certificate chains retained per verifier instance. */
49
+ readonly maxCacheEntries?: number;
50
+ /** Maximum online cache lifetime before OCSP is checked again. */
51
+ readonly cacheTtlMs?: number;
52
+ }
53
+ export interface TrustedRoot {
54
+ readonly id?: string;
55
+ readonly der: Uint8Array;
56
+ }
57
+ export interface VerifierOptions {
58
+ readonly trustedRoots: readonly (Uint8Array | TrustedRoot)[];
59
+ readonly policy: VerifierPolicy;
60
+ /** Host clock for online verification. */
61
+ readonly clock?: () => number;
62
+ readonly limits?: VerifierLimits;
63
+ readonly ocspTransport?: OcspTransport;
64
+ }
65
+ export interface VerifyOptions {
66
+ /** Explicit Unix milliseconds for offline verification. Overrides signedTimePath. */
67
+ readonly effectiveTime?: number;
68
+ }
69
+ export interface VerifiedJws<TPayload = unknown> {
70
+ readonly compactJws: string;
71
+ readonly protectedHeader: Readonly<Record<string, unknown>>;
72
+ readonly payload: TPayload;
73
+ }
74
+ export declare class JwsVerifier {
75
+ #private;
76
+ private readonly preparation;
77
+ private readonly limits;
78
+ private readonly clock;
79
+ private readonly ocspTransport;
80
+ private readonly certificateCache;
81
+ constructor(options: VerifierOptions);
82
+ verify<TPayload = unknown>(compactJws: string, options?: VerifyOptions): Promise<VerifiedJws<TPayload>>;
83
+ verifySync<TPayload = unknown>(compactJws: string, options?: VerifyOptions): VerifiedJws<TPayload>;
84
+ private verifyOnline;
85
+ private requestOcsp;
86
+ private verifyOcsp;
87
+ private ensureCachedValidity;
88
+ private getCacheEntry;
89
+ private storeCacheEntry;
90
+ private prepareChain;
91
+ private verifyChain;
92
+ }
93
+ export declare const createVerifier: (options: VerifierOptions) => JwsVerifier;
94
+ //# sourceMappingURL=verifier.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../source/jws/verifier.ts"],"names":[],"mappings":"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"}