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

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 (96) hide show
  1. package/README.md +234 -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 -419
  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 -381
  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/dist/domain/services/security-domain-service.js +1 -1
  21. package/dist/domain/services/security-domain-service.js.map +1 -1
  22. package/dist/index.d.ts +1 -1
  23. package/dist/index.js +1 -1
  24. package/dist/index.js.map +1 -1
  25. package/dist/password-hasher.d.ts.map +1 -1
  26. package/dist/password-hasher.js +8 -1
  27. package/dist/password-hasher.js.map +1 -1
  28. package/dist/safe-executor.d.ts +7 -0
  29. package/dist/safe-executor.d.ts.map +1 -1
  30. package/dist/safe-executor.js +21 -1
  31. package/dist/safe-executor.js.map +1 -1
  32. package/package.json +27 -28
  33. package/src/CVE-REMEDIATION.ts +251 -251
  34. package/src/application/index.ts +10 -10
  35. package/src/application/services/security-application-service.ts +193 -193
  36. package/src/credential-generator.ts +368 -368
  37. package/src/domain/entities/security-context.ts +173 -173
  38. package/src/domain/index.ts +17 -17
  39. package/src/domain/services/security-domain-service.ts +296 -296
  40. package/src/index.ts +271 -271
  41. package/src/input-validator.ts +466 -466
  42. package/src/password-hasher.ts +277 -270
  43. package/src/path-validator.ts +525 -525
  44. package/src/safe-executor.ts +546 -525
  45. package/src/token-generator.ts +463 -463
  46. package/tmp.json +0 -0
  47. package/tsconfig.json +9 -9
  48. package/tsconfig.tsbuildinfo +1 -1
  49. package/vitest.config.ts +20 -0
  50. package/.agentic-flow/intelligence.json +0 -16
  51. package/__tests__/coverage/base.css +0 -224
  52. package/__tests__/coverage/block-navigation.js +0 -87
  53. package/__tests__/coverage/coverage-final.json +0 -11
  54. package/__tests__/coverage/favicon.png +0 -0
  55. package/__tests__/coverage/index.html +0 -161
  56. package/__tests__/coverage/lcov-report/base.css +0 -224
  57. package/__tests__/coverage/lcov-report/block-navigation.js +0 -87
  58. package/__tests__/coverage/lcov-report/favicon.png +0 -0
  59. package/__tests__/coverage/lcov-report/index.html +0 -161
  60. package/__tests__/coverage/lcov-report/prettify.css +0 -1
  61. package/__tests__/coverage/lcov-report/prettify.js +0 -2
  62. package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  63. package/__tests__/coverage/lcov-report/sorter.js +0 -210
  64. package/__tests__/coverage/lcov-report/src/CVE-REMEDIATION.ts.html +0 -838
  65. package/__tests__/coverage/lcov-report/src/application/services/index.html +0 -116
  66. package/__tests__/coverage/lcov-report/src/application/services/security-application-service.ts.html +0 -664
  67. package/__tests__/coverage/lcov-report/src/credential-generator.ts.html +0 -1189
  68. package/__tests__/coverage/lcov-report/src/domain/entities/index.html +0 -116
  69. package/__tests__/coverage/lcov-report/src/domain/entities/security-context.ts.html +0 -604
  70. package/__tests__/coverage/lcov-report/src/domain/services/index.html +0 -116
  71. package/__tests__/coverage/lcov-report/src/domain/services/security-domain-service.ts.html +0 -973
  72. package/__tests__/coverage/lcov-report/src/index.html +0 -206
  73. package/__tests__/coverage/lcov-report/src/input-validator.ts.html +0 -1483
  74. package/__tests__/coverage/lcov-report/src/password-hasher.ts.html +0 -895
  75. package/__tests__/coverage/lcov-report/src/path-validator.ts.html +0 -1660
  76. package/__tests__/coverage/lcov-report/src/safe-executor.ts.html +0 -1660
  77. package/__tests__/coverage/lcov-report/src/token-generator.ts.html +0 -1474
  78. package/__tests__/coverage/lcov.info +0 -3650
  79. package/__tests__/coverage/prettify.css +0 -1
  80. package/__tests__/coverage/prettify.js +0 -2
  81. package/__tests__/coverage/sort-arrow-sprite.png +0 -0
  82. package/__tests__/coverage/sorter.js +0 -210
  83. package/__tests__/coverage/src/CVE-REMEDIATION.ts.html +0 -838
  84. package/__tests__/coverage/src/application/services/index.html +0 -116
  85. package/__tests__/coverage/src/application/services/security-application-service.ts.html +0 -664
  86. package/__tests__/coverage/src/credential-generator.ts.html +0 -1189
  87. package/__tests__/coverage/src/domain/entities/index.html +0 -116
  88. package/__tests__/coverage/src/domain/entities/security-context.ts.html +0 -604
  89. package/__tests__/coverage/src/domain/services/index.html +0 -116
  90. package/__tests__/coverage/src/domain/services/security-domain-service.ts.html +0 -973
  91. package/__tests__/coverage/src/index.html +0 -206
  92. package/__tests__/coverage/src/input-validator.ts.html +0 -1483
  93. package/__tests__/coverage/src/password-hasher.ts.html +0 -895
  94. package/__tests__/coverage/src/path-validator.ts.html +0 -1660
  95. package/__tests__/coverage/src/safe-executor.ts.html +0 -1660
  96. package/__tests__/coverage/src/token-generator.ts.html +0 -1474
@@ -1,182 +1,182 @@
1
- import { describe, it, expect } from 'vitest';
2
- import { CredentialGenerator } from '../../../security/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
+ });