@wemush/wols 1.2.0 → 1.3.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/CHANGELOG.md +170 -0
- package/README.md +204 -31
- package/dist/cjs/compact-url.d.ts +150 -0
- package/dist/cjs/compact-url.d.ts.map +1 -0
- package/dist/cjs/crypto/decrypt.d.ts +110 -0
- package/dist/cjs/crypto/decrypt.d.ts.map +1 -0
- package/dist/cjs/crypto/decrypt.js +519 -99
- package/dist/cjs/crypto/decrypt.js.map +1 -1
- package/dist/cjs/crypto/encrypt.d.ts +132 -0
- package/dist/cjs/crypto/encrypt.d.ts.map +1 -0
- package/dist/cjs/crypto/encrypt.js +281 -200
- package/dist/cjs/crypto/encrypt.js.map +1 -1
- package/dist/cjs/crypto/index.d.ts +12 -0
- package/dist/cjs/crypto/index.d.ts.map +1 -0
- package/dist/cjs/crypto/index.js +15 -2
- package/dist/cjs/crypto/index.js.map +1 -1
- package/dist/cjs/crypto/shared.d.ts +116 -0
- package/dist/cjs/crypto/shared.d.ts.map +1 -0
- package/dist/cjs/crypto/shared.js +238 -0
- package/dist/cjs/crypto/shared.js.map +1 -0
- package/dist/cjs/errors.d.ts +133 -0
- package/dist/cjs/errors.d.ts.map +1 -0
- package/dist/cjs/errors.js +39 -1
- package/dist/cjs/errors.js.map +1 -1
- package/dist/cjs/index.d.ts +29 -0
- package/dist/cjs/index.d.ts.map +1 -0
- package/dist/cjs/index.js +19 -4
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/package.json +3 -0
- package/dist/cjs/parser.d.ts +30 -0
- package/dist/cjs/parser.d.ts.map +1 -0
- package/dist/cjs/qr/generate.d.ts +62 -0
- package/dist/cjs/qr/generate.d.ts.map +1 -0
- package/dist/cjs/qr/index.d.ts +10 -0
- package/dist/cjs/qr/index.d.ts.map +1 -0
- package/dist/cjs/specimen.d.ts +96 -0
- package/dist/cjs/specimen.d.ts.map +1 -0
- package/dist/cjs/specimen.js +84 -11
- package/dist/cjs/specimen.js.map +1 -1
- package/dist/cjs/types.d.ts +735 -0
- package/dist/cjs/types.d.ts.map +1 -0
- package/dist/cjs/types.js +65 -5
- package/dist/cjs/types.js.map +1 -1
- package/dist/cjs/utils/cuid.d.ts +46 -0
- package/dist/cjs/utils/cuid.d.ts.map +1 -0
- package/dist/cjs/utils/cuid.js +6 -4
- package/dist/cjs/utils/cuid.js.map +1 -1
- package/dist/cjs/utils/environment.d.ts +137 -0
- package/dist/cjs/utils/environment.d.ts.map +1 -0
- package/dist/cjs/utils/iso8601.d.ts +79 -0
- package/dist/cjs/utils/iso8601.d.ts.map +1 -0
- package/dist/cjs/utils/migration.d.ts +162 -0
- package/dist/cjs/utils/migration.d.ts.map +1 -0
- package/dist/cjs/validator.d.ts +25 -0
- package/dist/cjs/validator.d.ts.map +1 -0
- package/dist/cjs/validator.js +33 -22
- package/dist/cjs/validator.js.map +1 -1
- package/dist/esm/crypto/decrypt.js +515 -99
- package/dist/esm/crypto/decrypt.js.map +1 -1
- package/dist/esm/crypto/encrypt.js +277 -200
- package/dist/esm/crypto/encrypt.js.map +1 -1
- package/dist/esm/crypto/index.js +5 -3
- package/dist/esm/crypto/index.js.map +1 -1
- package/dist/esm/crypto/shared.js +222 -0
- package/dist/esm/crypto/shared.js.map +1 -0
- package/dist/esm/errors.js +37 -0
- package/dist/esm/errors.js.map +1 -1
- package/dist/esm/index.js +6 -6
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/specimen.js +84 -12
- package/dist/esm/specimen.js.map +1 -1
- package/dist/esm/types.js +63 -4
- package/dist/esm/types.js.map +1 -1
- package/dist/esm/utils/cuid.js +6 -4
- package/dist/esm/utils/cuid.js.map +1 -1
- package/dist/esm/validator.js +34 -23
- package/dist/esm/validator.js.map +1 -1
- package/dist/types/crypto/decrypt.d.ts +93 -22
- package/dist/types/crypto/decrypt.d.ts.map +1 -1
- package/dist/types/crypto/encrypt.d.ts +106 -61
- package/dist/types/crypto/encrypt.d.ts.map +1 -1
- package/dist/types/crypto/index.d.ts +5 -3
- package/dist/types/crypto/index.d.ts.map +1 -1
- package/dist/types/crypto/shared.d.ts +116 -0
- package/dist/types/crypto/shared.d.ts.map +1 -0
- package/dist/types/errors.d.ts +31 -1
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/index.d.ts +7 -7
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/specimen.d.ts +29 -4
- package/dist/types/specimen.d.ts.map +1 -1
- package/dist/types/types.d.ts +265 -40
- package/dist/types/types.d.ts.map +1 -1
- package/dist/types/utils/cuid.d.ts +5 -3
- package/dist/types/utils/cuid.d.ts.map +1 -1
- package/dist/types/validator.d.ts +1 -1
- package/dist/types/validator.d.ts.map +1 -1
- package/package.json +32 -14
|
@@ -1,253 +1,334 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
/**
|
|
3
|
-
* WOLS Encryption Module
|
|
3
|
+
* WOLS Encryption Module (WOLS v1.3.0 encrypted format)
|
|
4
4
|
*
|
|
5
|
-
*
|
|
6
|
-
* Supports both password-based (PBKDF2) and raw CryptoKey encryption.
|
|
5
|
+
* AES-256-GCM via WebCrypto, so it runs in Node.js 20+, browsers, Deno and Bun.
|
|
7
6
|
*
|
|
8
|
-
* ##
|
|
7
|
+
* ## Wire format
|
|
9
8
|
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
* - Self-describing payloads (iterations stored in output)
|
|
14
|
-
*
|
|
15
|
-
* ### Password vs CryptoKey
|
|
16
|
-
*
|
|
17
|
-
* | Input Type | Use Case | Security Level |
|
|
18
|
-
* |------------|----------|----------------|
|
|
19
|
-
* | `string` (password) | Simple sharing, QR codes | Good (depends on password strength) |
|
|
20
|
-
* | `CryptoKey` | Server-side, key management systems | Best (full control over key material) |
|
|
21
|
-
*
|
|
22
|
-
* ### Security Considerations
|
|
23
|
-
*
|
|
24
|
-
* 1. **Fixed Salt**: The PBKDF2 salt is fixed per crypto version. This is intentional
|
|
25
|
-
* for deterministic cross-environment key derivation. Password strength is critical.
|
|
26
|
-
*
|
|
27
|
-
* 2. **Iteration Count**: Default 100,000 iterations. Can be increased via `iterations`
|
|
28
|
-
* option for higher security (at cost of performance).
|
|
29
|
-
*
|
|
30
|
-
* 3. **Random IV**: Each encryption uses a cryptographically random 96-bit IV,
|
|
31
|
-
* ensuring identical plaintexts produce different ciphertexts.
|
|
32
|
-
*
|
|
33
|
-
* 4. **Authenticated Encryption**: AES-256-GCM provides both confidentiality and
|
|
34
|
-
* integrity - tampered ciphertext will fail decryption.
|
|
35
|
-
*
|
|
36
|
-
* ## Future Specification Updates (v1.2.1+)
|
|
37
|
-
*
|
|
38
|
-
* TODO(wols-spec): The following enhancements should be documented in the upstream
|
|
39
|
-
* WOLS specification (wemush/open-standard/SPECIFICATION.md) in a future release:
|
|
9
|
+
* ```
|
|
10
|
+
* wemush://v1/encrypted/{id}?e={ciphertext}&iv={iv}&kdf={pbkdf2|raw}[&salt={salt}&i={iterations}]
|
|
11
|
+
* ```
|
|
40
12
|
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
13
|
+
* - `e`: ciphertext with the 16-byte GCM tag appended
|
|
14
|
+
* - `iv`: fresh random 12-byte IV per encryption
|
|
15
|
+
* - All binary values are base64url without padding
|
|
43
16
|
*
|
|
44
|
-
*
|
|
45
|
-
* with recommended ranges (100k-600k) and minimum floor (10k).
|
|
17
|
+
* ## Keys
|
|
46
18
|
*
|
|
47
|
-
*
|
|
48
|
-
*
|
|
19
|
+
* | `key` value | `kdf` | Notes |
|
|
20
|
+
* |-------------|-------|-------|
|
|
21
|
+
* | `string` passphrase | `pbkdf2` | PBKDF2-HMAC-SHA256, fresh random 16-byte salt per label, ≥100,000 iterations |
|
|
22
|
+
* | 32-byte `Uint8Array` / `ArrayBuffer` | `raw` | Key shared out of band |
|
|
23
|
+
* | AES-GCM 256 `CryptoKey` | `raw` | Key shared out of band |
|
|
49
24
|
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
* - Password strength requirements
|
|
53
|
-
* - When to use CryptoKey vs password
|
|
54
|
-
* - Optional random salt for high-security scenarios (future v2)
|
|
25
|
+
* Pre-1.3.0 releases derived passphrase keys with a fixed library-wide salt.
|
|
26
|
+
* That scheme is never generated any more; see `allowLegacy` on decryption.
|
|
55
27
|
*
|
|
56
28
|
* @module crypto/encrypt
|
|
57
29
|
*/
|
|
58
30
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
31
|
+
exports.toEncryptedUrl = toEncryptedUrl;
|
|
59
32
|
exports.encryptSpecimen = encryptSpecimen;
|
|
33
|
+
exports.encryptFields = encryptFields;
|
|
34
|
+
exports.isEncryptedField = isEncryptedField;
|
|
35
|
+
exports.isEncryptedSpecimen = isEncryptedSpecimen;
|
|
60
36
|
exports.isEncrypted = isEncrypted;
|
|
37
|
+
const errors_js_1 = require("../errors.js");
|
|
61
38
|
const specimen_js_1 = require("../specimen.js");
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
*
|
|
75
|
-
* 2. **Offline decryption**: No need to store/transmit the salt alongside the
|
|
76
|
-
* encrypted payload - the salt is known from the library version.
|
|
77
|
-
*
|
|
78
|
-
* 3. **Version-aware migration**: The salt includes a version identifier
|
|
79
|
-
* (@wemush/wols/crypto/v1) allowing future versions to use different salts
|
|
80
|
-
* while maintaining backward compatibility for decryption.
|
|
81
|
-
*
|
|
82
|
-
* SECURITY NOTE: The fixed salt means password security depends entirely on
|
|
83
|
-
* password strength. Users should use strong, unique passwords. For maximum
|
|
84
|
-
* security, use a CryptoKey directly instead of a password string.
|
|
85
|
-
*
|
|
86
|
-
* @internal
|
|
87
|
-
*/
|
|
88
|
-
const PBKDF2_SALT = new TextEncoder().encode('@wemush/wols/crypto/v1');
|
|
89
|
-
/** Default number of PBKDF2 iterations */
|
|
90
|
-
const DEFAULT_PBKDF2_ITERATIONS = 100_000;
|
|
91
|
-
/** Minimum allowed PBKDF2 iterations (security floor) */
|
|
92
|
-
const MIN_PBKDF2_ITERATIONS = 10_000;
|
|
93
|
-
/** Current crypto schema version */
|
|
94
|
-
const CRYPTO_VERSION = 'v1';
|
|
95
|
-
/** IV length in bytes (96 bits = 12 bytes recommended for GCM) */
|
|
96
|
-
const IV_LENGTH = 12;
|
|
97
|
-
// =============================================================================
|
|
98
|
-
// UTILITY FUNCTIONS
|
|
99
|
-
// =============================================================================
|
|
100
|
-
/**
|
|
101
|
-
* Convert ArrayBuffer to base64url string
|
|
102
|
-
*/
|
|
103
|
-
function toBase64Url(buffer) {
|
|
104
|
-
const bytes = new Uint8Array(buffer);
|
|
105
|
-
let binary = '';
|
|
106
|
-
for (const byte of bytes) {
|
|
107
|
-
binary += String.fromCharCode(byte);
|
|
39
|
+
const shared_js_1 = require("./shared.js");
|
|
40
|
+
function encryptionError(message, code = errors_js_1.WolsErrorCode.ENCRYPTION_ERROR) {
|
|
41
|
+
throw new errors_js_1.WolsEncryptionError(code, message);
|
|
42
|
+
}
|
|
43
|
+
/** Generators MUST use 100,000 to 10,000,000 iterations (WOLS 1.3.0). */
|
|
44
|
+
function checkGenerateIterations(iterations) {
|
|
45
|
+
if (typeof iterations !== 'number' ||
|
|
46
|
+
!Number.isInteger(iterations) ||
|
|
47
|
+
iterations < shared_js_1.MIN_GENERATE_ITERATIONS ||
|
|
48
|
+
iterations > shared_js_1.MAX_ITERATIONS) {
|
|
49
|
+
return encryptionError(`PBKDF2 iterations must be an integer from ${shared_js_1.MIN_GENERATE_ITERATIONS} to ` +
|
|
50
|
+
`${shared_js_1.MAX_ITERATIONS}, got ${String(iterations)}`);
|
|
108
51
|
}
|
|
109
|
-
return
|
|
52
|
+
return iterations;
|
|
110
53
|
}
|
|
111
|
-
/**
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
54
|
+
/** Decode canonical, unpadded base64url, or throw an encryption error naming the parameter. */
|
|
55
|
+
function canonicalBytes(name, value) {
|
|
56
|
+
let bytes;
|
|
57
|
+
if (typeof value === 'string' && !value.includes('=')) {
|
|
58
|
+
try {
|
|
59
|
+
bytes = (0, shared_js_1.base64UrlDecode)(value);
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
bytes = undefined;
|
|
63
|
+
}
|
|
119
64
|
}
|
|
120
|
-
|
|
65
|
+
// Re-encoding catches non-canonical spellings (non-zero trailing bits) that
|
|
66
|
+
// decode to the same bytes as a different string.
|
|
67
|
+
if (bytes === undefined || (0, shared_js_1.base64UrlEncode)(bytes) !== value) {
|
|
68
|
+
return encryptionError(`${name} must be canonical base64url without padding`);
|
|
69
|
+
}
|
|
70
|
+
return bytes;
|
|
71
|
+
}
|
|
72
|
+
function bytesEqual(a, b) {
|
|
73
|
+
return a.length === b.length && a.every((byte, i) => byte === b[i]);
|
|
121
74
|
}
|
|
75
|
+
/** Identifying fields (WOLS 1.3.0) stay in cleartext so labels remain routable. */
|
|
76
|
+
const STRUCTURAL_FIELDS = new Set(shared_js_1.IDENTIFYING_FIELDS);
|
|
122
77
|
/**
|
|
123
|
-
*
|
|
78
|
+
* Turn the caller's key into an AES key plus the parameters to record.
|
|
79
|
+
* A passphrase gets a fresh random salt for every call (one call = one label).
|
|
124
80
|
*/
|
|
125
|
-
async function
|
|
126
|
-
const
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
81
|
+
async function resolveEncryptionKey(options) {
|
|
82
|
+
const { key } = options;
|
|
83
|
+
if ((0, shared_js_1.isPassphrase)(key)) {
|
|
84
|
+
const iterations = checkGenerateIterations(options.iterations ?? shared_js_1.DEFAULT_PBKDF2_ITERATIONS);
|
|
85
|
+
const salt = (0, shared_js_1.randomBytes)(shared_js_1.SALT_LENGTH);
|
|
86
|
+
const keyBytes = await (0, shared_js_1.derivePassphraseKey)(key, salt, iterations);
|
|
87
|
+
return {
|
|
88
|
+
cryptoKey: await (0, shared_js_1.importAesKey)(keyBytes, 'encrypt'),
|
|
89
|
+
kdf: 'pbkdf2',
|
|
90
|
+
salt: (0, shared_js_1.base64UrlEncode)(salt),
|
|
91
|
+
iterations,
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
if ((0, shared_js_1.isRawKey)(key)) {
|
|
95
|
+
const resolved = await (0, shared_js_1.resolveRawKey)(key, 'encrypt');
|
|
96
|
+
if (typeof resolved === 'string') {
|
|
97
|
+
encryptionError(resolved, errors_js_1.WolsErrorCode.INVALID_KEY);
|
|
98
|
+
}
|
|
99
|
+
return { cryptoKey: resolved, kdf: 'raw' };
|
|
100
|
+
}
|
|
101
|
+
return encryptionError('key must be a passphrase string, 32 raw key bytes, or an AES-GCM CryptoKey', errors_js_1.WolsErrorCode.INVALID_KEY);
|
|
139
102
|
}
|
|
140
103
|
/**
|
|
141
|
-
*
|
|
104
|
+
* AES-256-GCM encrypt UTF-8 text with a fresh IV. The tag is appended by
|
|
105
|
+
* WebCrypto. `aad` is used for field-level values only; whole labels have none.
|
|
142
106
|
*/
|
|
143
|
-
function
|
|
144
|
-
const
|
|
145
|
-
const
|
|
146
|
-
crypto.
|
|
147
|
-
return {
|
|
107
|
+
async function seal(cryptoKey, text, aad) {
|
|
108
|
+
const iv = (0, shared_js_1.randomBytes)(shared_js_1.IV_LENGTH);
|
|
109
|
+
const params = aad === undefined ? { name: 'AES-GCM', iv } : { name: 'AES-GCM', iv, additionalData: aad };
|
|
110
|
+
const ciphertext = await crypto.subtle.encrypt(params, cryptoKey, new TextEncoder().encode(text));
|
|
111
|
+
return { payload: (0, shared_js_1.base64UrlEncode)(ciphertext), iv: (0, shared_js_1.base64UrlEncode)(iv) };
|
|
112
|
+
}
|
|
113
|
+
/** Split `wemush:{suffix}` into its suffix, enforcing a non-empty suffix. */
|
|
114
|
+
function idSuffix(id) {
|
|
115
|
+
if (typeof id !== 'string' || !id.startsWith('wemush:') || id.length === 'wemush:'.length) {
|
|
116
|
+
encryptionError(`Specimen id must be 'wemush:' followed by a non-empty suffix, got '${String(id)}'`);
|
|
117
|
+
}
|
|
118
|
+
return id.slice('wemush:'.length);
|
|
148
119
|
}
|
|
149
120
|
// =============================================================================
|
|
150
|
-
//
|
|
121
|
+
// URL SERIALIZATION
|
|
151
122
|
// =============================================================================
|
|
152
123
|
/**
|
|
153
|
-
*
|
|
124
|
+
* Build the encrypted-format URL for an encrypted specimen.
|
|
154
125
|
*
|
|
155
|
-
*
|
|
156
|
-
*
|
|
157
|
-
*
|
|
126
|
+
* Enforces the generator rules, so a hand-built object cannot produce a
|
|
127
|
+
* non-conformant label:
|
|
128
|
+
* - `payload` and `iv` are canonical unpadded base64url, the IV is 12 bytes,
|
|
129
|
+
* and the payload is at least the 16-byte GCM tag
|
|
130
|
+
* - `kdf` is present: `pbkdf2` needs 100,000 to 2^32-1 iterations and a salt
|
|
131
|
+
* of at least 16 bytes that is not the legacy library salt (compared as
|
|
132
|
+
* bytes); `raw` must not carry `salt` or `iterations`
|
|
158
133
|
*
|
|
159
|
-
*
|
|
160
|
-
*
|
|
161
|
-
*
|
|
162
|
-
*
|
|
163
|
-
*
|
|
164
|
-
*
|
|
165
|
-
* key: 'my-secret-password',
|
|
166
|
-
* });
|
|
167
|
-
*
|
|
168
|
-
* // Higher security with custom iterations
|
|
169
|
-
* const secureEncrypted = await encryptSpecimen(specimen, {
|
|
170
|
-
* key: 'my-secret-password',
|
|
171
|
-
* iterations: 300_000,
|
|
172
|
-
* });
|
|
173
|
-
* // Returns: { encrypted: true, payload: "...", iv: "...", algorithm: "AES-256-GCM", cryptoVersion: "v1", iterations: 300000 }
|
|
174
|
-
* ```
|
|
134
|
+
* Labels with more than 10,000,000 iterations are valid but exceed the
|
|
135
|
+
* decoders' default `maxIterations`, so readers must raise it.
|
|
136
|
+
*
|
|
137
|
+
* @throws WolsEncryptionError when the object would produce a non-conformant
|
|
138
|
+
* label (including legacy payloads, which are never generated)
|
|
139
|
+
* @since 1.3.0
|
|
175
140
|
*/
|
|
141
|
+
function toEncryptedUrl(encrypted) {
|
|
142
|
+
const suffix = idSuffix(encrypted.id);
|
|
143
|
+
if (encrypted.kdf !== 'pbkdf2' && encrypted.kdf !== 'raw') {
|
|
144
|
+
encryptionError('Encrypted URLs require kdf=pbkdf2 or kdf=raw; legacy payloads are not generated');
|
|
145
|
+
}
|
|
146
|
+
if (canonicalBytes('payload', encrypted.payload).length < shared_js_1.GCM_TAG_LENGTH) {
|
|
147
|
+
encryptionError(`payload must include the ${shared_js_1.GCM_TAG_LENGTH}-byte GCM tag`);
|
|
148
|
+
}
|
|
149
|
+
if (canonicalBytes('iv', encrypted.iv).length !== shared_js_1.IV_LENGTH) {
|
|
150
|
+
encryptionError(`iv must be ${shared_js_1.IV_LENGTH} bytes`);
|
|
151
|
+
}
|
|
152
|
+
const params = [`e=${encrypted.payload}`, `iv=${encrypted.iv}`, `kdf=${encrypted.kdf}`];
|
|
153
|
+
if (encrypted.kdf === 'pbkdf2') {
|
|
154
|
+
const { salt } = encrypted;
|
|
155
|
+
if (!salt || encrypted.iterations === undefined) {
|
|
156
|
+
encryptionError('kdf=pbkdf2 requires salt and iterations');
|
|
157
|
+
}
|
|
158
|
+
const iterations = checkGenerateIterations(encrypted.iterations);
|
|
159
|
+
const saltBytes = canonicalBytes('salt', salt);
|
|
160
|
+
if (saltBytes.length < shared_js_1.SALT_LENGTH) {
|
|
161
|
+
encryptionError(`salt must be at least ${shared_js_1.SALT_LENGTH} bytes, got ${saltBytes.length}`);
|
|
162
|
+
}
|
|
163
|
+
if (bytesEqual(saltBytes, shared_js_1.LEGACY_PBKDF2_SALT)) {
|
|
164
|
+
encryptionError('The fixed pre-1.3.0 library salt must not be used to generate labels');
|
|
165
|
+
}
|
|
166
|
+
params.push(`salt=${salt}`, `i=${iterations}`);
|
|
167
|
+
}
|
|
168
|
+
else if (encrypted.salt !== undefined || encrypted.iterations !== undefined) {
|
|
169
|
+
encryptionError('kdf=raw labels must not carry salt or iterations');
|
|
170
|
+
}
|
|
171
|
+
if (encrypted.signature !== undefined) {
|
|
172
|
+
params.push(`sig=${encodeURIComponent(encrypted.signature)}`);
|
|
173
|
+
}
|
|
174
|
+
return `${shared_js_1.ENCRYPTED_URL_PREFIX}${encodeURIComponent(suffix)}?${params.join('&')}`;
|
|
175
|
+
}
|
|
176
176
|
async function encryptSpecimen(specimen, options) {
|
|
177
|
-
|
|
178
|
-
|
|
177
|
+
(0, shared_js_1.assertWebCrypto)();
|
|
178
|
+
const { fields } = options;
|
|
179
179
|
if (fields !== undefined && fields.length > 0) {
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
const
|
|
193
|
-
|
|
194
|
-
const
|
|
195
|
-
|
|
196
|
-
|
|
180
|
+
// Deprecated 1.2.x path: same behavior as encryptFields(). A call that
|
|
181
|
+
// passes `fields` literally is typed FieldEncryptedSpecimen by the first
|
|
182
|
+
// overload; options typed as plain EncryptionOptions keep the 1.2.x
|
|
183
|
+
// signature for source compatibility, which is why the option is deprecated.
|
|
184
|
+
const fieldOptions = {
|
|
185
|
+
key: options.key,
|
|
186
|
+
fields: fields,
|
|
187
|
+
};
|
|
188
|
+
if (options.iterations !== undefined)
|
|
189
|
+
fieldOptions.iterations = options.iterations;
|
|
190
|
+
return encryptFields(specimen, fieldOptions);
|
|
191
|
+
}
|
|
192
|
+
const id = specimen.id;
|
|
193
|
+
idSuffix(id);
|
|
194
|
+
const resolved = await resolveEncryptionKey(options);
|
|
195
|
+
const sealed = await seal(resolved.cryptoKey, (0, specimen_js_1.serializeSpecimen)(specimen));
|
|
196
|
+
const result = {
|
|
197
197
|
encrypted: true,
|
|
198
|
-
payload: toBase64Url(ciphertext),
|
|
199
|
-
iv: toBase64Url(ivBuffer),
|
|
200
198
|
algorithm: 'AES-256-GCM',
|
|
201
|
-
|
|
202
|
-
|
|
199
|
+
payload: sealed.payload,
|
|
200
|
+
iv: sealed.iv,
|
|
201
|
+
kdf: resolved.kdf,
|
|
202
|
+
id,
|
|
203
203
|
};
|
|
204
|
+
if (resolved.salt !== undefined)
|
|
205
|
+
result.salt = resolved.salt;
|
|
206
|
+
if (resolved.iterations !== undefined)
|
|
207
|
+
result.iterations = resolved.iterations;
|
|
208
|
+
result.url = toEncryptedUrl(result);
|
|
209
|
+
return result;
|
|
204
210
|
}
|
|
205
211
|
/**
|
|
206
|
-
*
|
|
212
|
+
* Field-level encryption (WOLS v1.3.0): replace the value of each named field
|
|
213
|
+
* with an {@link EncryptedField} and leave the rest of the specimen in cleartext.
|
|
207
214
|
*
|
|
208
|
-
*
|
|
215
|
+
* One key (and, for passphrases, one random salt) per call; a fresh IV per field.
|
|
216
|
+
* Each value is bound to its label and field with AES-GCM additional data:
|
|
217
|
+
* the UTF-8 of `"{id}\n{field}"` (WOLS 1.3.0). A value moved to another field
|
|
218
|
+
* or copied into another label fails authentication. Restore with `decryptFields()`.
|
|
219
|
+
*
|
|
220
|
+
* The identifying fields (`@context`, `@type`, `id`, `version`, `type`,
|
|
221
|
+
* `species`) can't be encrypted.
|
|
222
|
+
*
|
|
223
|
+
* @param specimen - The specimen to partially encrypt
|
|
224
|
+
* @param options - `key`, `fields` (each must be present on the specimen), optional `iterations`
|
|
225
|
+
* @throws WolsEncryptionError when `fields` is empty, names a field the specimen
|
|
226
|
+
* does not have, or names a field twice; or for an unusable key
|
|
227
|
+
*
|
|
228
|
+
* @example
|
|
229
|
+
* ```typescript
|
|
230
|
+
* const partial = await encryptFields(specimen, { key: passphrase, fields: ['strain'] });
|
|
231
|
+
* partial.species; // still cleartext
|
|
232
|
+
* partial.strain; // { encrypted: true, algorithm: 'AES-256-GCM', payload, iv, kdf: 'pbkdf2', salt, iterations }
|
|
233
|
+
* ```
|
|
234
|
+
*
|
|
235
|
+
* @since 1.3.0
|
|
209
236
|
*/
|
|
210
|
-
async function
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
//
|
|
217
|
-
|
|
218
|
-
|
|
237
|
+
async function encryptFields(specimen, options) {
|
|
238
|
+
(0, shared_js_1.assertWebCrypto)();
|
|
239
|
+
const { fields } = options;
|
|
240
|
+
if (!Array.isArray(fields) || fields.length === 0) {
|
|
241
|
+
encryptionError('encryptFields requires a non-empty fields array');
|
|
242
|
+
}
|
|
243
|
+
// The AAD binds every value to the label's full id, so the id must be usable.
|
|
244
|
+
idSuffix(specimen.id);
|
|
245
|
+
const seen = new Set();
|
|
219
246
|
for (const field of fields) {
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
result[field] = {
|
|
227
|
-
encrypted: true,
|
|
228
|
-
payload: toBase64Url(ciphertext),
|
|
229
|
-
iv: toBase64Url(ivBuffer),
|
|
230
|
-
algorithm: 'AES-256-GCM',
|
|
231
|
-
cryptoVersion: CRYPTO_VERSION,
|
|
232
|
-
iterations,
|
|
233
|
-
};
|
|
247
|
+
if (typeof field === 'string' && STRUCTURAL_FIELDS.has(field)) {
|
|
248
|
+
encryptionError(`Cannot encrypt field '${field}': it identifies the label and must stay in cleartext`);
|
|
249
|
+
}
|
|
250
|
+
if (typeof field !== 'string' || !Object.hasOwn(specimen, field)) {
|
|
251
|
+
encryptionError(`Cannot encrypt field '${String(field)}': the specimen has no such field. ` +
|
|
252
|
+
'Refusing to leave it unprotected.');
|
|
234
253
|
}
|
|
254
|
+
if (specimen[field] === undefined) {
|
|
255
|
+
encryptionError(`Cannot encrypt field '${field}': its value is undefined`);
|
|
256
|
+
}
|
|
257
|
+
if (seen.has(field)) {
|
|
258
|
+
encryptionError(`Field '${field}' is listed more than once`);
|
|
259
|
+
}
|
|
260
|
+
seen.add(field);
|
|
261
|
+
}
|
|
262
|
+
const keyOptions = { key: options.key };
|
|
263
|
+
if (options.iterations !== undefined)
|
|
264
|
+
keyOptions.iterations = options.iterations;
|
|
265
|
+
const resolved = await resolveEncryptionKey(keyOptions);
|
|
266
|
+
const result = { ...specimen };
|
|
267
|
+
for (const field of fields) {
|
|
268
|
+
// Fresh IV per field; AAD = "{id}\n{field}" (WOLS 1.3.0).
|
|
269
|
+
const sealed = await seal(resolved.cryptoKey, JSON.stringify(result[field]), (0, shared_js_1.fieldAad)(specimen.id, field));
|
|
270
|
+
const encryptedField = {
|
|
271
|
+
encrypted: true,
|
|
272
|
+
algorithm: 'AES-256-GCM',
|
|
273
|
+
payload: sealed.payload,
|
|
274
|
+
iv: sealed.iv,
|
|
275
|
+
kdf: resolved.kdf,
|
|
276
|
+
};
|
|
277
|
+
if (resolved.salt !== undefined)
|
|
278
|
+
encryptedField.salt = resolved.salt;
|
|
279
|
+
if (resolved.iterations !== undefined)
|
|
280
|
+
encryptedField.iterations = resolved.iterations;
|
|
281
|
+
result[field] = encryptedField;
|
|
235
282
|
}
|
|
236
|
-
// Cast to EncryptedSpecimen for return type consistency
|
|
237
|
-
// In partial mode, this is actually a hybrid object
|
|
238
283
|
return result;
|
|
239
284
|
}
|
|
285
|
+
// =============================================================================
|
|
286
|
+
// TYPE GUARDS
|
|
287
|
+
// =============================================================================
|
|
288
|
+
function hasCipherShape(value) {
|
|
289
|
+
return (typeof value === 'object' &&
|
|
290
|
+
value !== null &&
|
|
291
|
+
value['encrypted'] === true &&
|
|
292
|
+
typeof value['payload'] === 'string' &&
|
|
293
|
+
typeof value['iv'] === 'string');
|
|
294
|
+
}
|
|
295
|
+
/**
|
|
296
|
+
* Whether a value is a field-level {@link EncryptedField}: an encrypted value
|
|
297
|
+
* with a `kdf` and no specimen `id` or `url`.
|
|
298
|
+
*
|
|
299
|
+
* The 1.3.0 shapes are told apart structurally: whole-label objects produced
|
|
300
|
+
* by `encryptSpecimen` and `parseEncryptedUrl` always carry `id`, and field
|
|
301
|
+
* values never do. Legacy (pre-1.3.0) values have no `kdf` and are reported
|
|
302
|
+
* as {@link isEncryptedSpecimen}, whether they were whole labels or fields.
|
|
303
|
+
* `decryptFields` handles legacy field values regardless (with `allowLegacy`).
|
|
304
|
+
*
|
|
305
|
+
* @since 1.3.0
|
|
306
|
+
*/
|
|
307
|
+
function isEncryptedField(value) {
|
|
308
|
+
return (hasCipherShape(value) &&
|
|
309
|
+
(value['kdf'] === 'pbkdf2' || value['kdf'] === 'raw') &&
|
|
310
|
+
value['id'] === undefined &&
|
|
311
|
+
value['url'] === undefined);
|
|
312
|
+
}
|
|
313
|
+
/**
|
|
314
|
+
* Whether a value is a whole-label {@link EncryptedSpecimen} (v1.3.0 or legacy).
|
|
315
|
+
*
|
|
316
|
+
* @since 1.3.0
|
|
317
|
+
*/
|
|
318
|
+
function isEncryptedSpecimen(value) {
|
|
319
|
+
return hasCipherShape(value) && !isEncryptedField(value);
|
|
320
|
+
}
|
|
240
321
|
/**
|
|
241
|
-
*
|
|
322
|
+
* Whether a value carries the `encrypted: true` marker: either a whole-label
|
|
323
|
+
* {@link EncryptedSpecimen} or a field-level {@link EncryptedField}. Use
|
|
324
|
+
* {@link isEncryptedSpecimen} or {@link isEncryptedField} to tell them apart.
|
|
325
|
+
*
|
|
326
|
+
* @since 1.3.0 Narrows to `EncryptedSpecimen | EncryptedField`
|
|
242
327
|
*/
|
|
243
328
|
function isEncrypted(value) {
|
|
244
|
-
if (value === null || value === undefined) {
|
|
245
|
-
return false;
|
|
246
|
-
}
|
|
247
|
-
if (typeof value !== 'object') {
|
|
329
|
+
if (value === null || value === undefined || typeof value !== 'object') {
|
|
248
330
|
return false;
|
|
249
331
|
}
|
|
250
|
-
|
|
251
|
-
return obj['encrypted'] === true;
|
|
332
|
+
return value['encrypted'] === true;
|
|
252
333
|
}
|
|
253
334
|
//# sourceMappingURL=encrypt.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"encrypt.js","sourceRoot":"","sources":["../../../src/crypto/encrypt.ts"],"names":[],"mappings":";AAAA
|
|
1
|
+
{"version":3,"file":"encrypt.js","sourceRoot":"","sources":["../../../src/crypto/encrypt.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;AA8KH,wCAmCC;AAuCD,0CAoCC;AA4BD,sCA0DC;AA4BD,4CAOC;AAOD,kDAEC;AASD,kCAKC;AA1aD,4CAAkE;AAClE,gDAAmD;AAYnD,2CAoBqB;AAarB,SAAS,eAAe,CAAC,OAAe,EAAE,IAAI,GAAG,yBAAa,CAAC,gBAAgB;IAC7E,MAAM,IAAI,+BAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,yEAAyE;AACzE,SAAS,uBAAuB,CAAC,UAAmB;IAClD,IACE,OAAO,UAAU,KAAK,QAAQ;QAC9B,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC;QAC7B,UAAU,GAAG,mCAAuB;QACpC,UAAU,GAAG,0BAAc,EAC3B,CAAC;QACD,OAAO,eAAe,CACpB,6CAA6C,mCAAuB,MAAM;YACxE,GAAG,0BAAc,SAAS,MAAM,CAAC,UAAU,CAAC,EAAE,CACjD,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,+FAA+F;AAC/F,SAAS,cAAc,CAAC,IAAY,EAAE,KAAc;IAClD,IAAI,KAA6B,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,KAAK,GAAG,IAAA,2BAAe,EAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;IACH,CAAC;IACD,4EAA4E;IAC5E,kDAAkD;IAClD,IAAI,KAAK,KAAK,SAAS,IAAI,IAAA,2BAAe,EAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;QAC5D,OAAO,eAAe,CAAC,GAAG,IAAI,8CAA8C,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,CAAa,EAAE,CAAa;IAC9C,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,mFAAmF;AACnF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,8BAAkB,CAAC,CAAC;AAEtD;;;GAGG;AACH,KAAK,UAAU,oBAAoB,CAAC,OAA0B;IAC5D,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAExB,IAAI,IAAA,wBAAY,EAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,UAAU,IAAI,qCAAyB,CAAC,CAAC;QAC5F,MAAM,IAAI,GAAG,IAAA,uBAAW,EAAC,uBAAW,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAmB,EAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAClE,OAAO;YACL,SAAS,EAAE,MAAM,IAAA,wBAAY,EAAC,QAAQ,EAAE,SAAS,CAAC;YAClD,GAAG,EAAE,QAAQ;YACb,IAAI,EAAE,IAAA,2BAAe,EAAC,IAAI,CAAC;YAC3B,UAAU;SACX,CAAC;IACJ,CAAC;IAED,IAAI,IAAA,oBAAQ,EAAC,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAa,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,eAAe,CAAC,QAAQ,EAAE,yBAAa,CAAC,WAAW,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,eAAe,CACpB,4EAA4E,EAC5E,yBAAa,CAAC,WAAW,CAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,IAAI,CACjB,SAAoB,EACpB,IAAY,EACZ,GAA6B;IAE7B,MAAM,EAAE,GAAG,IAAA,uBAAW,EAAC,qBAAS,CAAC,CAAC;IAClC,MAAM,MAAM,GACV,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;IAC7F,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAClG,OAAO,EAAE,OAAO,EAAE,IAAA,2BAAe,EAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAA,2BAAe,EAAC,EAAE,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,EAAW;IAC3B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1F,eAAe,CACb,sEAAsE,MAAM,CAAC,EAAE,CAAC,GAAG,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,cAAc,CAAC,SAA4B;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,SAAS,CAAC,GAAG,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;QAC1D,eAAe,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,IAAI,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,0BAAc,EAAE,CAAC;QACzE,eAAe,CAAC,4BAA4B,0BAAc,eAAe,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,qBAAS,EAAE,CAAC;QAC5D,eAAe,CAAC,cAAc,qBAAS,QAAQ,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,KAAK,SAAS,CAAC,OAAO,EAAE,EAAE,MAAM,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IACxF,IAAI,SAAS,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAChD,eAAe,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,UAAU,GAAG,uBAAuB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,SAAS,CAAC,MAAM,GAAG,uBAAW,EAAE,CAAC;YACnC,eAAe,CAAC,yBAAyB,uBAAW,eAAe,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,UAAU,CAAC,SAAS,EAAE,8BAAkB,CAAC,EAAE,CAAC;YAC9C,eAAe,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,KAAK,UAAU,EAAE,CAAC,CAAC;IACjD,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC9E,eAAe,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,gCAAoB,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACpF,CAAC;AAuCM,KAAK,UAAU,eAAe,CACnC,QAAkB,EAClB,OAA0B;IAE1B,IAAA,2BAAe,GAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,uEAAuE;QACvE,yEAAyE;QACzE,oEAAoE;QACpE,6EAA6E;QAC7E,MAAM,YAAY,GAA2B;YAC3C,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,MAAqC;SAC9C,CAAC;QACF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,YAAY,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACnF,OAAO,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,CAAC;IACb,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAA,+BAAiB,EAAC,QAAQ,CAAC,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAsB;QAChC,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,EAAE;KACH,CAAC;IACF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC7D,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IAC/E,MAAM,CAAC,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,aAAa,CACjC,QAAkB,EAClB,OAAkC;IAElC,IAAA,2BAAe,GAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,eAAe,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,eAAe,CACb,yBAAyB,KAAK,uDAAuD,CACtF,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;YACjE,eAAe,CACb,yBAAyB,MAAM,CAAC,KAAK,CAAC,qCAAqC;gBACzE,mCAAmC,CACtC,CAAC;QACJ,CAAC;QACD,IAAK,QAA+C,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1E,eAAe,CAAC,yBAAyB,KAAK,2BAA2B,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,eAAe,CAAC,UAAU,KAAK,4BAA4B,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAsB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3D,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;QAAE,UAAU,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACjF,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAA6B,CAAC;IAE1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,0DAA0D;QAC1D,MAAM,MAAM,GAAG,MAAM,IAAI,CACvB,QAAQ,CAAC,SAAS,EAClB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAC7B,IAAA,oBAAQ,EAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAC7B,CAAC;QACF,MAAM,cAAc,GAAmB;YACrC,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,EAAE,QAAQ,CAAC,GAAG;SAClB,CAAC;QACF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,cAAc,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QACrE,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS;YAAE,cAAc,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QACvF,MAAM,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC;IACjC,CAAC;IAED,OAAO,MAAqC,CAAC;AAC/C,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,WAAW,CAAC,KAAK,IAAI;QACxD,OAAQ,KAAiC,CAAC,SAAS,CAAC,KAAK,QAAQ;QACjE,OAAQ,KAAiC,CAAC,IAAI,CAAC,KAAK,QAAQ,CAC7D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,cAAc,CAAC,KAAK,CAAC;QACrB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS;QACzB,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,CAC3B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAQ,KAAiC,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;AAClE,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* WOLS Crypto Module
|
|
3
|
+
*
|
|
4
|
+
* AES-256-GCM encryption and decryption for specimens in the WOLS v1.3.0
|
|
5
|
+
* encrypted format (`wemush://v1/encrypted/{id}?e=&iv=&kdf=...`).
|
|
6
|
+
*
|
|
7
|
+
* @module crypto
|
|
8
|
+
*/
|
|
9
|
+
export { encryptSpecimen, encryptFields, isEncrypted, isEncryptedSpecimen, isEncryptedField, toEncryptedUrl, } from './encrypt.js';
|
|
10
|
+
export { decryptSpecimen, decryptPlaintext, decryptField, decryptFields, parseEncryptedUrl, type FieldBinding, } from './decrypt.js';
|
|
11
|
+
export { base64UrlEncode, base64UrlDecode, derivePassphraseKey } from './shared.js';
|
|
12
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/crypto/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
|