@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,182 +1,182 @@
1
- import { describe, it, expect } from 'vitest';
2
- import { CredentialGenerator } from '../../src/credential-generator.js';
3
-
4
- describe('CredentialGenerator', () => {
5
- describe('generatePassword', () => {
6
- it('should generate passwords meeting complexity requirements', () => {
7
- const generator = new CredentialGenerator();
8
- const password = generator.generatePassword();
9
-
10
- expect(password.length).toBeGreaterThanOrEqual(32);
11
- expect(/[A-Z]/.test(password)).toBe(true);
12
- expect(/[a-z]/.test(password)).toBe(true);
13
- expect(/\d/.test(password)).toBe(true);
14
- });
15
-
16
- it('should generate unique passwords each time', () => {
17
- const generator = new CredentialGenerator();
18
- const passwords = new Set(Array.from({ length: 100 }, () => generator.generatePassword()));
19
- expect(passwords.size).toBe(100);
20
- });
21
-
22
- it('should respect custom length parameter', () => {
23
- const generator = new CredentialGenerator();
24
- const password = generator.generatePassword(64);
25
- expect(password.length).toBe(64);
26
- });
27
-
28
- it('should include special characters by default', () => {
29
- const generator = new CredentialGenerator();
30
- const password = generator.generatePassword();
31
- expect(/[!@#$%^&*()_+\-=\[\]{}|;:,.<>?]/.test(password)).toBe(true);
32
- });
33
- });
34
-
35
- describe('generateApiKey', () => {
36
- it('should generate API keys with prefix', () => {
37
- const generator = new CredentialGenerator();
38
- const key = generator.generateApiKey('test_');
39
- expect(key.key.startsWith('test_')).toBe(true);
40
- });
41
-
42
- it('should generate API keys with default prefix', () => {
43
- const generator = new CredentialGenerator();
44
- const key = generator.generateApiKey();
45
- expect(key.key.startsWith('cf_')).toBe(true);
46
- });
47
-
48
- it('should include keyId as UUID', () => {
49
- const generator = new CredentialGenerator();
50
- const key = generator.generateApiKey();
51
- expect(key.keyId).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
52
- });
53
-
54
- it('should include createdAt timestamp', () => {
55
- const generator = new CredentialGenerator();
56
- const before = new Date();
57
- const key = generator.generateApiKey();
58
- const after = new Date();
59
- expect(key.createdAt.getTime()).toBeGreaterThanOrEqual(before.getTime());
60
- expect(key.createdAt.getTime()).toBeLessThanOrEqual(after.getTime());
61
- });
62
-
63
- it('should generate unique keys each time', () => {
64
- const generator = new CredentialGenerator();
65
- const keys = new Set(Array.from({ length: 100 }, () => generator.generateApiKey().key));
66
- expect(keys.size).toBe(100);
67
- });
68
- });
69
-
70
- describe('generateSecret', () => {
71
- it('should generate hex-encoded secrets', () => {
72
- const generator = new CredentialGenerator();
73
- const secret = generator.generateSecret();
74
- expect(/^[0-9a-f]+$/i.test(secret)).toBe(true);
75
- });
76
-
77
- it('should generate secrets with default length', () => {
78
- const generator = new CredentialGenerator();
79
- const secret = generator.generateSecret();
80
- expect(secret.length).toBe(64);
81
- });
82
-
83
- it('should generate secrets with custom length', () => {
84
- const generator = new CredentialGenerator();
85
- const secret = generator.generateSecret(128);
86
- expect(secret.length).toBe(128);
87
- });
88
- });
89
-
90
- describe('generateEncryptionKey', () => {
91
- it('should generate 64-character hex key (32 bytes)', () => {
92
- const generator = new CredentialGenerator();
93
- const key = generator.generateEncryptionKey();
94
- expect(key.length).toBe(64);
95
- expect(/^[0-9a-f]+$/i.test(key)).toBe(true);
96
- });
97
- });
98
-
99
- describe('generateInstallationCredentials', () => {
100
- it('should generate complete credential set', () => {
101
- const generator = new CredentialGenerator();
102
- const creds = generator.generateInstallationCredentials();
103
-
104
- expect(creds.adminPassword).toBeDefined();
105
- expect(creds.servicePassword).toBeDefined();
106
- expect(creds.jwtSecret).toBeDefined();
107
- expect(creds.sessionSecret).toBeDefined();
108
- expect(creds.encryptionKey).toBeDefined();
109
- expect(creds.generatedAt).toBeInstanceOf(Date);
110
- });
111
-
112
- it('should set expiration when specified', () => {
113
- const generator = new CredentialGenerator();
114
- const creds = generator.generateInstallationCredentials(30);
115
-
116
- expect(creds.expiresAt).toBeDefined();
117
- const expectedExpiry = new Date(creds.generatedAt.getTime() + 30 * 24 * 60 * 60 * 1000);
118
- expect(creds.expiresAt!.getTime()).toBeCloseTo(expectedExpiry.getTime(), -3);
119
- });
120
- });
121
-
122
- describe('configuration validation', () => {
123
- it('should reject password length below 16', () => {
124
- expect(() => new CredentialGenerator({ passwordLength: 8 }))
125
- .toThrow('Password length must be at least 16 characters');
126
- });
127
-
128
- it('should reject API key length below 32', () => {
129
- expect(() => new CredentialGenerator({ apiKeyLength: 16 }))
130
- .toThrow('API key length must be at least 32 characters');
131
- });
132
-
133
- it('should reject secret length below 32', () => {
134
- expect(() => new CredentialGenerator({ secretLength: 16 }))
135
- .toThrow('Secret length must be at least 32 characters');
136
- });
137
- });
138
-
139
- describe('utility methods', () => {
140
- it('should generate session tokens', () => {
141
- const generator = new CredentialGenerator();
142
- const token = generator.generateSessionToken();
143
- expect(token.length).toBe(64);
144
- });
145
-
146
- it('should generate CSRF tokens', () => {
147
- const generator = new CredentialGenerator();
148
- const token = generator.generateCsrfToken();
149
- expect(token).toBeDefined();
150
- expect(token.length).toBeGreaterThan(0);
151
- });
152
-
153
- it('should generate nonces', () => {
154
- const generator = new CredentialGenerator();
155
- const nonce = generator.generateNonce();
156
- expect(nonce.length).toBe(32);
157
- expect(/^[0-9a-f]+$/i.test(nonce)).toBe(true);
158
- });
159
- });
160
-
161
- describe('output generation', () => {
162
- it('should create env script format', () => {
163
- const generator = new CredentialGenerator();
164
- const creds = generator.generateInstallationCredentials();
165
- const script = generator.createEnvScript(creds);
166
-
167
- expect(script).toContain('CLAUDE_FLOW_ADMIN_PASSWORD');
168
- expect(script).toContain('CLAUDE_FLOW_JWT_SECRET');
169
- expect(script).toContain('export');
170
- });
171
-
172
- it('should create JSON config format', () => {
173
- const generator = new CredentialGenerator();
174
- const creds = generator.generateInstallationCredentials();
175
- const json = generator.createJsonConfig(creds);
176
-
177
- const parsed = JSON.parse(json);
178
- expect(parsed['claude-flow/admin-password']).toBeDefined();
179
- expect(parsed['claude-flow/jwt-secret']).toBeDefined();
180
- });
181
- });
182
- });
1
+ import { describe, it, expect } from 'vitest';
2
+ import { CredentialGenerator } from '../../src/credential-generator.js';
3
+
4
+ describe('CredentialGenerator', () => {
5
+ describe('generatePassword', () => {
6
+ it('should generate passwords meeting complexity requirements', () => {
7
+ const generator = new CredentialGenerator();
8
+ const password = generator.generatePassword();
9
+
10
+ expect(password.length).toBeGreaterThanOrEqual(32);
11
+ expect(/[A-Z]/.test(password)).toBe(true);
12
+ expect(/[a-z]/.test(password)).toBe(true);
13
+ expect(/\d/.test(password)).toBe(true);
14
+ });
15
+
16
+ it('should generate unique passwords each time', () => {
17
+ const generator = new CredentialGenerator();
18
+ const passwords = new Set(Array.from({ length: 100 }, () => generator.generatePassword()));
19
+ expect(passwords.size).toBe(100);
20
+ });
21
+
22
+ it('should respect custom length parameter', () => {
23
+ const generator = new CredentialGenerator();
24
+ const password = generator.generatePassword(64);
25
+ expect(password.length).toBe(64);
26
+ });
27
+
28
+ it('should include special characters by default', () => {
29
+ const generator = new CredentialGenerator();
30
+ const password = generator.generatePassword();
31
+ expect(/[!@#$%^&*()_+\-=\[\]{}|;:,.<>?]/.test(password)).toBe(true);
32
+ });
33
+ });
34
+
35
+ describe('generateApiKey', () => {
36
+ it('should generate API keys with prefix', () => {
37
+ const generator = new CredentialGenerator();
38
+ const key = generator.generateApiKey('test_');
39
+ expect(key.key.startsWith('test_')).toBe(true);
40
+ });
41
+
42
+ it('should generate API keys with default prefix', () => {
43
+ const generator = new CredentialGenerator();
44
+ const key = generator.generateApiKey();
45
+ expect(key.key.startsWith('cf_')).toBe(true);
46
+ });
47
+
48
+ it('should include keyId as UUID', () => {
49
+ const generator = new CredentialGenerator();
50
+ const key = generator.generateApiKey();
51
+ expect(key.keyId).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
52
+ });
53
+
54
+ it('should include createdAt timestamp', () => {
55
+ const generator = new CredentialGenerator();
56
+ const before = new Date();
57
+ const key = generator.generateApiKey();
58
+ const after = new Date();
59
+ expect(key.createdAt.getTime()).toBeGreaterThanOrEqual(before.getTime());
60
+ expect(key.createdAt.getTime()).toBeLessThanOrEqual(after.getTime());
61
+ });
62
+
63
+ it('should generate unique keys each time', () => {
64
+ const generator = new CredentialGenerator();
65
+ const keys = new Set(Array.from({ length: 100 }, () => generator.generateApiKey().key));
66
+ expect(keys.size).toBe(100);
67
+ });
68
+ });
69
+
70
+ describe('generateSecret', () => {
71
+ it('should generate hex-encoded secrets', () => {
72
+ const generator = new CredentialGenerator();
73
+ const secret = generator.generateSecret();
74
+ expect(/^[0-9a-f]+$/i.test(secret)).toBe(true);
75
+ });
76
+
77
+ it('should generate secrets with default length', () => {
78
+ const generator = new CredentialGenerator();
79
+ const secret = generator.generateSecret();
80
+ expect(secret.length).toBe(64);
81
+ });
82
+
83
+ it('should generate secrets with custom length', () => {
84
+ const generator = new CredentialGenerator();
85
+ const secret = generator.generateSecret(128);
86
+ expect(secret.length).toBe(128);
87
+ });
88
+ });
89
+
90
+ describe('generateEncryptionKey', () => {
91
+ it('should generate 64-character hex key (32 bytes)', () => {
92
+ const generator = new CredentialGenerator();
93
+ const key = generator.generateEncryptionKey();
94
+ expect(key.length).toBe(64);
95
+ expect(/^[0-9a-f]+$/i.test(key)).toBe(true);
96
+ });
97
+ });
98
+
99
+ describe('generateInstallationCredentials', () => {
100
+ it('should generate complete credential set', () => {
101
+ const generator = new CredentialGenerator();
102
+ const creds = generator.generateInstallationCredentials();
103
+
104
+ expect(creds.adminPassword).toBeDefined();
105
+ expect(creds.servicePassword).toBeDefined();
106
+ expect(creds.jwtSecret).toBeDefined();
107
+ expect(creds.sessionSecret).toBeDefined();
108
+ expect(creds.encryptionKey).toBeDefined();
109
+ expect(creds.generatedAt).toBeInstanceOf(Date);
110
+ });
111
+
112
+ it('should set expiration when specified', () => {
113
+ const generator = new CredentialGenerator();
114
+ const creds = generator.generateInstallationCredentials(30);
115
+
116
+ expect(creds.expiresAt).toBeDefined();
117
+ const expectedExpiry = new Date(creds.generatedAt.getTime() + 30 * 24 * 60 * 60 * 1000);
118
+ expect(creds.expiresAt!.getTime()).toBeCloseTo(expectedExpiry.getTime(), -3);
119
+ });
120
+ });
121
+
122
+ describe('configuration validation', () => {
123
+ it('should reject password length below 16', () => {
124
+ expect(() => new CredentialGenerator({ passwordLength: 8 }))
125
+ .toThrow('Password length must be at least 16 characters');
126
+ });
127
+
128
+ it('should reject API key length below 32', () => {
129
+ expect(() => new CredentialGenerator({ apiKeyLength: 16 }))
130
+ .toThrow('API key length must be at least 32 characters');
131
+ });
132
+
133
+ it('should reject secret length below 32', () => {
134
+ expect(() => new CredentialGenerator({ secretLength: 16 }))
135
+ .toThrow('Secret length must be at least 32 characters');
136
+ });
137
+ });
138
+
139
+ describe('utility methods', () => {
140
+ it('should generate session tokens', () => {
141
+ const generator = new CredentialGenerator();
142
+ const token = generator.generateSessionToken();
143
+ expect(token.length).toBe(64);
144
+ });
145
+
146
+ it('should generate CSRF tokens', () => {
147
+ const generator = new CredentialGenerator();
148
+ const token = generator.generateCsrfToken();
149
+ expect(token).toBeDefined();
150
+ expect(token.length).toBeGreaterThan(0);
151
+ });
152
+
153
+ it('should generate nonces', () => {
154
+ const generator = new CredentialGenerator();
155
+ const nonce = generator.generateNonce();
156
+ expect(nonce.length).toBe(32);
157
+ expect(/^[0-9a-f]+$/i.test(nonce)).toBe(true);
158
+ });
159
+ });
160
+
161
+ describe('output generation', () => {
162
+ it('should create env script format', () => {
163
+ const generator = new CredentialGenerator();
164
+ const creds = generator.generateInstallationCredentials();
165
+ const script = generator.createEnvScript(creds);
166
+
167
+ expect(script).toContain('CLAUDE_FLOW_ADMIN_PASSWORD');
168
+ expect(script).toContain('CLAUDE_FLOW_JWT_SECRET');
169
+ expect(script).toContain('export');
170
+ });
171
+
172
+ it('should create JSON config format', () => {
173
+ const generator = new CredentialGenerator();
174
+ const creds = generator.generateInstallationCredentials();
175
+ const json = generator.createJsonConfig(creds);
176
+
177
+ const parsed = JSON.parse(json);
178
+ expect(parsed['claude-flow/admin-password']).toBeDefined();
179
+ expect(parsed['claude-flow/jwt-secret']).toBeDefined();
180
+ });
181
+ });
182
+ });