@claude-flow/security 3.0.0-alpha.7 → 3.0.0-alpha.8

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 (37) hide show
  1. package/README.md +292 -234
  2. package/__tests__/acceptance/security-compliance.test.ts +674 -674
  3. package/__tests__/credential-generator.test.ts +310 -310
  4. package/__tests__/fixtures/configurations.ts +425 -425
  5. package/__tests__/fixtures/index.ts +21 -21
  6. package/__tests__/helpers/create-mock.ts +469 -469
  7. package/__tests__/helpers/index.ts +32 -32
  8. package/__tests__/input-validator.test.ts +382 -382
  9. package/__tests__/integration/security-flow.test.ts +606 -606
  10. package/__tests__/password-hasher.test.ts +239 -239
  11. package/__tests__/path-validator.test.ts +302 -302
  12. package/__tests__/safe-executor.test.ts +292 -292
  13. package/__tests__/token-generator.test.ts +371 -371
  14. package/__tests__/unit/credential-generator.test.ts +182 -182
  15. package/__tests__/unit/password-hasher.test.ts +359 -359
  16. package/__tests__/unit/path-validator.test.ts +509 -509
  17. package/__tests__/unit/safe-executor.test.ts +667 -667
  18. package/__tests__/unit/token-generator.test.ts +310 -310
  19. package/dist/credential-generator.js +9 -9
  20. package/package.json +27 -27
  21. package/ruvector.db +0 -0
  22. package/src/CVE-REMEDIATION.ts +251 -251
  23. package/src/application/index.ts +10 -10
  24. package/src/application/services/security-application-service.ts +193 -193
  25. package/src/credential-generator.ts +368 -368
  26. package/src/domain/entities/security-context.ts +173 -173
  27. package/src/domain/index.ts +17 -17
  28. package/src/domain/services/security-domain-service.ts +296 -296
  29. package/src/index.ts +271 -271
  30. package/src/input-validator.ts +466 -466
  31. package/src/password-hasher.ts +277 -277
  32. package/src/path-validator.ts +525 -525
  33. package/src/safe-executor.ts +546 -546
  34. package/src/token-generator.ts +463 -463
  35. package/tsconfig.json +9 -9
  36. package/tsconfig.tsbuildinfo +1 -1
  37. package/vitest.config.ts +20 -20
@@ -1,310 +1,310 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import { TokenGenerator, TokenGeneratorError } from '../../src/token-generator.js';
3
-
4
- describe('TokenGenerator', () => {
5
- describe('cryptographically secure token generation', () => {
6
- it('should generate tokens using crypto.randomBytes', () => {
7
- const generator = new TokenGenerator();
8
- const token = generator.generate();
9
-
10
- // Token should be base64url encoded (default)
11
- expect(token).toMatch(/^[A-Za-z0-9_-]+$/);
12
- expect(token.length).toBeGreaterThan(0);
13
- });
14
-
15
- it('should generate tokens with specified length', () => {
16
- const generator = new TokenGenerator();
17
-
18
- // 16 bytes = 22 chars in base64url (without padding)
19
- const token16 = generator.generate(16);
20
- expect(token16.length).toBe(22);
21
-
22
- // 32 bytes = 43 chars in base64url (without padding)
23
- const token32 = generator.generate(32);
24
- expect(token32.length).toBe(43);
25
- });
26
-
27
- it('should support different encodings', () => {
28
- const hexGenerator = new TokenGenerator({ encoding: 'hex' });
29
- const hexToken = hexGenerator.generate(16);
30
- expect(hexToken).toMatch(/^[0-9a-f]+$/i);
31
- expect(hexToken.length).toBe(32); // 16 bytes = 32 hex chars
32
-
33
- const base64Generator = new TokenGenerator({ encoding: 'base64' });
34
- const base64Token = base64Generator.generate(16);
35
- expect(base64Token).toMatch(/^[A-Za-z0-9+/]+=*$/);
36
- });
37
-
38
- it('should reject token length below 16 bytes', () => {
39
- expect(() => new TokenGenerator({ defaultLength: 8 }))
40
- .toThrow('Token length must be at least 16 bytes');
41
- });
42
- });
43
-
44
- describe('token uniqueness', () => {
45
- it('should generate unique tokens each time', () => {
46
- const generator = new TokenGenerator();
47
- const tokens = new Set(Array.from({ length: 1000 }, () => generator.generate()));
48
- expect(tokens.size).toBe(1000);
49
- });
50
-
51
- it('should generate unique session tokens', () => {
52
- const generator = new TokenGenerator();
53
- const tokens = new Set(Array.from({ length: 100 }, () => generator.generateSessionToken().value));
54
- expect(tokens.size).toBe(100);
55
- });
56
-
57
- it('should generate unique verification codes', () => {
58
- const generator = new TokenGenerator();
59
- const codes = new Set(Array.from({ length: 100 }, () => generator.generateVerificationCode().code));
60
- // Due to 6-digit codes, some collisions are possible but should be rare
61
- expect(codes.size).toBeGreaterThan(90);
62
- });
63
-
64
- it('should generate unique request IDs', () => {
65
- const generator = new TokenGenerator();
66
- const ids = new Set(Array.from({ length: 1000 }, () => generator.generateRequestId()));
67
- expect(ids.size).toBe(1000);
68
- });
69
-
70
- it('should generate unique correlation IDs', () => {
71
- const generator = new TokenGenerator();
72
- const ids = new Set(Array.from({ length: 1000 }, () => generator.generateCorrelationId()));
73
- expect(ids.size).toBe(1000);
74
- });
75
- });
76
-
77
- describe('timing-safe comparison', () => {
78
- it('should return true for equal tokens', () => {
79
- const generator = new TokenGenerator();
80
- const token = generator.generate();
81
- expect(generator.compare(token, token)).toBe(true);
82
- });
83
-
84
- it('should return false for different tokens', () => {
85
- const generator = new TokenGenerator();
86
- const token1 = generator.generate();
87
- const token2 = generator.generate();
88
- expect(generator.compare(token1, token2)).toBe(false);
89
- });
90
-
91
- it('should return false for different length strings', () => {
92
- const generator = new TokenGenerator();
93
- expect(generator.compare('short', 'muchlongerstring')).toBe(false);
94
- });
95
-
96
- it('should perform constant-time comparison', () => {
97
- const generator = new TokenGenerator();
98
- const token = 'a'.repeat(100);
99
-
100
- // Compare with identical string should work
101
- expect(generator.compare(token, token)).toBe(true);
102
-
103
- // Compare with different strings at various positions
104
- const differentAtStart = 'b' + 'a'.repeat(99);
105
- const differentAtEnd = 'a'.repeat(99) + 'b';
106
-
107
- expect(generator.compare(token, differentAtStart)).toBe(false);
108
- expect(generator.compare(token, differentAtEnd)).toBe(false);
109
- });
110
- });
111
-
112
- describe('signed tokens', () => {
113
- it('should require HMAC secret for signed tokens', () => {
114
- const generator = new TokenGenerator();
115
- expect(() => generator.generateSignedToken({ userId: '123' }))
116
- .toThrow('HMAC secret required for signed tokens');
117
- });
118
-
119
- it('should generate valid signed tokens', () => {
120
- const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
121
- const signed = generator.generateSignedToken({ userId: '123' });
122
-
123
- expect(signed.token).toBeDefined();
124
- expect(signed.signature).toBeDefined();
125
- expect(signed.combined).toBe(`${signed.token}.${signed.signature}`);
126
- expect(signed.createdAt).toBeInstanceOf(Date);
127
- expect(signed.expiresAt).toBeInstanceOf(Date);
128
- });
129
-
130
- it('should verify valid signed tokens', () => {
131
- const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
132
- const signed = generator.generateSignedToken({ userId: '123', role: 'admin' });
133
-
134
- const payload = generator.verifySignedToken(signed.combined);
135
- expect(payload).not.toBeNull();
136
- expect(payload!.userId).toBe('123');
137
- expect(payload!.role).toBe('admin');
138
- });
139
-
140
- it('should reject tampered tokens', () => {
141
- const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
142
- const signed = generator.generateSignedToken({ userId: '123' });
143
-
144
- // Tamper with signature
145
- const tampered = signed.combined.slice(0, -5) + 'xxxxx';
146
- expect(generator.verifySignedToken(tampered)).toBeNull();
147
- });
148
-
149
- it('should reject tokens with wrong secret', () => {
150
- const generator1 = new TokenGenerator({ hmacSecret: 'secret-1' });
151
- const generator2 = new TokenGenerator({ hmacSecret: 'secret-2' });
152
-
153
- const signed = generator1.generateSignedToken({ userId: '123' });
154
- expect(generator2.verifySignedToken(signed.combined)).toBeNull();
155
- });
156
-
157
- it('should reject expired signed tokens', async () => {
158
- const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
159
- const signed = generator.generateSignedToken({ userId: '123' }, 0); // Expires immediately
160
-
161
- // Wait a tiny bit for expiration
162
- await new Promise(resolve => setTimeout(resolve, 10));
163
- expect(generator.verifySignedToken(signed.combined)).toBeNull();
164
- });
165
-
166
- it('should reject malformed token format', () => {
167
- const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
168
-
169
- expect(generator.verifySignedToken('no-dot-in-token')).toBeNull();
170
- expect(generator.verifySignedToken('too.many.dots')).toBeNull();
171
- expect(generator.verifySignedToken('')).toBeNull();
172
- });
173
- });
174
-
175
- describe('token expiration', () => {
176
- it('should create tokens with expiration', () => {
177
- const generator = new TokenGenerator();
178
- const token = generator.generateWithExpiration(3600);
179
-
180
- expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 3600 * 1000);
181
- });
182
-
183
- it('should use default expiration', () => {
184
- const generator = new TokenGenerator({ defaultExpiration: 7200 });
185
- const token = generator.generateWithExpiration();
186
-
187
- expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 7200 * 1000);
188
- });
189
-
190
- it('should correctly identify expired tokens', () => {
191
- const generator = new TokenGenerator();
192
-
193
- const expiredToken = {
194
- value: 'test',
195
- createdAt: new Date(Date.now() - 10000),
196
- expiresAt: new Date(Date.now() - 5000),
197
- };
198
- expect(generator.isExpired(expiredToken)).toBe(true);
199
-
200
- const validToken = {
201
- value: 'test',
202
- createdAt: new Date(),
203
- expiresAt: new Date(Date.now() + 10000),
204
- };
205
- expect(generator.isExpired(validToken)).toBe(false);
206
- });
207
- });
208
-
209
- describe('specialized token types', () => {
210
- it('should generate session tokens with expiration', () => {
211
- const generator = new TokenGenerator();
212
- const token = generator.generateSessionToken();
213
-
214
- expect(token.value).toBeDefined();
215
- expect(token.expiresAt.getTime()).toBeGreaterThan(token.createdAt.getTime());
216
- });
217
-
218
- it('should generate CSRF tokens with 30-minute expiration', () => {
219
- const generator = new TokenGenerator();
220
- const token = generator.generateCsrfToken();
221
-
222
- const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
223
- expect(token.expiresAt.getTime()).toBe(expectedExpiry);
224
- });
225
-
226
- it('should generate API tokens with prefix and 1-year expiration', () => {
227
- const generator = new TokenGenerator();
228
- const token = generator.generateApiToken('api_');
229
-
230
- expect(token.value.startsWith('api_')).toBe(true);
231
-
232
- const oneYear = 365 * 24 * 60 * 60 * 1000;
233
- expect(token.expiresAt.getTime()).toBeCloseTo(token.createdAt.getTime() + oneYear, -3);
234
- });
235
-
236
- it('should generate password reset tokens with 30-minute expiration', () => {
237
- const generator = new TokenGenerator();
238
- const token = generator.generatePasswordResetToken();
239
-
240
- const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
241
- expect(token.expiresAt.getTime()).toBe(expectedExpiry);
242
- });
243
-
244
- it('should generate email verification tokens with 24-hour expiration', () => {
245
- const generator = new TokenGenerator();
246
- const token = generator.generateEmailVerificationToken();
247
-
248
- const expectedExpiry = token.createdAt.getTime() + 86400 * 1000;
249
- expect(token.expiresAt.getTime()).toBe(expectedExpiry);
250
- });
251
-
252
- it('should generate token pairs (access + refresh)', () => {
253
- const generator = new TokenGenerator();
254
- const pair = generator.generateTokenPair();
255
-
256
- expect(pair.accessToken).toBeDefined();
257
- expect(pair.refreshToken).toBeDefined();
258
-
259
- // Access token: 15 minutes
260
- expect(pair.accessToken.expiresAt.getTime()).toBe(
261
- pair.accessToken.createdAt.getTime() + 900 * 1000
262
- );
263
-
264
- // Refresh token: 7 days
265
- expect(pair.refreshToken.expiresAt.getTime()).toBe(
266
- pair.refreshToken.createdAt.getTime() + 604800 * 1000
267
- );
268
- });
269
- });
270
-
271
- describe('verification codes', () => {
272
- it('should generate numeric codes of specified length', () => {
273
- const generator = new TokenGenerator();
274
-
275
- const code6 = generator.generateVerificationCode(6);
276
- expect(code6.code).toMatch(/^\d{6}$/);
277
-
278
- const code8 = generator.generateVerificationCode(8);
279
- expect(code8.code).toMatch(/^\d{8}$/);
280
- });
281
-
282
- it('should set expiration and attempt limits', () => {
283
- const generator = new TokenGenerator();
284
- const code = generator.generateVerificationCode(6, 15, 5);
285
-
286
- expect(code.attempts).toBe(0);
287
- expect(code.maxAttempts).toBe(5);
288
- expect(code.expiresAt.getTime()).toBe(code.createdAt.getTime() + 15 * 60 * 1000);
289
- });
290
- });
291
-
292
- describe('correlation and request IDs', () => {
293
- it('should generate short request IDs', () => {
294
- const generator = new TokenGenerator();
295
- const id = generator.generateRequestId();
296
-
297
- // 8 bytes = 11 chars in base64url
298
- expect(id.length).toBe(11);
299
- });
300
-
301
- it('should generate correlation IDs with timestamp prefix', () => {
302
- const generator = new TokenGenerator();
303
- const id = generator.generateCorrelationId();
304
-
305
- expect(id).toMatch(/^[a-z0-9]+-[A-Za-z0-9_-]+$/);
306
- const [timestamp] = id.split('-');
307
- expect(parseInt(timestamp, 36)).toBeGreaterThan(0);
308
- });
309
- });
310
- });
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
2
+ import { TokenGenerator, TokenGeneratorError } from '../../src/token-generator.js';
3
+
4
+ describe('TokenGenerator', () => {
5
+ describe('cryptographically secure token generation', () => {
6
+ it('should generate tokens using crypto.randomBytes', () => {
7
+ const generator = new TokenGenerator();
8
+ const token = generator.generate();
9
+
10
+ // Token should be base64url encoded (default)
11
+ expect(token).toMatch(/^[A-Za-z0-9_-]+$/);
12
+ expect(token.length).toBeGreaterThan(0);
13
+ });
14
+
15
+ it('should generate tokens with specified length', () => {
16
+ const generator = new TokenGenerator();
17
+
18
+ // 16 bytes = 22 chars in base64url (without padding)
19
+ const token16 = generator.generate(16);
20
+ expect(token16.length).toBe(22);
21
+
22
+ // 32 bytes = 43 chars in base64url (without padding)
23
+ const token32 = generator.generate(32);
24
+ expect(token32.length).toBe(43);
25
+ });
26
+
27
+ it('should support different encodings', () => {
28
+ const hexGenerator = new TokenGenerator({ encoding: 'hex' });
29
+ const hexToken = hexGenerator.generate(16);
30
+ expect(hexToken).toMatch(/^[0-9a-f]+$/i);
31
+ expect(hexToken.length).toBe(32); // 16 bytes = 32 hex chars
32
+
33
+ const base64Generator = new TokenGenerator({ encoding: 'base64' });
34
+ const base64Token = base64Generator.generate(16);
35
+ expect(base64Token).toMatch(/^[A-Za-z0-9+/]+=*$/);
36
+ });
37
+
38
+ it('should reject token length below 16 bytes', () => {
39
+ expect(() => new TokenGenerator({ defaultLength: 8 }))
40
+ .toThrow('Token length must be at least 16 bytes');
41
+ });
42
+ });
43
+
44
+ describe('token uniqueness', () => {
45
+ it('should generate unique tokens each time', () => {
46
+ const generator = new TokenGenerator();
47
+ const tokens = new Set(Array.from({ length: 1000 }, () => generator.generate()));
48
+ expect(tokens.size).toBe(1000);
49
+ });
50
+
51
+ it('should generate unique session tokens', () => {
52
+ const generator = new TokenGenerator();
53
+ const tokens = new Set(Array.from({ length: 100 }, () => generator.generateSessionToken().value));
54
+ expect(tokens.size).toBe(100);
55
+ });
56
+
57
+ it('should generate unique verification codes', () => {
58
+ const generator = new TokenGenerator();
59
+ const codes = new Set(Array.from({ length: 100 }, () => generator.generateVerificationCode().code));
60
+ // Due to 6-digit codes, some collisions are possible but should be rare
61
+ expect(codes.size).toBeGreaterThan(90);
62
+ });
63
+
64
+ it('should generate unique request IDs', () => {
65
+ const generator = new TokenGenerator();
66
+ const ids = new Set(Array.from({ length: 1000 }, () => generator.generateRequestId()));
67
+ expect(ids.size).toBe(1000);
68
+ });
69
+
70
+ it('should generate unique correlation IDs', () => {
71
+ const generator = new TokenGenerator();
72
+ const ids = new Set(Array.from({ length: 1000 }, () => generator.generateCorrelationId()));
73
+ expect(ids.size).toBe(1000);
74
+ });
75
+ });
76
+
77
+ describe('timing-safe comparison', () => {
78
+ it('should return true for equal tokens', () => {
79
+ const generator = new TokenGenerator();
80
+ const token = generator.generate();
81
+ expect(generator.compare(token, token)).toBe(true);
82
+ });
83
+
84
+ it('should return false for different tokens', () => {
85
+ const generator = new TokenGenerator();
86
+ const token1 = generator.generate();
87
+ const token2 = generator.generate();
88
+ expect(generator.compare(token1, token2)).toBe(false);
89
+ });
90
+
91
+ it('should return false for different length strings', () => {
92
+ const generator = new TokenGenerator();
93
+ expect(generator.compare('short', 'muchlongerstring')).toBe(false);
94
+ });
95
+
96
+ it('should perform constant-time comparison', () => {
97
+ const generator = new TokenGenerator();
98
+ const token = 'a'.repeat(100);
99
+
100
+ // Compare with identical string should work
101
+ expect(generator.compare(token, token)).toBe(true);
102
+
103
+ // Compare with different strings at various positions
104
+ const differentAtStart = 'b' + 'a'.repeat(99);
105
+ const differentAtEnd = 'a'.repeat(99) + 'b';
106
+
107
+ expect(generator.compare(token, differentAtStart)).toBe(false);
108
+ expect(generator.compare(token, differentAtEnd)).toBe(false);
109
+ });
110
+ });
111
+
112
+ describe('signed tokens', () => {
113
+ it('should require HMAC secret for signed tokens', () => {
114
+ const generator = new TokenGenerator();
115
+ expect(() => generator.generateSignedToken({ userId: '123' }))
116
+ .toThrow('HMAC secret required for signed tokens');
117
+ });
118
+
119
+ it('should generate valid signed tokens', () => {
120
+ const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
121
+ const signed = generator.generateSignedToken({ userId: '123' });
122
+
123
+ expect(signed.token).toBeDefined();
124
+ expect(signed.signature).toBeDefined();
125
+ expect(signed.combined).toBe(`${signed.token}.${signed.signature}`);
126
+ expect(signed.createdAt).toBeInstanceOf(Date);
127
+ expect(signed.expiresAt).toBeInstanceOf(Date);
128
+ });
129
+
130
+ it('should verify valid signed tokens', () => {
131
+ const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
132
+ const signed = generator.generateSignedToken({ userId: '123', role: 'admin' });
133
+
134
+ const payload = generator.verifySignedToken(signed.combined);
135
+ expect(payload).not.toBeNull();
136
+ expect(payload!.userId).toBe('123');
137
+ expect(payload!.role).toBe('admin');
138
+ });
139
+
140
+ it('should reject tampered tokens', () => {
141
+ const generator = new TokenGenerator({ hmacSecret: 'test-secret-key-123' });
142
+ const signed = generator.generateSignedToken({ userId: '123' });
143
+
144
+ // Tamper with signature
145
+ const tampered = signed.combined.slice(0, -5) + 'xxxxx';
146
+ expect(generator.verifySignedToken(tampered)).toBeNull();
147
+ });
148
+
149
+ it('should reject tokens with wrong secret', () => {
150
+ const generator1 = new TokenGenerator({ hmacSecret: 'secret-1' });
151
+ const generator2 = new TokenGenerator({ hmacSecret: 'secret-2' });
152
+
153
+ const signed = generator1.generateSignedToken({ userId: '123' });
154
+ expect(generator2.verifySignedToken(signed.combined)).toBeNull();
155
+ });
156
+
157
+ it('should reject expired signed tokens', async () => {
158
+ const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
159
+ const signed = generator.generateSignedToken({ userId: '123' }, 0); // Expires immediately
160
+
161
+ // Wait a tiny bit for expiration
162
+ await new Promise(resolve => setTimeout(resolve, 10));
163
+ expect(generator.verifySignedToken(signed.combined)).toBeNull();
164
+ });
165
+
166
+ it('should reject malformed token format', () => {
167
+ const generator = new TokenGenerator({ hmacSecret: 'test-secret' });
168
+
169
+ expect(generator.verifySignedToken('no-dot-in-token')).toBeNull();
170
+ expect(generator.verifySignedToken('too.many.dots')).toBeNull();
171
+ expect(generator.verifySignedToken('')).toBeNull();
172
+ });
173
+ });
174
+
175
+ describe('token expiration', () => {
176
+ it('should create tokens with expiration', () => {
177
+ const generator = new TokenGenerator();
178
+ const token = generator.generateWithExpiration(3600);
179
+
180
+ expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 3600 * 1000);
181
+ });
182
+
183
+ it('should use default expiration', () => {
184
+ const generator = new TokenGenerator({ defaultExpiration: 7200 });
185
+ const token = generator.generateWithExpiration();
186
+
187
+ expect(token.expiresAt.getTime()).toBe(token.createdAt.getTime() + 7200 * 1000);
188
+ });
189
+
190
+ it('should correctly identify expired tokens', () => {
191
+ const generator = new TokenGenerator();
192
+
193
+ const expiredToken = {
194
+ value: 'test',
195
+ createdAt: new Date(Date.now() - 10000),
196
+ expiresAt: new Date(Date.now() - 5000),
197
+ };
198
+ expect(generator.isExpired(expiredToken)).toBe(true);
199
+
200
+ const validToken = {
201
+ value: 'test',
202
+ createdAt: new Date(),
203
+ expiresAt: new Date(Date.now() + 10000),
204
+ };
205
+ expect(generator.isExpired(validToken)).toBe(false);
206
+ });
207
+ });
208
+
209
+ describe('specialized token types', () => {
210
+ it('should generate session tokens with expiration', () => {
211
+ const generator = new TokenGenerator();
212
+ const token = generator.generateSessionToken();
213
+
214
+ expect(token.value).toBeDefined();
215
+ expect(token.expiresAt.getTime()).toBeGreaterThan(token.createdAt.getTime());
216
+ });
217
+
218
+ it('should generate CSRF tokens with 30-minute expiration', () => {
219
+ const generator = new TokenGenerator();
220
+ const token = generator.generateCsrfToken();
221
+
222
+ const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
223
+ expect(token.expiresAt.getTime()).toBe(expectedExpiry);
224
+ });
225
+
226
+ it('should generate API tokens with prefix and 1-year expiration', () => {
227
+ const generator = new TokenGenerator();
228
+ const token = generator.generateApiToken('api_');
229
+
230
+ expect(token.value.startsWith('api_')).toBe(true);
231
+
232
+ const oneYear = 365 * 24 * 60 * 60 * 1000;
233
+ expect(token.expiresAt.getTime()).toBeCloseTo(token.createdAt.getTime() + oneYear, -3);
234
+ });
235
+
236
+ it('should generate password reset tokens with 30-minute expiration', () => {
237
+ const generator = new TokenGenerator();
238
+ const token = generator.generatePasswordResetToken();
239
+
240
+ const expectedExpiry = token.createdAt.getTime() + 1800 * 1000;
241
+ expect(token.expiresAt.getTime()).toBe(expectedExpiry);
242
+ });
243
+
244
+ it('should generate email verification tokens with 24-hour expiration', () => {
245
+ const generator = new TokenGenerator();
246
+ const token = generator.generateEmailVerificationToken();
247
+
248
+ const expectedExpiry = token.createdAt.getTime() + 86400 * 1000;
249
+ expect(token.expiresAt.getTime()).toBe(expectedExpiry);
250
+ });
251
+
252
+ it('should generate token pairs (access + refresh)', () => {
253
+ const generator = new TokenGenerator();
254
+ const pair = generator.generateTokenPair();
255
+
256
+ expect(pair.accessToken).toBeDefined();
257
+ expect(pair.refreshToken).toBeDefined();
258
+
259
+ // Access token: 15 minutes
260
+ expect(pair.accessToken.expiresAt.getTime()).toBe(
261
+ pair.accessToken.createdAt.getTime() + 900 * 1000
262
+ );
263
+
264
+ // Refresh token: 7 days
265
+ expect(pair.refreshToken.expiresAt.getTime()).toBe(
266
+ pair.refreshToken.createdAt.getTime() + 604800 * 1000
267
+ );
268
+ });
269
+ });
270
+
271
+ describe('verification codes', () => {
272
+ it('should generate numeric codes of specified length', () => {
273
+ const generator = new TokenGenerator();
274
+
275
+ const code6 = generator.generateVerificationCode(6);
276
+ expect(code6.code).toMatch(/^\d{6}$/);
277
+
278
+ const code8 = generator.generateVerificationCode(8);
279
+ expect(code8.code).toMatch(/^\d{8}$/);
280
+ });
281
+
282
+ it('should set expiration and attempt limits', () => {
283
+ const generator = new TokenGenerator();
284
+ const code = generator.generateVerificationCode(6, 15, 5);
285
+
286
+ expect(code.attempts).toBe(0);
287
+ expect(code.maxAttempts).toBe(5);
288
+ expect(code.expiresAt.getTime()).toBe(code.createdAt.getTime() + 15 * 60 * 1000);
289
+ });
290
+ });
291
+
292
+ describe('correlation and request IDs', () => {
293
+ it('should generate short request IDs', () => {
294
+ const generator = new TokenGenerator();
295
+ const id = generator.generateRequestId();
296
+
297
+ // 8 bytes = 11 chars in base64url
298
+ expect(id.length).toBe(11);
299
+ });
300
+
301
+ it('should generate correlation IDs with timestamp prefix', () => {
302
+ const generator = new TokenGenerator();
303
+ const id = generator.generateCorrelationId();
304
+
305
+ expect(id).toMatch(/^[a-z0-9]+-[A-Za-z0-9_-]+$/);
306
+ const [timestamp] = id.split('-');
307
+ expect(parseInt(timestamp, 36)).toBeGreaterThan(0);
308
+ });
309
+ });
310
+ });
@@ -223,15 +223,15 @@ export class CredentialGenerator {
223
223
  * @returns Environment variable export script
224
224
  */
225
225
  createEnvScript(credentials) {
226
- return `# Claude Flow V3 - Generated Credentials
227
- # Generated: ${credentials.generatedAt.toISOString()}
228
- # IMPORTANT: Store these securely and delete this file after use
229
-
230
- export CLAUDE_FLOW_ADMIN_PASSWORD="${credentials.adminPassword}"
231
- export CLAUDE_FLOW_SERVICE_PASSWORD="${credentials.servicePassword}"
232
- export CLAUDE_FLOW_JWT_SECRET="${credentials.jwtSecret}"
233
- export CLAUDE_FLOW_SESSION_SECRET="${credentials.sessionSecret}"
234
- export CLAUDE_FLOW_ENCRYPTION_KEY="${credentials.encryptionKey}"
226
+ return `# Claude Flow V3 - Generated Credentials
227
+ # Generated: ${credentials.generatedAt.toISOString()}
228
+ # IMPORTANT: Store these securely and delete this file after use
229
+
230
+ export CLAUDE_FLOW_ADMIN_PASSWORD="${credentials.adminPassword}"
231
+ export CLAUDE_FLOW_SERVICE_PASSWORD="${credentials.servicePassword}"
232
+ export CLAUDE_FLOW_JWT_SECRET="${credentials.jwtSecret}"
233
+ export CLAUDE_FLOW_SESSION_SECRET="${credentials.sessionSecret}"
234
+ export CLAUDE_FLOW_ENCRYPTION_KEY="${credentials.encryptionKey}"
235
235
  `;
236
236
  }
237
237
  /**