@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,554 @@
1
+ /**
2
+ * Tests for AWSResourceDetector Adapter
3
+ *
4
+ * Tests AWS resource discovery for EC2, RDS, and KMS resources
5
+ */
6
+
7
+ const AWSResourceDetector = require('./aws-resource-detector');
8
+
9
+ // Mock AWS SDK
10
+ jest.mock('@aws-sdk/client-ec2', () => ({
11
+ EC2Client: jest.fn(),
12
+ DescribeVpcsCommand: jest.fn(),
13
+ DescribeSubnetsCommand: jest.fn(),
14
+ DescribeSecurityGroupsCommand: jest.fn(),
15
+ DescribeRouteTablesCommand: jest.fn(),
16
+ }));
17
+
18
+ jest.mock('@aws-sdk/client-rds', () => ({
19
+ RDSClient: jest.fn(),
20
+ DescribeDBClustersCommand: jest.fn(),
21
+ }));
22
+
23
+ jest.mock('@aws-sdk/client-kms', () => ({
24
+ KMSClient: jest.fn(),
25
+ ListKeysCommand: jest.fn(),
26
+ DescribeKeyCommand: jest.fn(),
27
+ ListAliasesCommand: jest.fn(),
28
+ }));
29
+
30
+ describe('AWSResourceDetector', () => {
31
+ let detector;
32
+ let mockEC2Send;
33
+ let mockRDSSend;
34
+ let mockKMSSend;
35
+
36
+ beforeEach(() => {
37
+ jest.clearAllMocks();
38
+
39
+ // Mock EC2 client
40
+ mockEC2Send = jest.fn();
41
+ const { EC2Client } = require('@aws-sdk/client-ec2');
42
+ EC2Client.mockImplementation(() => ({ send: mockEC2Send }));
43
+
44
+ // Mock RDS client
45
+ mockRDSSend = jest.fn();
46
+ const { RDSClient } = require('@aws-sdk/client-rds');
47
+ RDSClient.mockImplementation(() => ({ send: mockRDSSend }));
48
+
49
+ // Mock KMS client
50
+ mockKMSSend = jest.fn();
51
+ const { KMSClient } = require('@aws-sdk/client-kms');
52
+ KMSClient.mockImplementation(() => ({ send: mockKMSSend }));
53
+
54
+ detector = new AWSResourceDetector({ region: 'us-east-1' });
55
+ });
56
+
57
+ describe('getSupportedResourceTypes', () => {
58
+ it('should return list of supported resource types', async () => {
59
+ const types = await detector.getSupportedResourceTypes();
60
+
61
+ expect(types).toContain('AWS::EC2::VPC');
62
+ expect(types).toContain('AWS::EC2::Subnet');
63
+ expect(types).toContain('AWS::EC2::SecurityGroup');
64
+ expect(types).toContain('AWS::EC2::RouteTable');
65
+ expect(types).toContain('AWS::RDS::DBCluster');
66
+ expect(types).toContain('AWS::KMS::Key');
67
+ expect(types).toHaveLength(6);
68
+ });
69
+ });
70
+
71
+ describe('detectResources - VPC', () => {
72
+ it('should detect VPCs', async () => {
73
+ mockEC2Send.mockResolvedValue({
74
+ Vpcs: [
75
+ {
76
+ VpcId: 'vpc-123',
77
+ CidrBlock: '10.0.0.0/16',
78
+ State: 'available',
79
+ Tags: [{ Key: 'Name', Value: 'Main VPC' }],
80
+ },
81
+ {
82
+ VpcId: 'vpc-456',
83
+ CidrBlock: '10.1.0.0/16',
84
+ State: 'available',
85
+ Tags: [],
86
+ },
87
+ ],
88
+ });
89
+
90
+ const resources = await detector.detectResources({
91
+ resourceType: 'AWS::EC2::VPC',
92
+ region: 'us-east-1',
93
+ });
94
+
95
+ expect(resources).toHaveLength(2);
96
+ expect(resources[0]).toEqual({
97
+ physicalId: 'vpc-123',
98
+ resourceType: 'AWS::EC2::VPC',
99
+ properties: {
100
+ VpcId: 'vpc-123',
101
+ CidrBlock: '10.0.0.0/16',
102
+ State: 'available',
103
+ },
104
+ tags: { Name: 'Main VPC' },
105
+ createdTime: expect.any(Date),
106
+ });
107
+ });
108
+
109
+ it('should filter VPCs by tags', async () => {
110
+ mockEC2Send.mockResolvedValue({
111
+ Vpcs: [
112
+ {
113
+ VpcId: 'vpc-123',
114
+ CidrBlock: '10.0.0.0/16',
115
+ State: 'available',
116
+ Tags: [{ Key: 'Environment', Value: 'production' }],
117
+ },
118
+ ],
119
+ });
120
+
121
+ const resources = await detector.detectResources({
122
+ resourceType: 'AWS::EC2::VPC',
123
+ region: 'us-east-1',
124
+ filters: { tags: { Environment: 'production' } },
125
+ });
126
+
127
+ expect(resources).toHaveLength(1);
128
+ expect(resources[0].tags).toEqual({ Environment: 'production' });
129
+ });
130
+ });
131
+
132
+ describe('detectResources - Subnet', () => {
133
+ it('should detect Subnets', async () => {
134
+ mockEC2Send.mockResolvedValue({
135
+ Subnets: [
136
+ {
137
+ SubnetId: 'subnet-123',
138
+ VpcId: 'vpc-123',
139
+ CidrBlock: '10.0.1.0/24',
140
+ AvailabilityZone: 'us-east-1a',
141
+ State: 'available',
142
+ Tags: [{ Key: 'Name', Value: 'Private Subnet' }],
143
+ },
144
+ ],
145
+ });
146
+
147
+ const resources = await detector.detectResources({
148
+ resourceType: 'AWS::EC2::Subnet',
149
+ region: 'us-east-1',
150
+ });
151
+
152
+ expect(resources).toHaveLength(1);
153
+ expect(resources[0].physicalId).toBe('subnet-123');
154
+ expect(resources[0].properties.VpcId).toBe('vpc-123');
155
+ });
156
+ });
157
+
158
+ describe('detectResources - SecurityGroup', () => {
159
+ it('should detect SecurityGroups', async () => {
160
+ mockEC2Send.mockResolvedValue({
161
+ SecurityGroups: [
162
+ {
163
+ GroupId: 'sg-123',
164
+ GroupName: 'default',
165
+ Description: 'Default security group',
166
+ VpcId: 'vpc-123',
167
+ Tags: [],
168
+ },
169
+ ],
170
+ });
171
+
172
+ const resources = await detector.detectResources({
173
+ resourceType: 'AWS::EC2::SecurityGroup',
174
+ region: 'us-east-1',
175
+ });
176
+
177
+ expect(resources).toHaveLength(1);
178
+ expect(resources[0].physicalId).toBe('sg-123');
179
+ });
180
+ });
181
+
182
+ describe('detectResources - RouteTable', () => {
183
+ it('should detect RouteTables', async () => {
184
+ mockEC2Send.mockResolvedValue({
185
+ RouteTables: [
186
+ {
187
+ RouteTableId: 'rtb-123',
188
+ VpcId: 'vpc-123',
189
+ Routes: [],
190
+ Associations: [],
191
+ Tags: [{ Key: 'Name', Value: 'Main Route Table' }],
192
+ },
193
+ ],
194
+ });
195
+
196
+ const resources = await detector.detectResources({
197
+ resourceType: 'AWS::EC2::RouteTable',
198
+ region: 'us-east-1',
199
+ });
200
+
201
+ expect(resources).toHaveLength(1);
202
+ expect(resources[0].physicalId).toBe('rtb-123');
203
+ });
204
+ });
205
+
206
+ describe('detectResources - RDS DBCluster', () => {
207
+ it('should detect RDS DBClusters', async () => {
208
+ mockRDSSend.mockResolvedValue({
209
+ DBClusters: [
210
+ {
211
+ DBClusterIdentifier: 'my-aurora-cluster',
212
+ DBClusterArn: 'arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-cluster',
213
+ Engine: 'aurora-postgresql',
214
+ EngineVersion: '13.7',
215
+ Status: 'available',
216
+ ClusterCreateTime: new Date('2024-01-01T00:00:00Z'),
217
+ TagList: [{ Key: 'Environment', Value: 'production' }],
218
+ },
219
+ ],
220
+ });
221
+
222
+ const resources = await detector.detectResources({
223
+ resourceType: 'AWS::RDS::DBCluster',
224
+ region: 'us-east-1',
225
+ });
226
+
227
+ expect(resources).toHaveLength(1);
228
+ expect(resources[0]).toEqual({
229
+ physicalId: 'my-aurora-cluster',
230
+ resourceType: 'AWS::RDS::DBCluster',
231
+ properties: {
232
+ DBClusterIdentifier: 'my-aurora-cluster',
233
+ DBClusterArn: 'arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-cluster',
234
+ Engine: 'aurora-postgresql',
235
+ EngineVersion: '13.7',
236
+ Status: 'available',
237
+ },
238
+ tags: { Environment: 'production' },
239
+ createdTime: new Date('2024-01-01T00:00:00Z'),
240
+ });
241
+ });
242
+ });
243
+
244
+ describe('detectResources - KMS Key', () => {
245
+ it('should detect KMS Keys', async () => {
246
+ // First call: ListKeys
247
+ mockKMSSend.mockResolvedValueOnce({
248
+ Keys: [
249
+ { KeyId: 'key-123', KeyArn: 'arn:aws:kms:us-east-1:123456789012:key/key-123' },
250
+ ],
251
+ });
252
+
253
+ // Second call: DescribeKey for key-123
254
+ mockKMSSend.mockResolvedValueOnce({
255
+ KeyMetadata: {
256
+ KeyId: 'key-123',
257
+ Arn: 'arn:aws:kms:us-east-1:123456789012:key/key-123',
258
+ CreationDate: new Date('2024-01-01T00:00:00Z'),
259
+ Enabled: true,
260
+ KeyState: 'Enabled',
261
+ KeyManager: 'CUSTOMER',
262
+ },
263
+ });
264
+
265
+ // Third call: ListAliases for key-123
266
+ mockKMSSend.mockResolvedValueOnce({
267
+ Aliases: [{ AliasName: 'alias/my-key', TargetKeyId: 'key-123' }],
268
+ });
269
+
270
+ const resources = await detector.detectResources({
271
+ resourceType: 'AWS::KMS::Key',
272
+ region: 'us-east-1',
273
+ });
274
+
275
+ expect(resources).toHaveLength(1);
276
+ expect(resources[0].physicalId).toBe('key-123');
277
+ expect(resources[0].properties.KeyState).toBe('Enabled');
278
+ expect(mockKMSSend).toHaveBeenCalledTimes(3);
279
+ });
280
+ });
281
+
282
+ describe('detectResources - unsupported type', () => {
283
+ it('should throw error for unsupported resource type', async () => {
284
+ await expect(
285
+ detector.detectResources({
286
+ resourceType: 'AWS::Lambda::Function',
287
+ region: 'us-east-1',
288
+ })
289
+ ).rejects.toThrow('Resource type AWS::Lambda::Function is not supported');
290
+ });
291
+ });
292
+
293
+ describe('getResourceDetails', () => {
294
+ it('should get VPC details', async () => {
295
+ mockEC2Send.mockResolvedValue({
296
+ Vpcs: [
297
+ {
298
+ VpcId: 'vpc-123',
299
+ CidrBlock: '10.0.0.0/16',
300
+ State: 'available',
301
+ EnableDnsHostnames: true,
302
+ EnableDnsSupport: true,
303
+ Tags: [{ Key: 'Name', Value: 'Main VPC' }],
304
+ },
305
+ ],
306
+ });
307
+
308
+ const resource = await detector.getResourceDetails({
309
+ resourceType: 'AWS::EC2::VPC',
310
+ physicalId: 'vpc-123',
311
+ region: 'us-east-1',
312
+ });
313
+
314
+ expect(resource.physicalId).toBe('vpc-123');
315
+ expect(resource.properties.EnableDnsHostnames).toBe(true);
316
+ });
317
+
318
+ it('should get RDS DBCluster details', async () => {
319
+ mockRDSSend.mockResolvedValue({
320
+ DBClusters: [
321
+ {
322
+ DBClusterIdentifier: 'my-cluster',
323
+ Engine: 'aurora-postgresql',
324
+ EngineVersion: '13.7',
325
+ Status: 'available',
326
+ ClusterCreateTime: new Date('2024-01-01T00:00:00Z'),
327
+ },
328
+ ],
329
+ });
330
+
331
+ const resource = await detector.getResourceDetails({
332
+ resourceType: 'AWS::RDS::DBCluster',
333
+ physicalId: 'my-cluster',
334
+ region: 'us-east-1',
335
+ });
336
+
337
+ expect(resource.physicalId).toBe('my-cluster');
338
+ expect(resource.properties.Engine).toBe('aurora-postgresql');
339
+ });
340
+
341
+ it('should throw error if resource not found', async () => {
342
+ mockEC2Send.mockResolvedValue({ Vpcs: [] });
343
+
344
+ await expect(
345
+ detector.getResourceDetails({
346
+ resourceType: 'AWS::EC2::VPC',
347
+ physicalId: 'vpc-nonexistent',
348
+ region: 'us-east-1',
349
+ })
350
+ ).rejects.toThrow('Resource vpc-nonexistent not found');
351
+ });
352
+ });
353
+
354
+ describe('resourceExists', () => {
355
+ it('should return true if VPC exists', async () => {
356
+ mockEC2Send.mockResolvedValue({
357
+ Vpcs: [{ VpcId: 'vpc-123' }],
358
+ });
359
+
360
+ const exists = await detector.resourceExists({
361
+ resourceType: 'AWS::EC2::VPC',
362
+ physicalId: 'vpc-123',
363
+ region: 'us-east-1',
364
+ });
365
+
366
+ expect(exists).toBe(true);
367
+ });
368
+
369
+ it('should return false if VPC does not exist', async () => {
370
+ mockEC2Send.mockResolvedValue({ Vpcs: [] });
371
+
372
+ const exists = await detector.resourceExists({
373
+ resourceType: 'AWS::EC2::VPC',
374
+ physicalId: 'vpc-nonexistent',
375
+ region: 'us-east-1',
376
+ });
377
+
378
+ expect(exists).toBe(false);
379
+ });
380
+ });
381
+
382
+ describe('detectResourcesByTags', () => {
383
+ it('should detect resources matching tags', async () => {
384
+ // VPCs
385
+ mockEC2Send.mockResolvedValueOnce({
386
+ Vpcs: [
387
+ {
388
+ VpcId: 'vpc-123',
389
+ CidrBlock: '10.0.0.0/16',
390
+ State: 'available',
391
+ Tags: [{ Key: 'Environment', Value: 'production' }],
392
+ },
393
+ ],
394
+ });
395
+
396
+ // Subnets
397
+ mockEC2Send.mockResolvedValueOnce({
398
+ Subnets: [
399
+ {
400
+ SubnetId: 'subnet-123',
401
+ VpcId: 'vpc-123',
402
+ CidrBlock: '10.0.1.0/24',
403
+ State: 'available',
404
+ Tags: [{ Key: 'Environment', Value: 'production' }],
405
+ },
406
+ ],
407
+ });
408
+
409
+ const resources = await detector.detectResourcesByTags({
410
+ tags: { Environment: 'production' },
411
+ region: 'us-east-1',
412
+ resourceTypes: ['AWS::EC2::VPC', 'AWS::EC2::Subnet'],
413
+ });
414
+
415
+ expect(resources).toHaveLength(2);
416
+ expect(resources[0].physicalId).toBe('vpc-123');
417
+ expect(resources[1].physicalId).toBe('subnet-123');
418
+ });
419
+
420
+ it('should detect all supported types if resourceTypes not specified', async () => {
421
+ // Mock responses for all supported types
422
+ mockEC2Send.mockResolvedValueOnce({ Vpcs: [] });
423
+ mockEC2Send.mockResolvedValueOnce({ Subnets: [] });
424
+ mockEC2Send.mockResolvedValueOnce({ SecurityGroups: [] });
425
+ mockEC2Send.mockResolvedValueOnce({ RouteTables: [] });
426
+ mockRDSSend.mockResolvedValueOnce({ DBClusters: [] });
427
+ mockKMSSend.mockResolvedValueOnce({ Keys: [] });
428
+
429
+ const resources = await detector.detectResourcesByTags({
430
+ tags: { Team: 'platform' },
431
+ region: 'us-east-1',
432
+ });
433
+
434
+ expect(resources).toEqual([]);
435
+ expect(mockEC2Send).toHaveBeenCalledTimes(4);
436
+ expect(mockRDSSend).toHaveBeenCalledTimes(1);
437
+ expect(mockKMSSend).toHaveBeenCalledTimes(1);
438
+ });
439
+ });
440
+
441
+ describe('findOrphanedResources', () => {
442
+ const StackIdentifier = require('../../domain/value-objects/stack-identifier');
443
+
444
+ it('should find orphaned RDS DBCluster with frigg:stack tag', async () => {
445
+ const stackIdentifier = new StackIdentifier({
446
+ stackName: 'my-app-prod',
447
+ region: 'us-east-1',
448
+ });
449
+
450
+ const stackResources = [
451
+ {
452
+ logicalId: 'MyDBCluster',
453
+ physicalId: 'managed-cluster',
454
+ resourceType: 'AWS::RDS::DBCluster',
455
+ },
456
+ ];
457
+
458
+ mockRDSSend.mockResolvedValue({
459
+ DBClusters: [
460
+ {
461
+ // Managed by CloudFormation - not orphaned
462
+ DBClusterIdentifier: 'managed-cluster',
463
+ DBClusterArn: 'arn:aws:rds:us-east-1:123456789012:cluster:managed-cluster',
464
+ Engine: 'aurora-postgresql',
465
+ Status: 'available',
466
+ ClusterCreateTime: new Date('2024-01-01T00:00:00Z'),
467
+ TagList: [
468
+ { Key: 'aws:cloudformation:stack-name', Value: 'my-app-prod' },
469
+ { Key: 'frigg:stack', Value: 'my-app-prod' },
470
+ ],
471
+ },
472
+ {
473
+ // Has frigg:stack tag but no CloudFormation tag - orphaned
474
+ DBClusterIdentifier: 'orphan-cluster',
475
+ DBClusterArn: 'arn:aws:rds:us-east-1:123456789012:cluster:orphan-cluster',
476
+ Engine: 'aurora-postgresql',
477
+ Status: 'available',
478
+ ClusterCreateTime: new Date('2024-01-01T00:00:00Z'),
479
+ TagList: [
480
+ { Key: 'frigg:stack', Value: 'my-app-prod' },
481
+ ],
482
+ },
483
+ ],
484
+ });
485
+
486
+ const orphans = await detector.findOrphanedResources({
487
+ stackIdentifier,
488
+ stackResources,
489
+ });
490
+
491
+ expect(orphans).toHaveLength(1);
492
+ expect(orphans[0].physicalId).toBe('orphan-cluster');
493
+ expect(orphans[0].isOrphaned).toBe(true);
494
+ expect(orphans[0].reason).toContain('not managed by CloudFormation');
495
+ });
496
+
497
+ it('should not return resources managed by CloudFormation', async () => {
498
+ const stackIdentifier = new StackIdentifier({
499
+ stackName: 'my-app-prod',
500
+ region: 'us-east-1',
501
+ });
502
+
503
+ const stackResources = [
504
+ {
505
+ logicalId: 'MyVPC',
506
+ physicalId: 'vpc-123',
507
+ resourceType: 'AWS::EC2::VPC',
508
+ },
509
+ ];
510
+
511
+ mockEC2Send.mockResolvedValue({
512
+ Vpcs: [
513
+ {
514
+ VpcId: 'vpc-123',
515
+ CidrBlock: '10.0.0.0/16',
516
+ State: 'available',
517
+ Tags: [
518
+ { Key: 'aws:cloudformation:stack-name', Value: 'my-app-prod' },
519
+ { Key: 'frigg:stack', Value: 'my-app-prod' },
520
+ ],
521
+ },
522
+ {
523
+ VpcId: 'vpc-456',
524
+ CidrBlock: '10.1.0.0/16',
525
+ State: 'available',
526
+ Tags: [
527
+ { Key: 'aws:cloudformation:stack-name', Value: 'other-stack' },
528
+ ],
529
+ },
530
+ ],
531
+ });
532
+
533
+ const orphans = await detector.findOrphanedResources({
534
+ stackIdentifier,
535
+ stackResources,
536
+ });
537
+
538
+ // Should not find any orphans - both VPCs are CloudFormation-managed
539
+ expect(orphans).toEqual([]);
540
+ });
541
+ });
542
+
543
+ describe('constructor', () => {
544
+ it('should create instance with default region', () => {
545
+ const det = new AWSResourceDetector();
546
+ expect(det).toBeInstanceOf(AWSResourceDetector);
547
+ });
548
+
549
+ it('should create instance with custom region', () => {
550
+ const det = new AWSResourceDetector({ region: 'eu-west-1' });
551
+ expect(det).toBeInstanceOf(AWSResourceDetector);
552
+ });
553
+ });
554
+ });