@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.
Files changed (98) hide show
  1. package/CHANGELOG.md +170 -0
  2. package/README.md +204 -31
  3. package/dist/cjs/compact-url.d.ts +150 -0
  4. package/dist/cjs/compact-url.d.ts.map +1 -0
  5. package/dist/cjs/crypto/decrypt.d.ts +110 -0
  6. package/dist/cjs/crypto/decrypt.d.ts.map +1 -0
  7. package/dist/cjs/crypto/decrypt.js +519 -99
  8. package/dist/cjs/crypto/decrypt.js.map +1 -1
  9. package/dist/cjs/crypto/encrypt.d.ts +132 -0
  10. package/dist/cjs/crypto/encrypt.d.ts.map +1 -0
  11. package/dist/cjs/crypto/encrypt.js +281 -200
  12. package/dist/cjs/crypto/encrypt.js.map +1 -1
  13. package/dist/cjs/crypto/index.d.ts +12 -0
  14. package/dist/cjs/crypto/index.d.ts.map +1 -0
  15. package/dist/cjs/crypto/index.js +15 -2
  16. package/dist/cjs/crypto/index.js.map +1 -1
  17. package/dist/cjs/crypto/shared.d.ts +116 -0
  18. package/dist/cjs/crypto/shared.d.ts.map +1 -0
  19. package/dist/cjs/crypto/shared.js +238 -0
  20. package/dist/cjs/crypto/shared.js.map +1 -0
  21. package/dist/cjs/errors.d.ts +133 -0
  22. package/dist/cjs/errors.d.ts.map +1 -0
  23. package/dist/cjs/errors.js +39 -1
  24. package/dist/cjs/errors.js.map +1 -1
  25. package/dist/cjs/index.d.ts +29 -0
  26. package/dist/cjs/index.d.ts.map +1 -0
  27. package/dist/cjs/index.js +19 -4
  28. package/dist/cjs/index.js.map +1 -1
  29. package/dist/cjs/package.json +3 -0
  30. package/dist/cjs/parser.d.ts +30 -0
  31. package/dist/cjs/parser.d.ts.map +1 -0
  32. package/dist/cjs/qr/generate.d.ts +62 -0
  33. package/dist/cjs/qr/generate.d.ts.map +1 -0
  34. package/dist/cjs/qr/index.d.ts +10 -0
  35. package/dist/cjs/qr/index.d.ts.map +1 -0
  36. package/dist/cjs/specimen.d.ts +96 -0
  37. package/dist/cjs/specimen.d.ts.map +1 -0
  38. package/dist/cjs/specimen.js +84 -11
  39. package/dist/cjs/specimen.js.map +1 -1
  40. package/dist/cjs/types.d.ts +735 -0
  41. package/dist/cjs/types.d.ts.map +1 -0
  42. package/dist/cjs/types.js +65 -5
  43. package/dist/cjs/types.js.map +1 -1
  44. package/dist/cjs/utils/cuid.d.ts +46 -0
  45. package/dist/cjs/utils/cuid.d.ts.map +1 -0
  46. package/dist/cjs/utils/cuid.js +6 -4
  47. package/dist/cjs/utils/cuid.js.map +1 -1
  48. package/dist/cjs/utils/environment.d.ts +137 -0
  49. package/dist/cjs/utils/environment.d.ts.map +1 -0
  50. package/dist/cjs/utils/iso8601.d.ts +79 -0
  51. package/dist/cjs/utils/iso8601.d.ts.map +1 -0
  52. package/dist/cjs/utils/migration.d.ts +162 -0
  53. package/dist/cjs/utils/migration.d.ts.map +1 -0
  54. package/dist/cjs/validator.d.ts +25 -0
  55. package/dist/cjs/validator.d.ts.map +1 -0
  56. package/dist/cjs/validator.js +33 -22
  57. package/dist/cjs/validator.js.map +1 -1
  58. package/dist/esm/crypto/decrypt.js +515 -99
  59. package/dist/esm/crypto/decrypt.js.map +1 -1
  60. package/dist/esm/crypto/encrypt.js +277 -200
  61. package/dist/esm/crypto/encrypt.js.map +1 -1
  62. package/dist/esm/crypto/index.js +5 -3
  63. package/dist/esm/crypto/index.js.map +1 -1
  64. package/dist/esm/crypto/shared.js +222 -0
  65. package/dist/esm/crypto/shared.js.map +1 -0
  66. package/dist/esm/errors.js +37 -0
  67. package/dist/esm/errors.js.map +1 -1
  68. package/dist/esm/index.js +6 -6
  69. package/dist/esm/index.js.map +1 -1
  70. package/dist/esm/specimen.js +84 -12
  71. package/dist/esm/specimen.js.map +1 -1
  72. package/dist/esm/types.js +63 -4
  73. package/dist/esm/types.js.map +1 -1
  74. package/dist/esm/utils/cuid.js +6 -4
  75. package/dist/esm/utils/cuid.js.map +1 -1
  76. package/dist/esm/validator.js +34 -23
  77. package/dist/esm/validator.js.map +1 -1
  78. package/dist/types/crypto/decrypt.d.ts +93 -22
  79. package/dist/types/crypto/decrypt.d.ts.map +1 -1
  80. package/dist/types/crypto/encrypt.d.ts +106 -61
  81. package/dist/types/crypto/encrypt.d.ts.map +1 -1
  82. package/dist/types/crypto/index.d.ts +5 -3
  83. package/dist/types/crypto/index.d.ts.map +1 -1
  84. package/dist/types/crypto/shared.d.ts +116 -0
  85. package/dist/types/crypto/shared.d.ts.map +1 -0
  86. package/dist/types/errors.d.ts +31 -1
  87. package/dist/types/errors.d.ts.map +1 -1
  88. package/dist/types/index.d.ts +7 -7
  89. package/dist/types/index.d.ts.map +1 -1
  90. package/dist/types/specimen.d.ts +29 -4
  91. package/dist/types/specimen.d.ts.map +1 -1
  92. package/dist/types/types.d.ts +265 -40
  93. package/dist/types/types.d.ts.map +1 -1
  94. package/dist/types/utils/cuid.d.ts +5 -3
  95. package/dist/types/utils/cuid.d.ts.map +1 -1
  96. package/dist/types/validator.d.ts +1 -1
  97. package/dist/types/validator.d.ts.map +1 -1
  98. 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
- * Provides AES-256-GCM encryption for specimens using Web Crypto API.
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
- * ## Security Model
7
+ * ## Wire format
9
8
  *
10
- * This module implements a **deterministic key derivation** model optimized for:
11
- * - Cross-environment compatibility (browser + Node.js)
12
- * - Offline decryption (no external key storage needed)
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
- * 1. **EncryptedSpecimen schema**: Define the `cryptoVersion` and `iterations` fields
42
- * in the encrypted payload format section.
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
- * 2. **Configurable iterations**: Document the `iterations` option in EncryptionOptions
45
- * with recommended ranges (100k-600k) and minimum floor (10k).
17
+ * ## Keys
46
18
  *
47
- * 3. **Self-describing payloads**: Explain that v1.2.0+ payloads include derivation
48
- * parameters for forward-compatible decryption.
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
- * 4. **Security guidance**: Add a security considerations section covering:
51
- * - Fixed salt tradeoffs (determinism vs uniqueness)
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
- // CONSTANTS
64
- // =============================================================================
65
- /**
66
- * Salt for PBKDF2 key derivation.
67
- *
68
- * DESIGN DECISION: This salt is intentionally fixed (not random) for deterministic
69
- * key derivation. This allows:
70
- *
71
- * 1. **Cross-environment compatibility**: Same password produces same key in
72
- * browser (Web Crypto API) and server (Node.js crypto), enabling encrypted
73
- * specimens to be decrypted in either environment.
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 btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
52
+ return iterations;
110
53
  }
111
- /**
112
- * Validate and normalize iteration count
113
- * @throws Error if iterations below minimum
114
- */
115
- function validateIterations(iterations) {
116
- const count = iterations ?? DEFAULT_PBKDF2_ITERATIONS;
117
- if (count < MIN_PBKDF2_ITERATIONS) {
118
- throw new Error(`PBKDF2 iterations must be at least ${MIN_PBKDF2_ITERATIONS}, got ${count}`);
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
- return count;
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
- * Derive a CryptoKey from a password using PBKDF2
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 deriveKey(password, iterations) {
126
- const encoder = new TextEncoder();
127
- const passwordBytes = encoder.encode(password);
128
- // Import password as key material
129
- const keyMaterial = await crypto.subtle.importKey('raw', passwordBytes, 'PBKDF2', false, [
130
- 'deriveKey',
131
- ]);
132
- // Derive AES-256-GCM key
133
- return crypto.subtle.deriveKey({
134
- name: 'PBKDF2',
135
- salt: PBKDF2_SALT,
136
- iterations,
137
- hash: 'SHA-256',
138
- }, keyMaterial, { name: 'AES-GCM', length: 256 }, false, ['encrypt']);
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
- * Generate a random initialization vector
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 generateIV() {
144
- const buffer = new ArrayBuffer(IV_LENGTH);
145
- const iv = new Uint8Array(buffer);
146
- crypto.getRandomValues(iv);
147
- return { iv, ivBuffer: buffer };
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
- // ENCRYPTION FUNCTIONS
121
+ // URL SERIALIZATION
151
122
  // =============================================================================
152
123
  /**
153
- * Encrypt a specimen using AES-256-GCM
124
+ * Build the encrypted-format URL for an encrypted specimen.
154
125
  *
155
- * @param specimen - The specimen to encrypt
156
- * @param options - Encryption options (key required)
157
- * @returns Promise resolving to encrypted specimen wrapper
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
- * @example
160
- * ```typescript
161
- * import { encryptSpecimen } from '@wemush/wols/crypto';
162
- *
163
- * // Basic encryption with default iterations (100k)
164
- * const encrypted = await encryptSpecimen(specimen, {
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
- const { key, fields } = options;
178
- // If partial encryption requested, handle separately
177
+ (0, shared_js_1.assertWebCrypto)();
178
+ const { fields } = options;
179
179
  if (fields !== undefined && fields.length > 0) {
180
- return encryptPartial(specimen, options);
181
- }
182
- // Validate and get iteration count
183
- const iterations = validateIterations(options.iterations);
184
- // Get or derive the encryption key
185
- // When key is a CryptoKey, iterations is still recorded for documentation
186
- // but not used (key is already derived)
187
- const cryptoKey = typeof key === 'string' ? await deriveKey(key, iterations) : key;
188
- // Serialize the specimen to JSON
189
- const plaintext = (0, specimen_js_1.serializeSpecimen)(specimen);
190
- const plaintextBytes = new TextEncoder().encode(plaintext);
191
- // Generate random IV
192
- const { iv, ivBuffer } = generateIV();
193
- // Encrypt
194
- const ciphertext = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, cryptoKey, plaintextBytes);
195
- // Return encrypted specimen with version and iterations for self-describing decryption
196
- return {
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
- cryptoVersion: CRYPTO_VERSION,
202
- iterations,
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
- * Encrypt only specific fields of a specimen
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
- * Returns a specimen-like object with specified fields encrypted.
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 encryptPartial(specimen, options) {
211
- const { key, fields = [] } = options;
212
- // Validate and get iteration count
213
- const iterations = validateIterations(options.iterations);
214
- // Get or derive the encryption key
215
- const cryptoKey = typeof key === 'string' ? await deriveKey(key, iterations) : key;
216
- // Clone the specimen
217
- const result = { ...specimen };
218
- // Encrypt each specified field
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
- const value = result[field];
221
- if (value !== undefined) {
222
- const plaintext = JSON.stringify(value);
223
- const plaintextBytes = new TextEncoder().encode(plaintext);
224
- const { iv, ivBuffer } = generateIV();
225
- const ciphertext = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, cryptoKey, plaintextBytes);
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
- * Type guard to check if an object is an encrypted specimen
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
- const obj = value;
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":"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"}
1
+ {"version":3,"file":"encrypt.js","sourceRoot":"","sources":["../../../src/crypto/encrypt.ts"],"names":[],"mappings":"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"}
@@ -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"}