@friggframework/devtools 2.0.0-next.45 → 2.0.0-next.47

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 +695 -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 -2094
  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,431 @@
1
+ /**
2
+ * Tests for MismatchAnalyzer Domain Service
3
+ */
4
+
5
+ const MismatchAnalyzer = require('./mismatch-analyzer');
6
+ const PropertyMutability = require('../value-objects/property-mutability');
7
+
8
+ describe('MismatchAnalyzer', () => {
9
+ let analyzer;
10
+
11
+ beforeEach(() => {
12
+ analyzer = new MismatchAnalyzer();
13
+ });
14
+
15
+ describe('primitive value comparison', () => {
16
+ it('should detect no mismatch for identical strings', () => {
17
+ const mismatches = analyzer.analyze({
18
+ expected: { name: 'my-vpc' },
19
+ actual: { name: 'my-vpc' },
20
+ propertyMutability: { name: PropertyMutability.MUTABLE },
21
+ });
22
+
23
+ expect(mismatches).toHaveLength(0);
24
+ });
25
+
26
+ it('should detect mismatch for different strings', () => {
27
+ const mismatches = analyzer.analyze({
28
+ expected: { name: 'my-vpc-v1' },
29
+ actual: { name: 'my-vpc-v2' },
30
+ propertyMutability: { name: PropertyMutability.MUTABLE },
31
+ });
32
+
33
+ expect(mismatches).toHaveLength(1);
34
+ expect(mismatches[0].propertyPath).toBe('name');
35
+ expect(mismatches[0].expectedValue).toBe('my-vpc-v1');
36
+ expect(mismatches[0].actualValue).toBe('my-vpc-v2');
37
+ expect(mismatches[0].mutability.value).toBe('MUTABLE');
38
+ });
39
+
40
+ it('should detect mismatch for different numbers', () => {
41
+ const mismatches = analyzer.analyze({
42
+ expected: { maxSize: 10 },
43
+ actual: { maxSize: 20 },
44
+ propertyMutability: { maxSize: PropertyMutability.MUTABLE },
45
+ });
46
+
47
+ expect(mismatches).toHaveLength(1);
48
+ expect(mismatches[0].propertyPath).toBe('maxSize');
49
+ expect(mismatches[0].expectedValue).toBe(10);
50
+ expect(mismatches[0].actualValue).toBe(20);
51
+ });
52
+
53
+ it('should detect mismatch for different booleans', () => {
54
+ const mismatches = analyzer.analyze({
55
+ expected: { enableDnsSupport: true },
56
+ actual: { enableDnsSupport: false },
57
+ propertyMutability: { enableDnsSupport: PropertyMutability.MUTABLE },
58
+ });
59
+
60
+ expect(mismatches).toHaveLength(1);
61
+ expect(mismatches[0].propertyPath).toBe('enableDnsSupport');
62
+ expect(mismatches[0].expectedValue).toBe(true);
63
+ expect(mismatches[0].actualValue).toBe(false);
64
+ });
65
+ });
66
+
67
+ describe('null and undefined handling', () => {
68
+ it('should detect no mismatch for both null', () => {
69
+ const mismatches = analyzer.analyze({
70
+ expected: { description: null },
71
+ actual: { description: null },
72
+ propertyMutability: { description: PropertyMutability.MUTABLE },
73
+ });
74
+
75
+ expect(mismatches).toHaveLength(0);
76
+ });
77
+
78
+ it('should detect mismatch for null vs value', () => {
79
+ const mismatches = analyzer.analyze({
80
+ expected: { description: null },
81
+ actual: { description: 'Production VPC' },
82
+ propertyMutability: { description: PropertyMutability.MUTABLE },
83
+ });
84
+
85
+ expect(mismatches).toHaveLength(1);
86
+ expect(mismatches[0].propertyPath).toBe('description');
87
+ expect(mismatches[0].expectedValue).toBeNull();
88
+ expect(mismatches[0].actualValue).toBe('Production VPC');
89
+ });
90
+
91
+ it('should handle undefined as equivalent to null', () => {
92
+ const mismatches = analyzer.analyze({
93
+ expected: { description: undefined },
94
+ actual: { description: null },
95
+ propertyMutability: { description: PropertyMutability.MUTABLE },
96
+ });
97
+
98
+ expect(mismatches).toHaveLength(0);
99
+ });
100
+ });
101
+
102
+ describe('nested object comparison', () => {
103
+ it('should detect no mismatch for identical nested objects', () => {
104
+ const mismatches = analyzer.analyze({
105
+ expected: {
106
+ tags: {
107
+ Environment: 'production',
108
+ Team: 'platform',
109
+ },
110
+ },
111
+ actual: {
112
+ tags: {
113
+ Environment: 'production',
114
+ Team: 'platform',
115
+ },
116
+ },
117
+ propertyMutability: { tags: PropertyMutability.MUTABLE },
118
+ });
119
+
120
+ expect(mismatches).toHaveLength(0);
121
+ });
122
+
123
+ it('should detect mismatch in nested object property', () => {
124
+ const mismatches = analyzer.analyze({
125
+ expected: {
126
+ tags: {
127
+ Environment: 'production',
128
+ Team: 'platform',
129
+ },
130
+ },
131
+ actual: {
132
+ tags: {
133
+ Environment: 'staging',
134
+ Team: 'platform',
135
+ },
136
+ },
137
+ propertyMutability: { 'tags.Environment': PropertyMutability.MUTABLE },
138
+ });
139
+
140
+ expect(mismatches).toHaveLength(1);
141
+ expect(mismatches[0].propertyPath).toBe('tags.Environment');
142
+ expect(mismatches[0].expectedValue).toBe('production');
143
+ expect(mismatches[0].actualValue).toBe('staging');
144
+ });
145
+
146
+ it('should detect mismatch when nested property is missing', () => {
147
+ const mismatches = analyzer.analyze({
148
+ expected: {
149
+ tags: {
150
+ Environment: 'production',
151
+ Team: 'platform',
152
+ },
153
+ },
154
+ actual: {
155
+ tags: {
156
+ Environment: 'production',
157
+ },
158
+ },
159
+ propertyMutability: { 'tags.Team': PropertyMutability.MUTABLE },
160
+ });
161
+
162
+ expect(mismatches).toHaveLength(1);
163
+ expect(mismatches[0].propertyPath).toBe('tags.Team');
164
+ expect(mismatches[0].expectedValue).toBe('platform');
165
+ expect(mismatches[0].actualValue).toBeUndefined();
166
+ });
167
+
168
+ it('should detect mismatch when nested property is added', () => {
169
+ const mismatches = analyzer.analyze({
170
+ expected: {
171
+ tags: {
172
+ Environment: 'production',
173
+ },
174
+ },
175
+ actual: {
176
+ tags: {
177
+ Environment: 'production',
178
+ Team: 'platform',
179
+ },
180
+ },
181
+ propertyMutability: { 'tags.Team': PropertyMutability.MUTABLE },
182
+ });
183
+
184
+ expect(mismatches).toHaveLength(1);
185
+ expect(mismatches[0].propertyPath).toBe('tags.Team');
186
+ expect(mismatches[0].expectedValue).toBeUndefined();
187
+ expect(mismatches[0].actualValue).toBe('platform');
188
+ });
189
+ });
190
+
191
+ describe('array comparison', () => {
192
+ it('should detect no mismatch for identical arrays', () => {
193
+ const mismatches = analyzer.analyze({
194
+ expected: { subnets: ['subnet-1', 'subnet-2'] },
195
+ actual: { subnets: ['subnet-1', 'subnet-2'] },
196
+ propertyMutability: { subnets: PropertyMutability.MUTABLE },
197
+ });
198
+
199
+ expect(mismatches).toHaveLength(0);
200
+ });
201
+
202
+ it('should detect mismatch for different array values', () => {
203
+ const mismatches = analyzer.analyze({
204
+ expected: { subnets: ['subnet-1', 'subnet-2'] },
205
+ actual: { subnets: ['subnet-1', 'subnet-3'] },
206
+ propertyMutability: { subnets: PropertyMutability.MUTABLE },
207
+ });
208
+
209
+ expect(mismatches).toHaveLength(1);
210
+ expect(mismatches[0].propertyPath).toBe('subnets');
211
+ expect(mismatches[0].expectedValue).toEqual(['subnet-1', 'subnet-2']);
212
+ expect(mismatches[0].actualValue).toEqual(['subnet-1', 'subnet-3']);
213
+ });
214
+
215
+ it('should detect mismatch for different array lengths', () => {
216
+ const mismatches = analyzer.analyze({
217
+ expected: { subnets: ['subnet-1', 'subnet-2'] },
218
+ actual: { subnets: ['subnet-1'] },
219
+ propertyMutability: { subnets: PropertyMutability.MUTABLE },
220
+ });
221
+
222
+ expect(mismatches).toHaveLength(1);
223
+ expect(mismatches[0].propertyPath).toBe('subnets');
224
+ expect(mismatches[0].expectedValue).toEqual(['subnet-1', 'subnet-2']);
225
+ expect(mismatches[0].actualValue).toEqual(['subnet-1']);
226
+ });
227
+
228
+ it('should detect mismatch for different array order (order-sensitive)', () => {
229
+ const mismatches = analyzer.analyze({
230
+ expected: { subnets: ['subnet-1', 'subnet-2'] },
231
+ actual: { subnets: ['subnet-2', 'subnet-1'] },
232
+ propertyMutability: { subnets: PropertyMutability.MUTABLE },
233
+ });
234
+
235
+ expect(mismatches).toHaveLength(1);
236
+ expect(mismatches[0].propertyPath).toBe('subnets');
237
+ });
238
+
239
+ it('should handle arrays of objects', () => {
240
+ const mismatches = analyzer.analyze({
241
+ expected: {
242
+ tags: [
243
+ { Key: 'Environment', Value: 'production' },
244
+ { Key: 'Team', Value: 'platform' },
245
+ ],
246
+ },
247
+ actual: {
248
+ tags: [
249
+ { Key: 'Environment', Value: 'staging' },
250
+ { Key: 'Team', Value: 'platform' },
251
+ ],
252
+ },
253
+ propertyMutability: { tags: PropertyMutability.MUTABLE },
254
+ });
255
+
256
+ expect(mismatches).toHaveLength(1);
257
+ expect(mismatches[0].propertyPath).toBe('tags');
258
+ });
259
+ });
260
+
261
+ describe('type mismatch', () => {
262
+ it('should detect type mismatch (string vs number)', () => {
263
+ const mismatches = analyzer.analyze({
264
+ expected: { port: '8080' },
265
+ actual: { port: 8080 },
266
+ propertyMutability: { port: PropertyMutability.MUTABLE },
267
+ });
268
+
269
+ expect(mismatches).toHaveLength(1);
270
+ expect(mismatches[0].propertyPath).toBe('port');
271
+ expect(mismatches[0].expectedValue).toBe('8080');
272
+ expect(mismatches[0].actualValue).toBe(8080);
273
+ });
274
+
275
+ it('should detect type mismatch (object vs array)', () => {
276
+ const mismatches = analyzer.analyze({
277
+ expected: { data: {} },
278
+ actual: { data: [] },
279
+ propertyMutability: { data: PropertyMutability.MUTABLE },
280
+ });
281
+
282
+ expect(mismatches).toHaveLength(1);
283
+ expect(mismatches[0].propertyPath).toBe('data');
284
+ });
285
+ });
286
+
287
+ describe('property mutability', () => {
288
+ it('should use MUTABLE mutability by default', () => {
289
+ const mismatches = analyzer.analyze({
290
+ expected: { name: 'vpc-v1' },
291
+ actual: { name: 'vpc-v2' },
292
+ propertyMutability: {}, // No mutability specified
293
+ });
294
+
295
+ expect(mismatches).toHaveLength(1);
296
+ expect(mismatches[0].mutability.value).toBe('MUTABLE');
297
+ });
298
+
299
+ it('should apply IMMUTABLE mutability', () => {
300
+ const mismatches = analyzer.analyze({
301
+ expected: { bucketName: 'bucket-v1' },
302
+ actual: { bucketName: 'bucket-v2' },
303
+ propertyMutability: { bucketName: PropertyMutability.IMMUTABLE },
304
+ });
305
+
306
+ expect(mismatches).toHaveLength(1);
307
+ expect(mismatches[0].mutability.value).toBe('IMMUTABLE');
308
+ });
309
+
310
+ it('should apply CONDITIONAL mutability', () => {
311
+ const mismatches = analyzer.analyze({
312
+ expected: { engineVersion: '13.7' },
313
+ actual: { engineVersion: '13.8' },
314
+ propertyMutability: { engineVersion: PropertyMutability.CONDITIONAL },
315
+ });
316
+
317
+ expect(mismatches).toHaveLength(1);
318
+ expect(mismatches[0].mutability.value).toBe('CONDITIONAL');
319
+ });
320
+ });
321
+
322
+ describe('multiple mismatches', () => {
323
+ it('should detect multiple mismatches in same object', () => {
324
+ const mismatches = analyzer.analyze({
325
+ expected: {
326
+ name: 'vpc-v1',
327
+ cidr: '10.0.0.0/16',
328
+ enableDnsSupport: true,
329
+ },
330
+ actual: {
331
+ name: 'vpc-v2',
332
+ cidr: '10.1.0.0/16',
333
+ enableDnsSupport: true,
334
+ },
335
+ propertyMutability: {
336
+ name: PropertyMutability.MUTABLE,
337
+ cidr: PropertyMutability.IMMUTABLE,
338
+ enableDnsSupport: PropertyMutability.MUTABLE,
339
+ },
340
+ });
341
+
342
+ expect(mismatches).toHaveLength(2);
343
+
344
+ const nameMismatch = mismatches.find((m) => m.propertyPath === 'name');
345
+ expect(nameMismatch).toBeDefined();
346
+ expect(nameMismatch.mutability.value).toBe('MUTABLE');
347
+
348
+ const cidrMismatch = mismatches.find((m) => m.propertyPath === 'cidr');
349
+ expect(cidrMismatch).toBeDefined();
350
+ expect(cidrMismatch.mutability.value).toBe('IMMUTABLE');
351
+ });
352
+ });
353
+
354
+ describe('ignore properties', () => {
355
+ it('should ignore specified properties', () => {
356
+ const mismatches = analyzer.analyze({
357
+ expected: {
358
+ name: 'my-vpc',
359
+ lastModified: '2024-01-01',
360
+ },
361
+ actual: {
362
+ name: 'my-vpc',
363
+ lastModified: '2024-01-15',
364
+ },
365
+ propertyMutability: { name: PropertyMutability.MUTABLE },
366
+ ignoreProperties: ['lastModified'],
367
+ });
368
+
369
+ expect(mismatches).toHaveLength(0);
370
+ });
371
+
372
+ it('should ignore nested properties', () => {
373
+ const mismatches = analyzer.analyze({
374
+ expected: {
375
+ config: {
376
+ name: 'production',
377
+ timestamp: '2024-01-01',
378
+ },
379
+ },
380
+ actual: {
381
+ config: {
382
+ name: 'production',
383
+ timestamp: '2024-01-15',
384
+ },
385
+ },
386
+ propertyMutability: { 'config.name': PropertyMutability.MUTABLE },
387
+ ignoreProperties: ['config.timestamp'],
388
+ });
389
+
390
+ expect(mismatches).toHaveLength(0);
391
+ });
392
+ });
393
+
394
+ describe('empty objects', () => {
395
+ it('should detect no mismatch for both empty objects', () => {
396
+ const mismatches = analyzer.analyze({
397
+ expected: {},
398
+ actual: {},
399
+ propertyMutability: {},
400
+ });
401
+
402
+ expect(mismatches).toHaveLength(0);
403
+ });
404
+
405
+ it('should detect mismatch when expected is empty but actual has properties', () => {
406
+ const mismatches = analyzer.analyze({
407
+ expected: {},
408
+ actual: { name: 'my-vpc' },
409
+ propertyMutability: { name: PropertyMutability.MUTABLE },
410
+ });
411
+
412
+ expect(mismatches).toHaveLength(1);
413
+ expect(mismatches[0].propertyPath).toBe('name');
414
+ expect(mismatches[0].expectedValue).toBeUndefined();
415
+ expect(mismatches[0].actualValue).toBe('my-vpc');
416
+ });
417
+
418
+ it('should detect mismatch when actual is empty but expected has properties', () => {
419
+ const mismatches = analyzer.analyze({
420
+ expected: { name: 'my-vpc' },
421
+ actual: {},
422
+ propertyMutability: { name: PropertyMutability.MUTABLE },
423
+ });
424
+
425
+ expect(mismatches).toHaveLength(1);
426
+ expect(mismatches[0].propertyPath).toBe('name');
427
+ expect(mismatches[0].expectedValue).toBe('my-vpc');
428
+ expect(mismatches[0].actualValue).toBeUndefined();
429
+ });
430
+ });
431
+ });