@sebastienrousseau/crypto-lib 0.0.34 → 0.0.35

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.
@@ -0,0 +1,9 @@
1
+ export declare function assertChunkSize(chunkSize: number): void;
2
+ export declare const TAG_LEN = 16;
3
+ export declare const CHUNK_TAG_MESSAGE = 0;
4
+ export declare const CHUNK_TAG_FINAL = 1;
5
+ export type ChunkNonce = (baseNonce: Uint8Array, counter: number, tag: number) => Uint8Array;
6
+ export declare function chunkCount(ptLen: number, chunkSize: number): number;
7
+ export declare function streamSize(headerLen: number, ptLen: number, chunkSize: number): number;
8
+ export declare function encryptChunksInto(plaintext: Uint8Array, key: Uint8Array, baseNonce: Uint8Array, chunkSize: number, output: Uint8Array, offset: number, chunkNonce: ChunkNonce): void;
9
+ //# sourceMappingURL=chunks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chunks.d.ts","sourceRoot":"","sources":["../../src/streaming/chunks.ts"],"names":[],"mappings":"AAgBA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIvD;AAGD,eAAO,MAAM,OAAO,KAAK,CAAC;AAE1B,eAAO,MAAM,iBAAiB,IAAO,CAAC;AAEtC,eAAO,MAAM,eAAe,IAAO,CAAC;AAGpC,MAAM,MAAM,UAAU,GAAG,CACvB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,KACR,UAAU,CAAC;AAMhB,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnE;AAMD,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAOD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACrB,IAAI,CAaN"}
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.CHUNK_TAG_FINAL = exports.CHUNK_TAG_MESSAGE = exports.TAG_LEN = void 0;
4
+ exports.assertChunkSize = assertChunkSize;
5
+ exports.chunkCount = chunkCount;
6
+ exports.streamSize = streamSize;
7
+ exports.encryptChunksInto = encryptChunksInto;
8
+ const chacha_js_1 = require("@noble/ciphers/chacha.js");
9
+ function assertChunkSize(chunkSize) {
10
+ if (!Number.isSafeInteger(chunkSize) || chunkSize < 1) {
11
+ throw new Error(`chunkSize must be a positive integer, got ${chunkSize}`);
12
+ }
13
+ }
14
+ exports.TAG_LEN = 16;
15
+ exports.CHUNK_TAG_MESSAGE = 0x00;
16
+ exports.CHUNK_TAG_FINAL = 0x01;
17
+ function chunkCount(ptLen, chunkSize) {
18
+ return Math.max(1, Math.ceil(ptLen / chunkSize));
19
+ }
20
+ function streamSize(headerLen, ptLen, chunkSize) {
21
+ return headerLen + ptLen + chunkCount(ptLen, chunkSize) * (1 + exports.TAG_LEN);
22
+ }
23
+ function encryptChunksInto(plaintext, key, baseNonce, chunkSize, output, offset, chunkNonce) {
24
+ const total = chunkCount(plaintext.length, chunkSize);
25
+ for (let i = 0; i < total; i++) {
26
+ const isFinal = i === total - 1;
27
+ const tag = isFinal ? exports.CHUNK_TAG_FINAL : exports.CHUNK_TAG_MESSAGE;
28
+ const end = isFinal ? plaintext.length : (i + 1) * chunkSize;
29
+ const chunk = plaintext.subarray(i * chunkSize, end);
30
+ const nonce = chunkNonce(baseNonce, i, tag);
31
+ const encrypted = (0, chacha_js_1.xchacha20poly1305)(key, nonce).encrypt(chunk);
32
+ output[offset] = tag;
33
+ output.set(encrypted, offset + 1);
34
+ offset += 1 + encrypted.length;
35
+ }
36
+ }
37
+ //# sourceMappingURL=chunks.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"stream-aead.d.ts","sourceRoot":"","sources":["../../src/streaming/stream-aead.ts"],"names":[],"mappings":"AAkEA,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IAEzB,SAAS,EAAE,UAAU,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,mBAAmB;IAElC,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,EAAE,2BAA2B,CAAC;CACxC;AAGD,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IAEzB,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2BD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CA8CrB;AAsCD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAwDvE"}
1
+ {"version":3,"file":"stream-aead.d.ts","sourceRoot":"","sources":["../../src/streaming/stream-aead.ts"],"names":[],"mappings":"AAoEA,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IAEzB,SAAS,EAAE,UAAU,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,mBAAmB;IAElC,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,EAAE,2BAA2B,CAAC;CACxC;AAGD,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IAEzB,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2BD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CAyBrB;AAsCD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAyDvE"}
@@ -4,11 +4,9 @@ exports.streamEncrypt = streamEncrypt;
4
4
  exports.streamDecrypt = streamDecrypt;
5
5
  const chacha_js_1 = require("@noble/ciphers/chacha.js");
6
6
  const utils_js_1 = require("@noble/ciphers/utils.js");
7
+ const chunks_1 = require("./chunks");
7
8
  const NONCE_LEN = 24;
8
- const TAG_LEN = 16;
9
9
  const DEFAULT_CHUNK_SIZE = 64 * 1024;
10
- const CHUNK_TAG_MESSAGE = 0x00;
11
- const CHUNK_TAG_FINAL = 0x01;
12
10
  function deriveChunkNonce(baseNonce, counter, tag) {
13
11
  const nonce = new Uint8Array(baseNonce);
14
12
  const view = new DataView(nonce.buffer, nonce.byteOffset, nonce.byteLength);
@@ -38,34 +36,12 @@ function toKey(key) {
38
36
  function streamEncrypt(options) {
39
37
  const key = toKey(options.key);
40
38
  const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;
39
+ (0, chunks_1.assertChunkSize)(chunkSize);
41
40
  const plaintext = options.plaintext;
42
41
  const baseNonce = (0, utils_js_1.randomBytes)(NONCE_LEN);
43
- const numFullChunks = Math.floor(plaintext.length / chunkSize);
44
- const lastChunkLen = plaintext.length - numFullChunks * chunkSize;
45
- const hasExtraChunk = lastChunkLen > 0 || plaintext.length === 0;
46
- const totalChunks = hasExtraChunk ? numFullChunks + 1 : numFullChunks;
47
- let outputSize = NONCE_LEN;
48
- for (let i = 0; i < totalChunks; i++) {
49
- const ptLen = i < numFullChunks ? chunkSize : lastChunkLen > 0 ? lastChunkLen : 0;
50
- outputSize += 1 + ptLen + TAG_LEN;
51
- }
52
- const output = new Uint8Array(outputSize);
42
+ const output = new Uint8Array((0, chunks_1.streamSize)(NONCE_LEN, plaintext.length, chunkSize));
53
43
  output.set(baseNonce);
54
- let offset = NONCE_LEN;
55
- for (let i = 0; i < totalChunks; i++) {
56
- const isFinal = i === totalChunks - 1;
57
- const chunkTag = isFinal ? CHUNK_TAG_FINAL : CHUNK_TAG_MESSAGE;
58
- const start = i * chunkSize;
59
- const end = isFinal ? plaintext.length : start + chunkSize;
60
- const chunk = plaintext.subarray(start, end);
61
- const nonce = deriveChunkNonce(baseNonce, i, chunkTag);
62
- const cipher = (0, chacha_js_1.xchacha20poly1305)(key, nonce);
63
- const encrypted = cipher.encrypt(chunk);
64
- output[offset] = chunkTag;
65
- offset += 1;
66
- output.set(encrypted, offset);
67
- offset += encrypted.length;
68
- }
44
+ (0, chunks_1.encryptChunksInto)(plaintext, key, baseNonce, chunkSize, output, NONCE_LEN, deriveChunkNonce);
69
45
  return {
70
46
  ciphertext: output,
71
47
  algorithm: "xchacha20-poly1305-stream",
@@ -73,12 +49,12 @@ function streamEncrypt(options) {
73
49
  }
74
50
  function readChunkHeader(ciphertext, offset, chunkSize) {
75
51
  const chunkTag = ciphertext[offset];
76
- if (chunkTag !== CHUNK_TAG_MESSAGE && chunkTag !== CHUNK_TAG_FINAL) {
52
+ if (chunkTag !== chunks_1.CHUNK_TAG_MESSAGE && chunkTag !== chunks_1.CHUNK_TAG_FINAL) {
77
53
  throw new Error(`Invalid chunk tag: 0x${chunkTag.toString(16)}`);
78
54
  }
79
- const isFinal = chunkTag === CHUNK_TAG_FINAL;
55
+ const isFinal = chunkTag === chunks_1.CHUNK_TAG_FINAL;
80
56
  const start = offset + 1;
81
- const encLen = isFinal ? ciphertext.length - start : chunkSize + TAG_LEN;
57
+ const encLen = isFinal ? ciphertext.length - start : chunkSize + chunks_1.TAG_LEN;
82
58
  if (start + encLen > ciphertext.length) {
83
59
  throw new Error("Ciphertext truncated — incomplete chunk");
84
60
  }
@@ -87,8 +63,9 @@ function readChunkHeader(ciphertext, offset, chunkSize) {
87
63
  function streamDecrypt(options) {
88
64
  const key = toKey(options.key);
89
65
  const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;
66
+ (0, chunks_1.assertChunkSize)(chunkSize);
90
67
  const ciphertext = options.ciphertext;
91
- if (ciphertext.length < NONCE_LEN + 1 + TAG_LEN) {
68
+ if (ciphertext.length < NONCE_LEN + 1 + chunks_1.TAG_LEN) {
92
69
  throw new Error("Ciphertext too short — missing header or chunk data");
93
70
  }
94
71
  const baseNonce = ciphertext.subarray(0, NONCE_LEN);
@@ -1 +1 @@
1
- {"version":3,"file":"stream-multi-pq-aead.d.ts","sourceRoot":"","sources":["../../src/streaming/stream-multi-pq-aead.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,qBAAqB,yBAA2C,CAAC;AAG9E,eAAO,MAAM,uBAAuB,IAAO,CAAC;AAG5C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAGtC,eAAO,MAAM,OAAO,KAAK,CAAC;AAG1B,eAAO,MAAM,eAAe,QAAoB,CAAC;AAGjD,eAAO,MAAM,mBAAmB,QACiC,CAAC;AAOlE,MAAM,WAAW,gBAAgB;IAE/B,WAAW,EAAE,MAAM,CAAC;IAEpB,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;CAC3C;AAGD,MAAM,WAAW,2BAA2B;IAE1C,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAE/B,SAAS,EAAE,UAAU,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAGD,MAAM,WAAW,0BAA0B;IAEzC,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,EAAE,mDAAmD,CAAC;IAE/D,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,2BAA2B;IAE1C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;IAE1C,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAGD,MAAM,WAAW,0BAA0B;IAEzC,SAAS,EAAE,UAAU,CAAC;IAEtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAgLD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAsD5B;AAwND,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAyC5B"}
1
+ {"version":3,"file":"stream-multi-pq-aead.d.ts","sourceRoot":"","sources":["../../src/streaming/stream-multi-pq-aead.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,qBAAqB,yBAA2C,CAAC;AAG9E,eAAO,MAAM,uBAAuB,IAAO,CAAC;AAG5C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAGtC,eAAO,MAAM,OAAO,KAAK,CAAC;AAG1B,eAAO,MAAM,eAAe,QAAoB,CAAC;AAGjD,eAAO,MAAM,mBAAmB,QACiC,CAAC;AAOlE,MAAM,WAAW,gBAAgB;IAE/B,WAAW,EAAE,MAAM,CAAC;IAEpB,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;CAC3C;AAGD,MAAM,WAAW,2BAA2B;IAE1C,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAE/B,SAAS,EAAE,UAAU,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAGD,MAAM,WAAW,0BAA0B;IAEzC,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,EAAE,mDAAmD,CAAC;IAE/D,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,2BAA2B;IAE1C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;IAE1C,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAGD,MAAM,WAAW,0BAA0B;IAEzC,SAAS,EAAE,UAAU,CAAC;IAEtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAgJD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAoC5B;AAwND,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAyC5B"}
@@ -11,6 +11,7 @@ const chacha_js_1 = require("@noble/ciphers/chacha.js");
11
11
  const utils_js_1 = require("@noble/ciphers/utils.js");
12
12
  const utils_1 = require("../utils");
13
13
  const stream_pq_aead_1 = require("./stream-pq-aead");
14
+ const chunks_1 = require("./chunks");
14
15
  exports.MULTI_PQ_STREAM_MAGIC = new Uint8Array([0x4d, 0x53, 0x50, 0x51]);
15
16
  exports.MULTI_PQ_STREAM_VERSION = 0x01;
16
17
  exports.MULTI_PQ_PREFIX_LEN = 35;
@@ -75,38 +76,6 @@ function serializeSlot(idBytes, ephPub, mlKemCt, slotNonce, wrappedCek) {
75
76
  out.set(wrappedCek, pos);
76
77
  return out;
77
78
  }
78
- function computeMultiStreamOutputSize(headerLen, ptLen, chunkSize) {
79
- const numFullChunks = Math.floor(ptLen / chunkSize);
80
- const lastChunkLen = ptLen - numFullChunks * chunkSize;
81
- const hasExtra = lastChunkLen > 0 || ptLen === 0;
82
- const totalChunks = hasExtra ? numFullChunks + 1 : numFullChunks;
83
- let totalSize = headerLen;
84
- for (let i = 0; i < totalChunks; i++) {
85
- const len = i < numFullChunks ? chunkSize : lastChunkLen > 0 ? lastChunkLen : 0;
86
- totalSize += 1 + len + stream_pq_aead_1.TAG_LEN;
87
- }
88
- return totalSize;
89
- }
90
- function encryptStreamChunks(plaintext, cek, baseNonce, chunkSize, output, headerLen) {
91
- const numFullChunks = Math.floor(plaintext.length / chunkSize);
92
- const hasExtra = plaintext.length % chunkSize > 0 || plaintext.length === 0;
93
- const totalChunks = hasExtra ? numFullChunks + 1 : numFullChunks;
94
- let offset = headerLen;
95
- for (let i = 0; i < totalChunks; i++) {
96
- const isFinal = i === totalChunks - 1;
97
- const chunkTag = isFinal ? stream_pq_aead_1.CHUNK_TAG_FINAL : stream_pq_aead_1.CHUNK_TAG_MESSAGE;
98
- const start = i * chunkSize;
99
- const end = isFinal ? plaintext.length : start + chunkSize;
100
- const chunk = plaintext.subarray(start, end);
101
- const nonce = (0, stream_pq_aead_1.derivePqChunkNonce)(baseNonce, i, chunkTag);
102
- const cipher = (0, chacha_js_1.xchacha20poly1305)(cek, nonce);
103
- const encrypted = cipher.encrypt(chunk);
104
- output[offset] = chunkTag;
105
- offset += 1;
106
- output.set(encrypted, offset);
107
- offset += encrypted.length;
108
- }
109
- }
110
79
  function writeHeaderPrefix(out, chunkSize, baseNonce, count) {
111
80
  out.set(exports.MULTI_PQ_STREAM_MAGIC, 0);
112
81
  out[4] = exports.MULTI_PQ_STREAM_VERSION;
@@ -115,7 +84,7 @@ function writeHeaderPrefix(out, chunkSize, baseNonce, count) {
115
84
  out.set(baseNonce, 9);
116
85
  view.setUint16(33, count, false);
117
86
  }
118
- function streamMultiPqEncrypt(options) {
87
+ function checkEncryptOptions(options) {
119
88
  const recipients = options.recipients;
120
89
  if (!Array.isArray(recipients) || recipients.length === 0) {
121
90
  throw new Error("At least one recipient is required");
@@ -124,28 +93,26 @@ function streamMultiPqEncrypt(options) {
124
93
  throw new Error("Recipient count exceeds maximum limit of 1000");
125
94
  }
126
95
  const chunkSize = options.chunkSize ?? stream_pq_aead_1.DEFAULT_CHUNK_SIZE;
96
+ (0, chunks_1.assertChunkSize)(chunkSize);
127
97
  if (chunkSize < 1024 || chunkSize > 16 * 1024 * 1024) {
128
98
  throw new Error("Chunk size must be between 1024 and 16777216 bytes");
129
99
  }
100
+ return { recipients, chunkSize };
101
+ }
102
+ function streamMultiPqEncrypt(options) {
103
+ const { recipients, chunkSize } = checkEncryptOptions(options);
130
104
  const cek = (0, utils_js_1.randomBytes)(exports.CEK_LEN);
131
105
  const baseNonce = (0, utils_js_1.randomBytes)(stream_pq_aead_1.NONCE_LEN);
132
- const serializedSlots = [];
133
- let slotsTotalLen = 0;
134
- for (let i = 0; i < recipients.length; i++) {
135
- const slotBytes = createSlot(cek, i, recipients[i]);
136
- serializedSlots.push(slotBytes);
137
- slotsTotalLen += slotBytes.length;
138
- }
139
- const headerLen = exports.MULTI_PQ_PREFIX_LEN + slotsTotalLen;
140
- const totalSize = computeMultiStreamOutputSize(headerLen, options.plaintext.length, chunkSize);
141
- const output = new Uint8Array(totalSize);
106
+ const slots = recipients.map((r, i) => createSlot(cek, i, r));
107
+ const headerLen = exports.MULTI_PQ_PREFIX_LEN + slots.reduce((sum, slot) => sum + slot.length, 0);
108
+ const output = new Uint8Array((0, chunks_1.streamSize)(headerLen, options.plaintext.length, chunkSize));
142
109
  writeHeaderPrefix(output, chunkSize, baseNonce, recipients.length);
143
110
  let slotOffset = exports.MULTI_PQ_PREFIX_LEN;
144
- for (const s of serializedSlots) {
145
- output.set(s, slotOffset);
146
- slotOffset += s.length;
111
+ for (const slot of slots) {
112
+ output.set(slot, slotOffset);
113
+ slotOffset += slot.length;
147
114
  }
148
- encryptStreamChunks(options.plaintext, cek, baseNonce, chunkSize, output, headerLen);
115
+ (0, chunks_1.encryptChunksInto)(options.plaintext, cek, baseNonce, chunkSize, output, headerLen, stream_pq_aead_1.derivePqChunkNonce);
149
116
  (0, utils_1.wipeMemory)(cek);
150
117
  return {
151
118
  ciphertext: output,
@@ -1,11 +1,10 @@
1
+ import { CHUNK_TAG_FINAL, CHUNK_TAG_MESSAGE, TAG_LEN } from "./chunks";
2
+ export { CHUNK_TAG_FINAL, CHUNK_TAG_MESSAGE, TAG_LEN };
1
3
  export declare const EPHEMERAL_LEN = 32;
2
4
  export declare const ML_KEM_CT_LEN = 1088;
3
5
  export declare const NONCE_LEN = 24;
4
- export declare const TAG_LEN = 16;
5
6
  export declare const PQ_STREAM_HEADER_LEN: number;
6
7
  export declare const DEFAULT_CHUNK_SIZE: number;
7
- export declare const CHUNK_TAG_MESSAGE = 0;
8
- export declare const CHUNK_TAG_FINAL = 1;
9
8
  export declare function toBytes(data: string | Uint8Array, expectedLen?: number, name?: string): Uint8Array;
10
9
  export declare function derivePqChunkNonce(baseNonce: Uint8Array, counter: number, tag: number): Uint8Array;
11
10
  export interface StreamPqEncryptOptions {
@@ -1 +1 @@
1
- {"version":3,"file":"stream-pq-aead.d.ts","sourceRoot":"","sources":["../../src/streaming/stream-pq-aead.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,eAAO,MAAM,OAAO,KAAK,CAAC;AAE1B,eAAO,MAAM,oBAAoB,QAA4C,CAAC;AAE9E,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAE5C,eAAO,MAAM,iBAAiB,IAAO,CAAC;AAEtC,eAAO,MAAM,eAAe,IAAO,CAAC;AAKpC,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,SAAS,GACZ,UAAU,CAYZ;AAGD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,UAAU,CAiBZ;AAGD,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1C,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAGD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,6CAA6C,CAAC;CAC1D;AAGD,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1C,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAqGD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAiCvB;AA6ED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAoC3E"}
1
+ {"version":3,"file":"stream-pq-aead.d.ts","sourceRoot":"","sources":["../../src/streaming/stream-pq-aead.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,OAAO,EAIR,MAAM,UAAU,CAAC;AAIlB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;AAGvD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,eAAO,MAAM,oBAAoB,QAA4C,CAAC;AAE9E,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAK5C,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,SAAS,GACZ,UAAU,CAYZ;AAGD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,UAAU,CAiBZ;AAGD,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1C,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAGD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,6CAA6C,CAAC;CAC1D;AAGD,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3C,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1C,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAsDD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA2CvB;AA6ED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAqC3E"}
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.CHUNK_TAG_FINAL = exports.CHUNK_TAG_MESSAGE = exports.DEFAULT_CHUNK_SIZE = exports.PQ_STREAM_HEADER_LEN = exports.TAG_LEN = exports.NONCE_LEN = exports.ML_KEM_CT_LEN = exports.EPHEMERAL_LEN = void 0;
3
+ exports.DEFAULT_CHUNK_SIZE = exports.PQ_STREAM_HEADER_LEN = exports.NONCE_LEN = exports.ML_KEM_CT_LEN = exports.EPHEMERAL_LEN = exports.TAG_LEN = exports.CHUNK_TAG_MESSAGE = exports.CHUNK_TAG_FINAL = void 0;
4
4
  exports.toBytes = toBytes;
5
5
  exports.derivePqChunkNonce = derivePqChunkNonce;
6
6
  exports.streamPqEncrypt = streamPqEncrypt;
@@ -11,14 +11,15 @@ const hkdf_js_1 = require("@noble/hashes/hkdf.js");
11
11
  const sha2_js_1 = require("@noble/hashes/sha2.js");
12
12
  const chacha_js_1 = require("@noble/ciphers/chacha.js");
13
13
  const utils_js_1 = require("@noble/ciphers/utils.js");
14
+ const chunks_1 = require("./chunks");
15
+ Object.defineProperty(exports, "CHUNK_TAG_FINAL", { enumerable: true, get: function () { return chunks_1.CHUNK_TAG_FINAL; } });
16
+ Object.defineProperty(exports, "CHUNK_TAG_MESSAGE", { enumerable: true, get: function () { return chunks_1.CHUNK_TAG_MESSAGE; } });
17
+ Object.defineProperty(exports, "TAG_LEN", { enumerable: true, get: function () { return chunks_1.TAG_LEN; } });
14
18
  exports.EPHEMERAL_LEN = 32;
15
19
  exports.ML_KEM_CT_LEN = 1088;
16
20
  exports.NONCE_LEN = 24;
17
- exports.TAG_LEN = 16;
18
21
  exports.PQ_STREAM_HEADER_LEN = exports.EPHEMERAL_LEN + exports.ML_KEM_CT_LEN + exports.NONCE_LEN;
19
22
  exports.DEFAULT_CHUNK_SIZE = 64 * 1024;
20
- exports.CHUNK_TAG_MESSAGE = 0x00;
21
- exports.CHUNK_TAG_FINAL = 0x01;
22
23
  const HEX_RE = /^[0-9a-fA-F]*$/;
23
24
  function toBytes(data, expectedLen, name = "Data") {
24
25
  let buf;
@@ -64,51 +65,19 @@ function decapsulateKeyMaterial(recipX25519Sec, recipMlKemSec, ephPub, mlKemCt)
64
65
  const x25519Shared = ed25519_js_1.x25519.getSharedSecret(recipX25519Sec, ephPub);
65
66
  return deriveSharedKey(x25519Shared, mlKemShared, ephPub);
66
67
  }
67
- function computeStreamOutputSize(ptLen, chunkSize) {
68
- const numFullChunks = Math.floor(ptLen / chunkSize);
69
- const lastChunkLen = ptLen - numFullChunks * chunkSize;
70
- const hasExtraChunk = lastChunkLen > 0 || ptLen === 0;
71
- const totalChunks = hasExtraChunk ? numFullChunks + 1 : numFullChunks;
72
- let totalSize = exports.PQ_STREAM_HEADER_LEN;
73
- for (let i = 0; i < totalChunks; i++) {
74
- const len = i < numFullChunks ? chunkSize : lastChunkLen > 0 ? lastChunkLen : 0;
75
- totalSize += 1 + len + exports.TAG_LEN;
76
- }
77
- return totalSize;
78
- }
79
- function encryptChunks(plaintext, key, baseNonce, chunkSize, output) {
80
- const numFullChunks = Math.floor(plaintext.length / chunkSize);
81
- const hasExtra = plaintext.length % chunkSize > 0 || plaintext.length === 0;
82
- const totalChunks = hasExtra ? numFullChunks + 1 : numFullChunks;
83
- let offset = exports.PQ_STREAM_HEADER_LEN;
84
- for (let i = 0; i < totalChunks; i++) {
85
- const isFinal = i === totalChunks - 1;
86
- const chunkTag = isFinal ? exports.CHUNK_TAG_FINAL : exports.CHUNK_TAG_MESSAGE;
87
- const start = i * chunkSize;
88
- const end = isFinal ? plaintext.length : start + chunkSize;
89
- const chunk = plaintext.subarray(start, end);
90
- const nonce = derivePqChunkNonce(baseNonce, i, chunkTag);
91
- const cipher = (0, chacha_js_1.xchacha20poly1305)(key, nonce);
92
- const encrypted = cipher.encrypt(chunk);
93
- output[offset] = chunkTag;
94
- offset += 1;
95
- output.set(encrypted, offset);
96
- offset += encrypted.length;
97
- }
98
- }
99
68
  function streamPqEncrypt(options) {
100
69
  const recipX25519Pub = toBytes(options.recipientX25519Public, 32, "recipientX25519Public");
101
70
  const recipMlKemPub = toBytes(options.recipientMlKemPublic, 1184, "recipientMlKemPublic");
102
71
  const chunkSize = options.chunkSize ?? exports.DEFAULT_CHUNK_SIZE;
72
+ (0, chunks_1.assertChunkSize)(chunkSize);
103
73
  const plaintext = options.plaintext;
104
74
  const { ephPub, mlKemCt, key } = encapsulateKeyMaterial(recipX25519Pub, recipMlKemPub);
105
75
  const baseNonce = (0, utils_js_1.randomBytes)(exports.NONCE_LEN);
106
- const totalSize = computeStreamOutputSize(plaintext.length, chunkSize);
107
- const output = new Uint8Array(totalSize);
76
+ const output = new Uint8Array((0, chunks_1.streamSize)(exports.PQ_STREAM_HEADER_LEN, plaintext.length, chunkSize));
108
77
  output.set(ephPub, 0);
109
78
  output.set(mlKemCt, exports.EPHEMERAL_LEN);
110
79
  output.set(baseNonce, exports.EPHEMERAL_LEN + exports.ML_KEM_CT_LEN);
111
- encryptChunks(plaintext, key, baseNonce, chunkSize, output);
80
+ (0, chunks_1.encryptChunksInto)(plaintext, key, baseNonce, chunkSize, output, exports.PQ_STREAM_HEADER_LEN, derivePqChunkNonce);
112
81
  return {
113
82
  ciphertext: output,
114
83
  algorithm: "x25519-ml-kem-768-xchacha20-poly1305-stream",
@@ -116,12 +85,12 @@ function streamPqEncrypt(options) {
116
85
  }
117
86
  function readPqChunkHeader(ciphertext, offset, chunkSize) {
118
87
  const chunkTag = ciphertext[offset];
119
- if (chunkTag !== exports.CHUNK_TAG_MESSAGE && chunkTag !== exports.CHUNK_TAG_FINAL) {
88
+ if (chunkTag !== chunks_1.CHUNK_TAG_MESSAGE && chunkTag !== chunks_1.CHUNK_TAG_FINAL) {
120
89
  throw new Error(`Invalid chunk tag: 0x${chunkTag.toString(16)}`);
121
90
  }
122
- const isFinal = chunkTag === exports.CHUNK_TAG_FINAL;
91
+ const isFinal = chunkTag === chunks_1.CHUNK_TAG_FINAL;
123
92
  const start = offset + 1;
124
- const encLen = isFinal ? ciphertext.length - start : chunkSize + exports.TAG_LEN;
93
+ const encLen = isFinal ? ciphertext.length - start : chunkSize + chunks_1.TAG_LEN;
125
94
  if (start + encLen > ciphertext.length) {
126
95
  throw new Error("Ciphertext truncated — incomplete chunk");
127
96
  }
@@ -162,8 +131,9 @@ function streamPqDecrypt(options) {
162
131
  const recipX25519Sec = toBytes(options.recipientX25519Secret, 32, "recipientX25519Secret");
163
132
  const recipMlKemSec = toBytes(options.recipientMlKemSecret, 2400, "recipientMlKemSecret");
164
133
  const chunkSize = options.chunkSize ?? exports.DEFAULT_CHUNK_SIZE;
134
+ (0, chunks_1.assertChunkSize)(chunkSize);
165
135
  const ciphertext = options.ciphertext;
166
- if (ciphertext.length < exports.PQ_STREAM_HEADER_LEN + 1 + exports.TAG_LEN) {
136
+ if (ciphertext.length < exports.PQ_STREAM_HEADER_LEN + 1 + chunks_1.TAG_LEN) {
167
137
  throw new Error("Ciphertext too short — missing header or chunk data");
168
138
  }
169
139
  const ephPub = ciphertext.subarray(0, exports.EPHEMERAL_LEN);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sebastienrousseau/crypto-lib",
3
- "version": "0.0.34",
3
+ "version": "0.0.35",
4
4
  "description": "Post-quantum cryptography library for TypeScript and Node.js: ML-KEM, ML-DSA, SLH-DSA, HPKE, AES-GCM, XChaCha20-Poly1305, Ed25519, X25519, SHA-3, BLAKE3, Argon2id and OpenPGP.",
5
5
  "author": "Sebastien Rousseau <sebastienrousseau@users.noreply.github.com>",
6
6
  "license": "MIT OR Apache-2.0",