@friggframework/devtools 2.0.0-next.44 → 2.0.0-next.46

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 (212) hide show
  1. package/infrastructure/ARCHITECTURE.md +487 -0
  2. package/infrastructure/HEALTH.md +468 -0
  3. package/infrastructure/README.md +51 -0
  4. package/infrastructure/__tests__/postgres-config.test.js +914 -0
  5. package/infrastructure/__tests__/template-generation.test.js +687 -0
  6. package/infrastructure/create-frigg-infrastructure.js +1 -1
  7. package/infrastructure/docs/POSTGRES-CONFIGURATION.md +630 -0
  8. package/infrastructure/{DEPLOYMENT-INSTRUCTIONS.md → docs/deployment-instructions.md} +3 -3
  9. package/infrastructure/{IAM-POLICY-TEMPLATES.md → docs/iam-policy-templates.md} +9 -10
  10. package/infrastructure/domains/database/aurora-builder.js +809 -0
  11. package/infrastructure/domains/database/aurora-builder.test.js +950 -0
  12. package/infrastructure/domains/database/aurora-discovery.js +87 -0
  13. package/infrastructure/domains/database/aurora-discovery.test.js +188 -0
  14. package/infrastructure/domains/database/aurora-resolver.js +210 -0
  15. package/infrastructure/domains/database/aurora-resolver.test.js +347 -0
  16. package/infrastructure/domains/database/migration-builder.js +633 -0
  17. package/infrastructure/domains/database/migration-builder.test.js +294 -0
  18. package/infrastructure/domains/database/migration-resolver.js +163 -0
  19. package/infrastructure/domains/database/migration-resolver.test.js +337 -0
  20. package/infrastructure/domains/health/application/ports/IPropertyReconciler.js +164 -0
  21. package/infrastructure/domains/health/application/ports/IResourceDetector.js +129 -0
  22. package/infrastructure/domains/health/application/ports/IResourceImporter.js +142 -0
  23. package/infrastructure/domains/health/application/ports/IStackRepository.js +131 -0
  24. package/infrastructure/domains/health/application/ports/index.js +26 -0
  25. package/infrastructure/domains/health/application/use-cases/__tests__/execute-resource-import-use-case.test.js +679 -0
  26. package/infrastructure/domains/health/application/use-cases/__tests__/mismatch-analyzer-method-name.test.js +167 -0
  27. package/infrastructure/domains/health/application/use-cases/__tests__/repair-via-import-use-case.test.js +1130 -0
  28. package/infrastructure/domains/health/application/use-cases/execute-resource-import-use-case.js +221 -0
  29. package/infrastructure/domains/health/application/use-cases/reconcile-properties-use-case.js +152 -0
  30. package/infrastructure/domains/health/application/use-cases/reconcile-properties-use-case.test.js +343 -0
  31. package/infrastructure/domains/health/application/use-cases/repair-via-import-use-case.js +535 -0
  32. package/infrastructure/domains/health/application/use-cases/repair-via-import-use-case.test.js +376 -0
  33. package/infrastructure/domains/health/application/use-cases/run-health-check-use-case.js +213 -0
  34. package/infrastructure/domains/health/application/use-cases/run-health-check-use-case.test.js +441 -0
  35. package/infrastructure/domains/health/docs/ACME-DEV-DRIFT-ANALYSIS.md +267 -0
  36. package/infrastructure/domains/health/docs/BUILD-VS-DEPLOYED-TEMPLATE-ANALYSIS.md +324 -0
  37. package/infrastructure/domains/health/docs/ORPHAN-DETECTION-ANALYSIS.md +386 -0
  38. package/infrastructure/domains/health/docs/SPEC-CLEANUP-COMMAND.md +1419 -0
  39. package/infrastructure/domains/health/docs/TDD-IMPLEMENTATION-SUMMARY.md +391 -0
  40. package/infrastructure/domains/health/docs/TEMPLATE-COMPARISON-IMPLEMENTATION.md +551 -0
  41. package/infrastructure/domains/health/domain/entities/issue.js +299 -0
  42. package/infrastructure/domains/health/domain/entities/issue.test.js +528 -0
  43. package/infrastructure/domains/health/domain/entities/property-mismatch.js +108 -0
  44. package/infrastructure/domains/health/domain/entities/property-mismatch.test.js +275 -0
  45. package/infrastructure/domains/health/domain/entities/resource.js +159 -0
  46. package/infrastructure/domains/health/domain/entities/resource.test.js +432 -0
  47. package/infrastructure/domains/health/domain/entities/stack-health-report.js +306 -0
  48. package/infrastructure/domains/health/domain/entities/stack-health-report.test.js +601 -0
  49. package/infrastructure/domains/health/domain/services/__tests__/health-score-percentage-based.test.js +380 -0
  50. package/infrastructure/domains/health/domain/services/__tests__/import-progress-monitor.test.js +971 -0
  51. package/infrastructure/domains/health/domain/services/__tests__/import-template-generator.test.js +1150 -0
  52. package/infrastructure/domains/health/domain/services/__tests__/logical-id-mapper.test.js +672 -0
  53. package/infrastructure/domains/health/domain/services/__tests__/template-parser.test.js +496 -0
  54. package/infrastructure/domains/health/domain/services/__tests__/update-progress-monitor.test.js +419 -0
  55. package/infrastructure/domains/health/domain/services/health-score-calculator.js +248 -0
  56. package/infrastructure/domains/health/domain/services/health-score-calculator.test.js +504 -0
  57. package/infrastructure/domains/health/domain/services/import-progress-monitor.js +195 -0
  58. package/infrastructure/domains/health/domain/services/import-template-generator.js +435 -0
  59. package/infrastructure/domains/health/domain/services/logical-id-mapper.js +345 -0
  60. package/infrastructure/domains/health/domain/services/mismatch-analyzer.js +234 -0
  61. package/infrastructure/domains/health/domain/services/mismatch-analyzer.test.js +431 -0
  62. package/infrastructure/domains/health/domain/services/property-mutability-config.js +382 -0
  63. package/infrastructure/domains/health/domain/services/template-parser.js +245 -0
  64. package/infrastructure/domains/health/domain/services/update-progress-monitor.js +192 -0
  65. package/infrastructure/domains/health/domain/value-objects/health-score.js +138 -0
  66. package/infrastructure/domains/health/domain/value-objects/health-score.test.js +267 -0
  67. package/infrastructure/domains/health/domain/value-objects/property-mutability.js +161 -0
  68. package/infrastructure/domains/health/domain/value-objects/property-mutability.test.js +198 -0
  69. package/infrastructure/domains/health/domain/value-objects/resource-state.js +167 -0
  70. package/infrastructure/domains/health/domain/value-objects/resource-state.test.js +196 -0
  71. package/infrastructure/domains/health/domain/value-objects/stack-identifier.js +192 -0
  72. package/infrastructure/domains/health/domain/value-objects/stack-identifier.test.js +262 -0
  73. package/infrastructure/domains/health/infrastructure/adapters/__tests__/orphan-detection-cfn-tagged.test.js +312 -0
  74. package/infrastructure/domains/health/infrastructure/adapters/__tests__/orphan-detection-multi-stack.test.js +367 -0
  75. package/infrastructure/domains/health/infrastructure/adapters/__tests__/orphan-detection-relationship-analysis.test.js +432 -0
  76. package/infrastructure/domains/health/infrastructure/adapters/aws-property-reconciler.js +784 -0
  77. package/infrastructure/domains/health/infrastructure/adapters/aws-property-reconciler.test.js +1133 -0
  78. package/infrastructure/domains/health/infrastructure/adapters/aws-resource-detector.js +565 -0
  79. package/infrastructure/domains/health/infrastructure/adapters/aws-resource-detector.test.js +554 -0
  80. package/infrastructure/domains/health/infrastructure/adapters/aws-resource-importer.js +318 -0
  81. package/infrastructure/domains/health/infrastructure/adapters/aws-resource-importer.test.js +398 -0
  82. package/infrastructure/domains/health/infrastructure/adapters/aws-stack-repository.js +777 -0
  83. package/infrastructure/domains/health/infrastructure/adapters/aws-stack-repository.test.js +580 -0
  84. package/infrastructure/domains/integration/integration-builder.js +397 -0
  85. package/infrastructure/domains/integration/integration-builder.test.js +593 -0
  86. package/infrastructure/domains/integration/integration-resolver.js +170 -0
  87. package/infrastructure/domains/integration/integration-resolver.test.js +369 -0
  88. package/infrastructure/domains/integration/websocket-builder.js +69 -0
  89. package/infrastructure/domains/integration/websocket-builder.test.js +195 -0
  90. package/infrastructure/domains/networking/vpc-builder.js +1829 -0
  91. package/infrastructure/domains/networking/vpc-builder.test.js +1262 -0
  92. package/infrastructure/domains/networking/vpc-discovery.js +177 -0
  93. package/infrastructure/domains/networking/vpc-discovery.test.js +350 -0
  94. package/infrastructure/domains/networking/vpc-resolver.js +324 -0
  95. package/infrastructure/domains/networking/vpc-resolver.test.js +501 -0
  96. package/infrastructure/domains/parameters/ssm-builder.js +79 -0
  97. package/infrastructure/domains/parameters/ssm-builder.test.js +189 -0
  98. package/infrastructure/domains/parameters/ssm-discovery.js +84 -0
  99. package/infrastructure/domains/parameters/ssm-discovery.test.js +210 -0
  100. package/infrastructure/{iam-generator.js → domains/security/iam-generator.js} +2 -2
  101. package/infrastructure/domains/security/kms-builder.js +366 -0
  102. package/infrastructure/domains/security/kms-builder.test.js +374 -0
  103. package/infrastructure/domains/security/kms-discovery.js +80 -0
  104. package/infrastructure/domains/security/kms-discovery.test.js +177 -0
  105. package/infrastructure/domains/security/kms-resolver.js +96 -0
  106. package/infrastructure/domains/security/kms-resolver.test.js +216 -0
  107. package/infrastructure/domains/shared/base-builder.js +112 -0
  108. package/infrastructure/domains/shared/base-resolver.js +186 -0
  109. package/infrastructure/domains/shared/base-resolver.test.js +305 -0
  110. package/infrastructure/domains/shared/builder-orchestrator.js +212 -0
  111. package/infrastructure/domains/shared/builder-orchestrator.test.js +213 -0
  112. package/infrastructure/domains/shared/cloudformation-discovery-v2.js +334 -0
  113. package/infrastructure/domains/shared/cloudformation-discovery.js +375 -0
  114. package/infrastructure/domains/shared/cloudformation-discovery.test.js +590 -0
  115. package/infrastructure/domains/shared/environment-builder.js +119 -0
  116. package/infrastructure/domains/shared/environment-builder.test.js +247 -0
  117. package/infrastructure/domains/shared/providers/aws-provider-adapter.js +544 -0
  118. package/infrastructure/domains/shared/providers/aws-provider-adapter.test.js +377 -0
  119. package/infrastructure/domains/shared/providers/azure-provider-adapter.stub.js +93 -0
  120. package/infrastructure/domains/shared/providers/cloud-provider-adapter.js +136 -0
  121. package/infrastructure/domains/shared/providers/gcp-provider-adapter.stub.js +82 -0
  122. package/infrastructure/domains/shared/providers/provider-factory.js +108 -0
  123. package/infrastructure/domains/shared/providers/provider-factory.test.js +170 -0
  124. package/infrastructure/domains/shared/resource-discovery.js +192 -0
  125. package/infrastructure/domains/shared/resource-discovery.test.js +552 -0
  126. package/infrastructure/domains/shared/types/app-definition.js +205 -0
  127. package/infrastructure/domains/shared/types/discovery-result.js +106 -0
  128. package/infrastructure/domains/shared/types/discovery-result.test.js +258 -0
  129. package/infrastructure/domains/shared/types/index.js +46 -0
  130. package/infrastructure/domains/shared/types/resource-ownership.js +108 -0
  131. package/infrastructure/domains/shared/types/resource-ownership.test.js +101 -0
  132. package/infrastructure/domains/shared/utilities/base-definition-factory.js +380 -0
  133. package/infrastructure/domains/shared/utilities/base-definition-factory.js.bak +338 -0
  134. package/infrastructure/domains/shared/utilities/base-definition-factory.test.js +248 -0
  135. package/infrastructure/domains/shared/utilities/handler-path-resolver.js +134 -0
  136. package/infrastructure/domains/shared/utilities/handler-path-resolver.test.js +268 -0
  137. package/infrastructure/domains/shared/utilities/prisma-layer-manager.js +55 -0
  138. package/infrastructure/domains/shared/utilities/prisma-layer-manager.test.js +138 -0
  139. package/infrastructure/{env-validator.js → domains/shared/validation/env-validator.js} +2 -1
  140. package/infrastructure/domains/shared/validation/env-validator.test.js +173 -0
  141. package/infrastructure/esbuild.config.js +53 -0
  142. package/infrastructure/infrastructure-composer.js +87 -0
  143. package/infrastructure/{serverless-template.test.js → infrastructure-composer.test.js} +115 -24
  144. package/infrastructure/scripts/build-prisma-layer.js +553 -0
  145. package/infrastructure/scripts/build-prisma-layer.test.js +102 -0
  146. package/infrastructure/{build-time-discovery.js → scripts/build-time-discovery.js} +80 -48
  147. package/infrastructure/{build-time-discovery.test.js → scripts/build-time-discovery.test.js} +5 -4
  148. package/layers/prisma/nodejs/package.json +8 -0
  149. package/management-ui/server/utils/cliIntegration.js +1 -1
  150. package/management-ui/server/utils/environment/awsParameterStore.js +29 -18
  151. package/package.json +11 -11
  152. package/frigg-cli/.eslintrc.js +0 -141
  153. package/frigg-cli/__tests__/unit/commands/build.test.js +0 -251
  154. package/frigg-cli/__tests__/unit/commands/db-setup.test.js +0 -548
  155. package/frigg-cli/__tests__/unit/commands/install.test.js +0 -400
  156. package/frigg-cli/__tests__/unit/commands/ui.test.js +0 -346
  157. package/frigg-cli/__tests__/unit/utils/database-validator.test.js +0 -366
  158. package/frigg-cli/__tests__/unit/utils/error-messages.test.js +0 -304
  159. package/frigg-cli/__tests__/unit/utils/prisma-runner.test.js +0 -486
  160. package/frigg-cli/__tests__/utils/mock-factory.js +0 -270
  161. package/frigg-cli/__tests__/utils/prisma-mock.js +0 -194
  162. package/frigg-cli/__tests__/utils/test-fixtures.js +0 -463
  163. package/frigg-cli/__tests__/utils/test-setup.js +0 -287
  164. package/frigg-cli/build-command/index.js +0 -65
  165. package/frigg-cli/db-setup-command/index.js +0 -193
  166. package/frigg-cli/deploy-command/index.js +0 -175
  167. package/frigg-cli/generate-command/__tests__/generate-command.test.js +0 -301
  168. package/frigg-cli/generate-command/azure-generator.js +0 -43
  169. package/frigg-cli/generate-command/gcp-generator.js +0 -47
  170. package/frigg-cli/generate-command/index.js +0 -332
  171. package/frigg-cli/generate-command/terraform-generator.js +0 -555
  172. package/frigg-cli/generate-iam-command.js +0 -118
  173. package/frigg-cli/index.js +0 -75
  174. package/frigg-cli/index.test.js +0 -158
  175. package/frigg-cli/init-command/backend-first-handler.js +0 -756
  176. package/frigg-cli/init-command/index.js +0 -93
  177. package/frigg-cli/init-command/template-handler.js +0 -143
  178. package/frigg-cli/install-command/backend-js.js +0 -33
  179. package/frigg-cli/install-command/commit-changes.js +0 -16
  180. package/frigg-cli/install-command/environment-variables.js +0 -127
  181. package/frigg-cli/install-command/environment-variables.test.js +0 -136
  182. package/frigg-cli/install-command/index.js +0 -54
  183. package/frigg-cli/install-command/install-package.js +0 -13
  184. package/frigg-cli/install-command/integration-file.js +0 -30
  185. package/frigg-cli/install-command/logger.js +0 -12
  186. package/frigg-cli/install-command/template.js +0 -90
  187. package/frigg-cli/install-command/validate-package.js +0 -75
  188. package/frigg-cli/jest.config.js +0 -124
  189. package/frigg-cli/package.json +0 -54
  190. package/frigg-cli/start-command/index.js +0 -149
  191. package/frigg-cli/start-command/start-command.test.js +0 -297
  192. package/frigg-cli/test/init-command.test.js +0 -180
  193. package/frigg-cli/test/npm-registry.test.js +0 -319
  194. package/frigg-cli/ui-command/index.js +0 -154
  195. package/frigg-cli/utils/app-resolver.js +0 -319
  196. package/frigg-cli/utils/backend-path.js +0 -25
  197. package/frigg-cli/utils/database-validator.js +0 -161
  198. package/frigg-cli/utils/error-messages.js +0 -257
  199. package/frigg-cli/utils/npm-registry.js +0 -167
  200. package/frigg-cli/utils/prisma-runner.js +0 -280
  201. package/frigg-cli/utils/process-manager.js +0 -199
  202. package/frigg-cli/utils/repo-detection.js +0 -405
  203. package/infrastructure/aws-discovery.js +0 -1176
  204. package/infrastructure/aws-discovery.test.js +0 -1220
  205. package/infrastructure/serverless-template.js +0 -2074
  206. /package/infrastructure/{WEBSOCKET-CONFIGURATION.md → docs/WEBSOCKET-CONFIGURATION.md} +0 -0
  207. /package/infrastructure/{GENERATE-IAM-DOCS.md → docs/generate-iam-command.md} +0 -0
  208. /package/infrastructure/{iam-generator.test.js → domains/security/iam-generator.test.js} +0 -0
  209. /package/infrastructure/{frigg-deployment-iam-stack.yaml → domains/security/templates/frigg-deployment-iam-stack.yaml} +0 -0
  210. /package/infrastructure/{iam-policy-basic.json → domains/security/templates/iam-policy-basic.json} +0 -0
  211. /package/infrastructure/{iam-policy-full.json → domains/security/templates/iam-policy-full.json} +0 -0
  212. /package/infrastructure/{run-discovery.js → scripts/run-discovery.js} +0 -0
@@ -0,0 +1,441 @@
1
+ /**
2
+ * Tests for RunHealthCheckUseCase
3
+ *
4
+ * Use case for orchestrating complete stack health check (frigg doctor command)
5
+ */
6
+
7
+ const RunHealthCheckUseCase = require('./run-health-check-use-case');
8
+ const StackIdentifier = require('../../domain/value-objects/stack-identifier');
9
+ const ResourceState = require('../../domain/value-objects/resource-state');
10
+ const PropertyMutability = require('../../domain/value-objects/property-mutability');
11
+ const PropertyMismatch = require('../../domain/entities/property-mismatch');
12
+ const HealthScore = require('../../domain/value-objects/health-score');
13
+
14
+ describe('RunHealthCheckUseCase', () => {
15
+ let useCase;
16
+ let mockStackRepository;
17
+ let mockResourceDetector;
18
+ let mockMismatchAnalyzer;
19
+ let mockHealthScoreCalculator;
20
+
21
+ beforeEach(() => {
22
+ // Mock repositories
23
+ mockStackRepository = {
24
+ getStack: jest.fn(),
25
+ listResources: jest.fn(),
26
+ detectStackDrift: jest.fn(),
27
+ getResourceDrift: jest.fn(),
28
+ };
29
+
30
+ mockResourceDetector = {
31
+ detectResources: jest.fn(),
32
+ findOrphanedResources: jest.fn(),
33
+ };
34
+
35
+ mockMismatchAnalyzer = {
36
+ analyze: jest.fn(),
37
+ };
38
+
39
+ mockHealthScoreCalculator = {
40
+ calculate: jest.fn(),
41
+ };
42
+
43
+ useCase = new RunHealthCheckUseCase({
44
+ stackRepository: mockStackRepository,
45
+ resourceDetector: mockResourceDetector,
46
+ mismatchAnalyzer: mockMismatchAnalyzer,
47
+ healthScoreCalculator: mockHealthScoreCalculator,
48
+ });
49
+ });
50
+
51
+ describe('execute', () => {
52
+ it('should return healthy report for stack with no issues', async () => {
53
+ const stackIdentifier = new StackIdentifier({
54
+ stackName: 'my-app-prod',
55
+ region: 'us-east-1',
56
+ });
57
+
58
+ // Mock stack exists and is healthy
59
+ mockStackRepository.getStack.mockResolvedValue({
60
+ stackName: 'my-app-prod',
61
+ stackId: 'arn:aws:cloudformation:us-east-1:123456789012:stack/my-app-prod/guid',
62
+ status: 'UPDATE_COMPLETE',
63
+ createdTime: new Date('2024-01-01'),
64
+ lastUpdatedTime: new Date('2024-01-15'),
65
+ parameters: [],
66
+ outputs: [],
67
+ tags: [],
68
+ });
69
+
70
+ // Mock no drift
71
+ mockStackRepository.detectStackDrift.mockResolvedValue({
72
+ stackDriftStatus: 'IN_SYNC',
73
+ driftedResourcesCount: 0,
74
+ });
75
+
76
+ // Mock resources in stack
77
+ mockStackRepository.listResources.mockResolvedValue([
78
+ {
79
+ logicalId: 'MyVPC',
80
+ physicalId: 'vpc-123',
81
+ resourceType: 'AWS::EC2::VPC',
82
+ status: 'UPDATE_COMPLETE',
83
+ driftStatus: 'IN_SYNC',
84
+ },
85
+ ]);
86
+
87
+ // Mock no orphaned resources
88
+ mockResourceDetector.findOrphanedResources.mockResolvedValue([]);
89
+
90
+ // Mock healthy score
91
+ mockHealthScoreCalculator.calculate.mockReturnValue(new HealthScore(100));
92
+
93
+ const report = await useCase.execute({ stackIdentifier });
94
+
95
+ expect(report.stackIdentifier.stackName).toBe('my-app-prod');
96
+ expect(report.healthScore.value).toBe(100);
97
+ expect(report.issues).toHaveLength(0);
98
+ expect(report.resources).toHaveLength(1);
99
+ expect(report.getIssueCount()).toBe(0);
100
+ expect(report.getCriticalIssueCount()).toBe(0);
101
+ });
102
+
103
+ it('should detect and report property drift', async () => {
104
+ const stackIdentifier = new StackIdentifier({
105
+ stackName: 'my-app-prod',
106
+ region: 'us-east-1',
107
+ });
108
+
109
+ mockStackRepository.getStack.mockResolvedValue({
110
+ stackName: 'my-app-prod',
111
+ stackId: 'arn:aws:cloudformation:us-east-1:123456789012:stack/my-app-prod/guid',
112
+ status: 'UPDATE_COMPLETE',
113
+ createdTime: new Date('2024-01-01'),
114
+ });
115
+
116
+ mockStackRepository.detectStackDrift.mockResolvedValue({
117
+ stackDriftStatus: 'DRIFTED',
118
+ driftedResourcesCount: 1,
119
+ });
120
+
121
+ mockStackRepository.listResources.mockResolvedValue([
122
+ {
123
+ logicalId: 'MyVPC',
124
+ physicalId: 'vpc-123',
125
+ resourceType: 'AWS::EC2::VPC',
126
+ status: 'UPDATE_COMPLETE',
127
+ driftStatus: 'MODIFIED',
128
+ },
129
+ ]);
130
+
131
+ // Mock drift details
132
+ mockStackRepository.getResourceDrift.mockResolvedValue({
133
+ driftStatus: 'MODIFIED',
134
+ propertyDifferences: [
135
+ {
136
+ propertyPath: 'Properties.EnableDnsSupport',
137
+ expectedValue: true,
138
+ actualValue: false,
139
+ differenceType: 'NOT_EQUAL',
140
+ },
141
+ ],
142
+ });
143
+
144
+ // Mock property mismatch analysis
145
+ const propertyMismatch = new PropertyMismatch({
146
+ propertyPath: 'Properties.EnableDnsSupport',
147
+ expectedValue: true,
148
+ actualValue: false,
149
+ mutability: PropertyMutability.MUTABLE,
150
+ });
151
+
152
+ mockMismatchAnalyzer.analyze.mockReturnValue([propertyMismatch]);
153
+
154
+ mockResourceDetector.findOrphanedResources.mockResolvedValue([]);
155
+
156
+ mockHealthScoreCalculator.calculate.mockReturnValue(new HealthScore(85));
157
+
158
+ const report = await useCase.execute({ stackIdentifier });
159
+
160
+ expect(report.healthScore.value).toBe(85);
161
+ expect(report.issues).toHaveLength(1);
162
+ expect(report.issues[0].type).toBe('PROPERTY_MISMATCH');
163
+ expect(report.issues[0].severity).toBe('warning');
164
+ expect(report.resources[0].state.value).toBe('DRIFTED');
165
+ });
166
+
167
+ it('should detect and report orphaned resources', async () => {
168
+ const stackIdentifier = new StackIdentifier({
169
+ stackName: 'my-app-prod',
170
+ region: 'us-east-1',
171
+ });
172
+
173
+ mockStackRepository.getStack.mockResolvedValue({
174
+ stackName: 'my-app-prod',
175
+ stackId: 'arn:aws:cloudformation:us-east-1:123456789012:stack/my-app-prod/guid',
176
+ status: 'UPDATE_COMPLETE',
177
+ createdTime: new Date('2024-01-01'),
178
+ });
179
+
180
+ mockStackRepository.detectStackDrift.mockResolvedValue({
181
+ stackDriftStatus: 'IN_SYNC',
182
+ driftedResourcesCount: 0,
183
+ });
184
+
185
+ mockStackRepository.listResources.mockResolvedValue([
186
+ {
187
+ logicalId: 'MyVPC',
188
+ physicalId: 'vpc-123',
189
+ resourceType: 'AWS::EC2::VPC',
190
+ status: 'UPDATE_COMPLETE',
191
+ driftStatus: 'IN_SYNC',
192
+ },
193
+ ]);
194
+
195
+ // Mock orphaned RDS cluster
196
+ mockResourceDetector.findOrphanedResources.mockResolvedValue([
197
+ {
198
+ physicalId: 'my-orphan-cluster',
199
+ resourceType: 'AWS::RDS::DBCluster',
200
+ properties: {
201
+ Engine: 'aurora-postgresql',
202
+ EngineVersion: '13.7',
203
+ },
204
+ tags: [
205
+ { Key: 'frigg:stack', Value: 'my-app-prod' },
206
+ ],
207
+ createdTime: new Date('2024-01-10'),
208
+ },
209
+ ]);
210
+
211
+ mockHealthScoreCalculator.calculate.mockReturnValue(new HealthScore(75));
212
+
213
+ const report = await useCase.execute({ stackIdentifier });
214
+
215
+ expect(report.healthScore.value).toBe(75);
216
+ expect(report.issues).toHaveLength(1);
217
+ expect(report.issues[0].type).toBe('ORPHANED_RESOURCE');
218
+ expect(report.issues[0].severity).toBe('critical');
219
+ expect(report.issues[0].resourceId).toBe('my-orphan-cluster');
220
+ expect(report.getOrphanedResourceCount()).toBe(1);
221
+ });
222
+
223
+ it('should detect missing resources', async () => {
224
+ const stackIdentifier = new StackIdentifier({
225
+ stackName: 'my-app-prod',
226
+ region: 'us-east-1',
227
+ });
228
+
229
+ mockStackRepository.getStack.mockResolvedValue({
230
+ stackName: 'my-app-prod',
231
+ stackId: 'arn:aws:cloudformation:us-east-1:123456789012:stack/my-app-prod/guid',
232
+ status: 'UPDATE_COMPLETE',
233
+ createdTime: new Date('2024-01-01'),
234
+ });
235
+
236
+ mockStackRepository.detectStackDrift.mockResolvedValue({
237
+ stackDriftStatus: 'DRIFTED',
238
+ driftedResourcesCount: 1,
239
+ });
240
+
241
+ mockStackRepository.listResources.mockResolvedValue([
242
+ {
243
+ logicalId: 'MyVPC',
244
+ physicalId: 'vpc-123',
245
+ resourceType: 'AWS::EC2::VPC',
246
+ status: 'UPDATE_COMPLETE',
247
+ driftStatus: 'IN_SYNC',
248
+ },
249
+ {
250
+ logicalId: 'MySubnet',
251
+ physicalId: null, // Missing resource
252
+ resourceType: 'AWS::EC2::Subnet',
253
+ status: 'DELETE_COMPLETE',
254
+ driftStatus: 'DELETED',
255
+ },
256
+ ]);
257
+
258
+ mockResourceDetector.findOrphanedResources.mockResolvedValue([]);
259
+
260
+ mockHealthScoreCalculator.calculate.mockReturnValue(new HealthScore(60));
261
+
262
+ const report = await useCase.execute({ stackIdentifier });
263
+
264
+ expect(report.healthScore.value).toBe(60);
265
+ expect(report.issues).toHaveLength(1);
266
+ expect(report.issues[0].type).toBe('MISSING_RESOURCE');
267
+ expect(report.issues[0].severity).toBe('critical');
268
+ expect(report.resources[1].state.value).toBe('MISSING');
269
+ });
270
+
271
+ it('should handle multiple issue types simultaneously', async () => {
272
+ const stackIdentifier = new StackIdentifier({
273
+ stackName: 'my-app-prod',
274
+ region: 'us-east-1',
275
+ });
276
+
277
+ mockStackRepository.getStack.mockResolvedValue({
278
+ stackName: 'my-app-prod',
279
+ stackId: 'arn:aws:cloudformation:us-east-1:123456789012:stack/my-app-prod/guid',
280
+ status: 'UPDATE_COMPLETE',
281
+ createdTime: new Date('2024-01-01'),
282
+ });
283
+
284
+ mockStackRepository.detectStackDrift.mockResolvedValue({
285
+ stackDriftStatus: 'DRIFTED',
286
+ driftedResourcesCount: 2,
287
+ });
288
+
289
+ mockStackRepository.listResources.mockResolvedValue([
290
+ {
291
+ logicalId: 'MyVPC',
292
+ physicalId: 'vpc-123',
293
+ resourceType: 'AWS::EC2::VPC',
294
+ status: 'UPDATE_COMPLETE',
295
+ driftStatus: 'MODIFIED',
296
+ },
297
+ {
298
+ logicalId: 'MySubnet',
299
+ physicalId: null,
300
+ resourceType: 'AWS::EC2::Subnet',
301
+ status: 'DELETE_COMPLETE',
302
+ driftStatus: 'DELETED',
303
+ },
304
+ ]);
305
+
306
+ // Mock drift for VPC
307
+ mockStackRepository.getResourceDrift.mockResolvedValue({
308
+ driftStatus: 'MODIFIED',
309
+ propertyDifferences: [
310
+ {
311
+ propertyPath: 'Properties.EnableDnsSupport',
312
+ expectedValue: true,
313
+ actualValue: false,
314
+ differenceType: 'NOT_EQUAL',
315
+ },
316
+ ],
317
+ });
318
+
319
+ const propertyMismatch = new PropertyMismatch({
320
+ propertyPath: 'Properties.EnableDnsSupport',
321
+ expectedValue: true,
322
+ actualValue: false,
323
+ mutability: PropertyMutability.MUTABLE,
324
+ });
325
+
326
+ mockMismatchAnalyzer.analyze.mockReturnValue([propertyMismatch]);
327
+
328
+ // Mock orphaned resources
329
+ mockResourceDetector.findOrphanedResources.mockResolvedValue([
330
+ {
331
+ physicalId: 'my-orphan-cluster',
332
+ resourceType: 'AWS::RDS::DBCluster',
333
+ properties: {},
334
+ tags: [{ Key: 'frigg:stack', Value: 'my-app-prod' }],
335
+ createdTime: new Date('2024-01-10'),
336
+ },
337
+ ]);
338
+
339
+ mockHealthScoreCalculator.calculate.mockReturnValue(new HealthScore(40));
340
+
341
+ const report = await useCase.execute({ stackIdentifier });
342
+
343
+ expect(report.healthScore.value).toBe(40);
344
+ expect(report.issues.length).toBeGreaterThanOrEqual(3);
345
+ expect(report.getIssueCount()).toBeGreaterThanOrEqual(3);
346
+ expect(report.getCriticalIssueCount()).toBeGreaterThanOrEqual(1);
347
+ expect(report.getDriftedResourceCount()).toBe(1);
348
+ expect(report.getOrphanedResourceCount()).toBe(1);
349
+ expect(report.getMissingResourceCount()).toBe(1);
350
+ });
351
+
352
+ it('should throw error if stack does not exist', async () => {
353
+ const stackIdentifier = new StackIdentifier({
354
+ stackName: 'non-existent-stack',
355
+ region: 'us-east-1',
356
+ });
357
+
358
+ mockStackRepository.getStack.mockRejectedValue(
359
+ new Error('Stack non-existent-stack does not exist')
360
+ );
361
+
362
+ await expect(useCase.execute({ stackIdentifier })).rejects.toThrow(
363
+ 'Stack non-existent-stack does not exist'
364
+ );
365
+ });
366
+
367
+ it('should include timestamp in report', async () => {
368
+ const stackIdentifier = new StackIdentifier({
369
+ stackName: 'my-app-prod',
370
+ region: 'us-east-1',
371
+ });
372
+
373
+ mockStackRepository.getStack.mockResolvedValue({
374
+ stackName: 'my-app-prod',
375
+ stackId: 'arn:aws:cloudformation:us-east-1:123456789012:stack/my-app-prod/guid',
376
+ status: 'UPDATE_COMPLETE',
377
+ createdTime: new Date('2024-01-01'),
378
+ });
379
+
380
+ mockStackRepository.detectStackDrift.mockResolvedValue({
381
+ stackDriftStatus: 'IN_SYNC',
382
+ driftedResourcesCount: 0,
383
+ });
384
+
385
+ mockStackRepository.listResources.mockResolvedValue([]);
386
+ mockResourceDetector.findOrphanedResources.mockResolvedValue([]);
387
+
388
+ mockHealthScoreCalculator.calculate.mockReturnValue(new HealthScore(100));
389
+
390
+ const beforeExecution = new Date();
391
+ const report = await useCase.execute({ stackIdentifier });
392
+ const afterExecution = new Date();
393
+
394
+ expect(report.timestamp).toBeInstanceOf(Date);
395
+ expect(report.timestamp.getTime()).toBeGreaterThanOrEqual(beforeExecution.getTime());
396
+ expect(report.timestamp.getTime()).toBeLessThanOrEqual(afterExecution.getTime());
397
+ });
398
+ });
399
+
400
+ describe('constructor', () => {
401
+ it('should require stackRepository', () => {
402
+ expect(() => {
403
+ new RunHealthCheckUseCase({
404
+ resourceDetector: mockResourceDetector,
405
+ mismatchAnalyzer: mockMismatchAnalyzer,
406
+ healthScoreCalculator: mockHealthScoreCalculator,
407
+ });
408
+ }).toThrow('stackRepository is required');
409
+ });
410
+
411
+ it('should require resourceDetector', () => {
412
+ expect(() => {
413
+ new RunHealthCheckUseCase({
414
+ stackRepository: mockStackRepository,
415
+ mismatchAnalyzer: mockMismatchAnalyzer,
416
+ healthScoreCalculator: mockHealthScoreCalculator,
417
+ });
418
+ }).toThrow('resourceDetector is required');
419
+ });
420
+
421
+ it('should require mismatchAnalyzer', () => {
422
+ expect(() => {
423
+ new RunHealthCheckUseCase({
424
+ stackRepository: mockStackRepository,
425
+ resourceDetector: mockResourceDetector,
426
+ healthScoreCalculator: mockHealthScoreCalculator,
427
+ });
428
+ }).toThrow('mismatchAnalyzer is required');
429
+ });
430
+
431
+ it('should require healthScoreCalculator', () => {
432
+ expect(() => {
433
+ new RunHealthCheckUseCase({
434
+ stackRepository: mockStackRepository,
435
+ resourceDetector: mockResourceDetector,
436
+ mismatchAnalyzer: mockMismatchAnalyzer,
437
+ });
438
+ }).toThrow('healthScoreCalculator is required');
439
+ });
440
+ });
441
+ });