@stacksjs/ts-cloud-core 0.1.1

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 (251) hide show
  1. package/LICENSE.md +21 -0
  2. package/README.md +321 -0
  3. package/package.json +31 -0
  4. package/src/advanced-features.test.ts +465 -0
  5. package/src/aws/cloudformation.ts +421 -0
  6. package/src/aws/cloudfront.ts +158 -0
  7. package/src/aws/credentials.test.ts +132 -0
  8. package/src/aws/credentials.ts +545 -0
  9. package/src/aws/index.ts +87 -0
  10. package/src/aws/s3.test.ts +188 -0
  11. package/src/aws/s3.ts +1088 -0
  12. package/src/aws/signature.test.ts +670 -0
  13. package/src/aws/signature.ts +1155 -0
  14. package/src/backup/disaster-recovery.test.ts +726 -0
  15. package/src/backup/disaster-recovery.ts +500 -0
  16. package/src/backup/index.ts +34 -0
  17. package/src/backup/manager.test.ts +498 -0
  18. package/src/backup/manager.ts +432 -0
  19. package/src/cicd/circleci.ts +430 -0
  20. package/src/cicd/github-actions.ts +424 -0
  21. package/src/cicd/gitlab-ci.ts +255 -0
  22. package/src/cicd/index.ts +8 -0
  23. package/src/cli/history.ts +396 -0
  24. package/src/cli/index.ts +10 -0
  25. package/src/cli/progress.ts +458 -0
  26. package/src/cli/repl.ts +454 -0
  27. package/src/cli/suggestions.ts +327 -0
  28. package/src/cli/table.test.ts +319 -0
  29. package/src/cli/table.ts +332 -0
  30. package/src/cloudformation/builder.test.ts +327 -0
  31. package/src/cloudformation/builder.ts +378 -0
  32. package/src/cloudformation/builders/api-gateway.ts +449 -0
  33. package/src/cloudformation/builders/cache.ts +334 -0
  34. package/src/cloudformation/builders/cdn.ts +278 -0
  35. package/src/cloudformation/builders/compute.ts +485 -0
  36. package/src/cloudformation/builders/database.ts +392 -0
  37. package/src/cloudformation/builders/functions.ts +343 -0
  38. package/src/cloudformation/builders/messaging.ts +140 -0
  39. package/src/cloudformation/builders/monitoring.ts +300 -0
  40. package/src/cloudformation/builders/network.ts +264 -0
  41. package/src/cloudformation/builders/queue.ts +147 -0
  42. package/src/cloudformation/builders/security.ts +399 -0
  43. package/src/cloudformation/builders/storage.ts +285 -0
  44. package/src/cloudformation/index.ts +30 -0
  45. package/src/cloudformation/types.ts +173 -0
  46. package/src/compliance/aws-config.ts +543 -0
  47. package/src/compliance/cloudtrail.ts +376 -0
  48. package/src/compliance/compliance.test.ts +423 -0
  49. package/src/compliance/guardduty.ts +446 -0
  50. package/src/compliance/index.ts +66 -0
  51. package/src/compliance/security-hub.ts +456 -0
  52. package/src/containers/build-optimization.ts +416 -0
  53. package/src/containers/containers.test.ts +508 -0
  54. package/src/containers/image-scanning.ts +360 -0
  55. package/src/containers/index.ts +9 -0
  56. package/src/containers/registry.ts +293 -0
  57. package/src/containers/service-mesh.ts +520 -0
  58. package/src/database/database.test.ts +762 -0
  59. package/src/database/index.ts +9 -0
  60. package/src/database/migrations.ts +444 -0
  61. package/src/database/performance.ts +528 -0
  62. package/src/database/replicas.ts +534 -0
  63. package/src/database/users.ts +494 -0
  64. package/src/dependency-graph.ts +143 -0
  65. package/src/deployment/ab-testing.ts +582 -0
  66. package/src/deployment/blue-green.ts +452 -0
  67. package/src/deployment/canary.ts +500 -0
  68. package/src/deployment/deployment.test.ts +526 -0
  69. package/src/deployment/index.ts +61 -0
  70. package/src/deployment/progressive.ts +62 -0
  71. package/src/dns/dns.test.ts +641 -0
  72. package/src/dns/dnssec.ts +315 -0
  73. package/src/dns/index.ts +8 -0
  74. package/src/dns/resolver.ts +496 -0
  75. package/src/dns/routing.ts +593 -0
  76. package/src/email/advanced/analytics.ts +445 -0
  77. package/src/email/advanced/index.ts +11 -0
  78. package/src/email/advanced/rules.ts +465 -0
  79. package/src/email/advanced/scheduling.ts +352 -0
  80. package/src/email/advanced/search.ts +412 -0
  81. package/src/email/advanced/shared-mailboxes.ts +404 -0
  82. package/src/email/advanced/templates.ts +455 -0
  83. package/src/email/advanced/threading.ts +281 -0
  84. package/src/email/analytics.ts +467 -0
  85. package/src/email/bounce-handling.ts +425 -0
  86. package/src/email/email.test.ts +431 -0
  87. package/src/email/handlers/__tests__/inbound.test.ts +38 -0
  88. package/src/email/handlers/__tests__/outbound.test.ts +37 -0
  89. package/src/email/handlers/converter.ts +227 -0
  90. package/src/email/handlers/feedback.ts +228 -0
  91. package/src/email/handlers/inbound.ts +169 -0
  92. package/src/email/handlers/outbound.ts +178 -0
  93. package/src/email/index.ts +15 -0
  94. package/src/email/reputation.ts +303 -0
  95. package/src/email/templates.ts +352 -0
  96. package/src/errors/index.test.ts +434 -0
  97. package/src/errors/index.ts +416 -0
  98. package/src/health-checks/index.ts +40 -0
  99. package/src/index.ts +360 -0
  100. package/src/intrinsic-functions.ts +118 -0
  101. package/src/lambda/concurrency.ts +330 -0
  102. package/src/lambda/destinations.ts +345 -0
  103. package/src/lambda/dlq.ts +425 -0
  104. package/src/lambda/index.ts +11 -0
  105. package/src/lambda/lambda.test.ts +840 -0
  106. package/src/lambda/layers.ts +263 -0
  107. package/src/lambda/versions.ts +376 -0
  108. package/src/lambda/vpc.ts +399 -0
  109. package/src/local/config.ts +114 -0
  110. package/src/local/index.ts +6 -0
  111. package/src/local/mock-aws.ts +351 -0
  112. package/src/modules/ai.ts +340 -0
  113. package/src/modules/api.ts +478 -0
  114. package/src/modules/auth.ts +805 -0
  115. package/src/modules/cache.ts +417 -0
  116. package/src/modules/cdn.ts +1062 -0
  117. package/src/modules/communication.ts +1094 -0
  118. package/src/modules/compute.ts +3348 -0
  119. package/src/modules/database.ts +554 -0
  120. package/src/modules/deployment.ts +1079 -0
  121. package/src/modules/dns.ts +337 -0
  122. package/src/modules/email.ts +1538 -0
  123. package/src/modules/filesystem.ts +515 -0
  124. package/src/modules/index.ts +32 -0
  125. package/src/modules/messaging.ts +486 -0
  126. package/src/modules/monitoring.ts +2086 -0
  127. package/src/modules/network.ts +664 -0
  128. package/src/modules/parameter-store.ts +325 -0
  129. package/src/modules/permissions.ts +1081 -0
  130. package/src/modules/phone.ts +494 -0
  131. package/src/modules/queue.ts +1260 -0
  132. package/src/modules/redirects.ts +464 -0
  133. package/src/modules/registry.ts +699 -0
  134. package/src/modules/search.ts +401 -0
  135. package/src/modules/secrets.ts +416 -0
  136. package/src/modules/security.ts +731 -0
  137. package/src/modules/sms.ts +389 -0
  138. package/src/modules/storage.ts +1120 -0
  139. package/src/modules/workflow.ts +680 -0
  140. package/src/multi-account/config.ts +521 -0
  141. package/src/multi-account/index.ts +7 -0
  142. package/src/multi-account/manager.ts +427 -0
  143. package/src/multi-region/cross-region.ts +410 -0
  144. package/src/multi-region/index.ts +8 -0
  145. package/src/multi-region/manager.ts +483 -0
  146. package/src/multi-region/regions.ts +435 -0
  147. package/src/network-security/index.ts +48 -0
  148. package/src/observability/index.ts +9 -0
  149. package/src/observability/logs.ts +522 -0
  150. package/src/observability/metrics.ts +460 -0
  151. package/src/observability/observability.test.ts +782 -0
  152. package/src/observability/synthetics.ts +568 -0
  153. package/src/observability/xray.ts +358 -0
  154. package/src/phone/advanced/analytics.ts +349 -0
  155. package/src/phone/advanced/callbacks.ts +428 -0
  156. package/src/phone/advanced/index.ts +8 -0
  157. package/src/phone/advanced/ivr-builder.ts +504 -0
  158. package/src/phone/advanced/recording.ts +310 -0
  159. package/src/phone/handlers/__tests__/incoming-call.test.ts +40 -0
  160. package/src/phone/handlers/incoming-call.ts +117 -0
  161. package/src/phone/handlers/missed-call.ts +116 -0
  162. package/src/phone/handlers/voicemail.ts +179 -0
  163. package/src/phone/index.ts +9 -0
  164. package/src/presets/api-backend.ts +134 -0
  165. package/src/presets/data-pipeline.ts +204 -0
  166. package/src/presets/extend.test.ts +295 -0
  167. package/src/presets/extend.ts +297 -0
  168. package/src/presets/fullstack-app.ts +144 -0
  169. package/src/presets/index.ts +27 -0
  170. package/src/presets/jamstack.ts +135 -0
  171. package/src/presets/microservices.ts +167 -0
  172. package/src/presets/ml-api.ts +208 -0
  173. package/src/presets/nodejs-server.ts +104 -0
  174. package/src/presets/nodejs-serverless.ts +114 -0
  175. package/src/presets/realtime-app.ts +184 -0
  176. package/src/presets/static-site.ts +64 -0
  177. package/src/presets/traditional-web-app.ts +339 -0
  178. package/src/presets/wordpress.ts +138 -0
  179. package/src/preview/github.test.ts +249 -0
  180. package/src/preview/github.ts +297 -0
  181. package/src/preview/index.ts +37 -0
  182. package/src/preview/manager.test.ts +440 -0
  183. package/src/preview/manager.ts +326 -0
  184. package/src/preview/notifications.test.ts +582 -0
  185. package/src/preview/notifications.ts +341 -0
  186. package/src/queue/batch-processing.ts +402 -0
  187. package/src/queue/dlq-monitoring.ts +402 -0
  188. package/src/queue/fifo.ts +342 -0
  189. package/src/queue/index.ts +9 -0
  190. package/src/queue/management.ts +428 -0
  191. package/src/queue/queue.test.ts +429 -0
  192. package/src/resource-mgmt/index.ts +39 -0
  193. package/src/resource-naming.ts +62 -0
  194. package/src/s3/index.ts +523 -0
  195. package/src/schema/cloud-config.schema.json +554 -0
  196. package/src/schema/index.ts +68 -0
  197. package/src/security/certificate-manager.ts +492 -0
  198. package/src/security/index.ts +9 -0
  199. package/src/security/scanning.ts +545 -0
  200. package/src/security/secrets-manager.ts +476 -0
  201. package/src/security/secrets-rotation.ts +456 -0
  202. package/src/security/security.test.ts +738 -0
  203. package/src/sms/advanced/ab-testing.ts +389 -0
  204. package/src/sms/advanced/analytics.ts +336 -0
  205. package/src/sms/advanced/campaigns.ts +523 -0
  206. package/src/sms/advanced/chatbot.ts +224 -0
  207. package/src/sms/advanced/index.ts +10 -0
  208. package/src/sms/advanced/link-tracking.ts +248 -0
  209. package/src/sms/advanced/mms.ts +308 -0
  210. package/src/sms/handlers/__tests__/send.test.ts +40 -0
  211. package/src/sms/handlers/delivery-status.ts +133 -0
  212. package/src/sms/handlers/receive.ts +162 -0
  213. package/src/sms/handlers/send.ts +174 -0
  214. package/src/sms/index.ts +9 -0
  215. package/src/stack-diff.ts +389 -0
  216. package/src/static-site/index.ts +85 -0
  217. package/src/template-builder.ts +110 -0
  218. package/src/template-validator.ts +574 -0
  219. package/src/utils/cache.ts +291 -0
  220. package/src/utils/diff.ts +269 -0
  221. package/src/utils/hash.ts +227 -0
  222. package/src/utils/index.ts +8 -0
  223. package/src/utils/parallel.ts +294 -0
  224. package/src/validators/credentials.test.ts +274 -0
  225. package/src/validators/credentials.ts +233 -0
  226. package/src/validators/quotas.test.ts +434 -0
  227. package/src/validators/quotas.ts +217 -0
  228. package/test/ai.test.ts +327 -0
  229. package/test/api.test.ts +511 -0
  230. package/test/auth.test.ts +632 -0
  231. package/test/cache.test.ts +406 -0
  232. package/test/cdn.test.ts +247 -0
  233. package/test/compute.test.ts +861 -0
  234. package/test/database.test.ts +523 -0
  235. package/test/deployment.test.ts +499 -0
  236. package/test/dns.test.ts +270 -0
  237. package/test/email.test.ts +439 -0
  238. package/test/filesystem.test.ts +382 -0
  239. package/test/integration.test.ts +350 -0
  240. package/test/messaging.test.ts +514 -0
  241. package/test/monitoring.test.ts +634 -0
  242. package/test/network.test.ts +425 -0
  243. package/test/permissions.test.ts +488 -0
  244. package/test/queue.test.ts +484 -0
  245. package/test/registry.test.ts +306 -0
  246. package/test/security.test.ts +462 -0
  247. package/test/storage.test.ts +463 -0
  248. package/test/template-validator.test.ts +559 -0
  249. package/test/workflow.test.ts +592 -0
  250. package/tsconfig.json +16 -0
  251. package/tsconfig.tsbuildinfo +1 -0
@@ -0,0 +1,406 @@
1
+ import { describe, expect, it } from 'bun:test'
2
+ import { Cache } from '../src/modules/cache'
3
+ import { TemplateBuilder } from '../src/template-builder'
4
+
5
+ describe('Cache Module', () => {
6
+ describe('createRedis', () => {
7
+ it('should create Redis replication group with default settings', () => {
8
+ const { replicationGroup, logicalId } = Cache.createRedis({
9
+ slug: 'my-app',
10
+ environment: 'production',
11
+ })
12
+
13
+ expect(replicationGroup.Type).toBe('AWS::ElastiCache::ReplicationGroup')
14
+ expect(replicationGroup.Properties.Engine).toBe('redis')
15
+ expect(replicationGroup.Properties.EngineVersion).toBe('7.1')
16
+ expect(replicationGroup.Properties.CacheNodeType).toBe('cache.t3.micro')
17
+ expect(replicationGroup.Properties.Port).toBe(6379)
18
+ expect(replicationGroup.Properties.NumCacheClusters).toBe(2)
19
+ expect(replicationGroup.Properties.AutomaticFailoverEnabled).toBe(true)
20
+ expect(replicationGroup.Properties.MultiAZEnabled).toBe(true)
21
+ expect(replicationGroup.Properties.AtRestEncryptionEnabled).toBe(true)
22
+ expect(replicationGroup.Properties.TransitEncryptionEnabled).toBe(true)
23
+ expect(replicationGroup.Properties.SnapshotRetentionLimit).toBe(7)
24
+ expect(logicalId).toBeDefined()
25
+ })
26
+
27
+ it('should create Redis with subnet group', () => {
28
+ const { replicationGroup, subnetGroup, subnetGroupId } = Cache.createRedis({
29
+ slug: 'my-app',
30
+ environment: 'production',
31
+ subnetIds: ['subnet-1', 'subnet-2', 'subnet-3'],
32
+ })
33
+
34
+ expect(subnetGroup).toBeDefined()
35
+ expect(subnetGroup?.Type).toBe('AWS::ElastiCache::SubnetGroup')
36
+ expect(subnetGroup?.Properties.SubnetIds).toEqual(['subnet-1', 'subnet-2', 'subnet-3'])
37
+ expect(subnetGroupId).toBeDefined()
38
+ })
39
+
40
+ it('should support custom configuration', () => {
41
+ const { replicationGroup } = Cache.createRedis({
42
+ slug: 'my-app',
43
+ environment: 'production',
44
+ nodeType: 'cache.r5.large',
45
+ engineVersion: '7.0',
46
+ port: 6380,
47
+ numCacheClusters: 3,
48
+ automaticFailover: false,
49
+ multiAz: false,
50
+ snapshotRetentionDays: 14,
51
+ })
52
+
53
+ expect(replicationGroup.Properties.CacheNodeType).toBe('cache.r5.large')
54
+ expect(replicationGroup.Properties.EngineVersion).toBe('7.0')
55
+ expect(replicationGroup.Properties.Port).toBe(6380)
56
+ expect(replicationGroup.Properties.NumCacheClusters).toBe(3)
57
+ expect(replicationGroup.Properties.AutomaticFailoverEnabled).toBe(false)
58
+ expect(replicationGroup.Properties.MultiAZEnabled).toBe(false)
59
+ expect(replicationGroup.Properties.SnapshotRetentionLimit).toBe(14)
60
+ })
61
+
62
+ it('should support cluster mode', () => {
63
+ const { replicationGroup } = Cache.createRedis({
64
+ slug: 'my-app',
65
+ environment: 'production',
66
+ clusterMode: true,
67
+ numNodeGroups: 3,
68
+ replicasPerNodeGroup: 2,
69
+ })
70
+
71
+ expect(replicationGroup.Properties.NumNodeGroups).toBe(3)
72
+ expect(replicationGroup.Properties.ReplicasPerNodeGroup).toBe(2)
73
+ expect(replicationGroup.Properties.NumCacheClusters).toBeUndefined()
74
+ })
75
+
76
+ it('should support auth token', () => {
77
+ const { replicationGroup } = Cache.createRedis({
78
+ slug: 'my-app',
79
+ environment: 'production',
80
+ authToken: 'MySecureToken123!',
81
+ })
82
+
83
+ expect(replicationGroup.Properties.AuthToken).toBe('MySecureToken123!')
84
+ })
85
+
86
+ it('should support KMS encryption', () => {
87
+ const { replicationGroup } = Cache.createRedis({
88
+ slug: 'my-app',
89
+ environment: 'production',
90
+ atRestEncryption: true,
91
+ kmsKeyId: 'arn:aws:kms:us-east-1:123456789:key/abc',
92
+ })
93
+
94
+ expect(replicationGroup.Properties.KmsKeyId).toBe('arn:aws:kms:us-east-1:123456789:key/abc')
95
+ })
96
+
97
+ it('should support security groups', () => {
98
+ const { replicationGroup } = Cache.createRedis({
99
+ slug: 'my-app',
100
+ environment: 'production',
101
+ securityGroupIds: ['sg-123', 'sg-456'],
102
+ })
103
+
104
+ expect(replicationGroup.Properties.SecurityGroupIds).toEqual(['sg-123', 'sg-456'])
105
+ })
106
+
107
+ it('should support snapshot window', () => {
108
+ const { replicationGroup } = Cache.createRedis({
109
+ slug: 'my-app',
110
+ environment: 'production',
111
+ snapshotWindow: '03:00-05:00',
112
+ })
113
+
114
+ expect(replicationGroup.Properties.SnapshotWindow).toBe('03:00-05:00')
115
+ })
116
+
117
+ it('should support maintenance window', () => {
118
+ const { replicationGroup } = Cache.createRedis({
119
+ slug: 'my-app',
120
+ environment: 'production',
121
+ maintenanceWindow: 'sun:05:00-sun:07:00',
122
+ })
123
+
124
+ expect(replicationGroup.Properties.PreferredMaintenanceWindow).toBe('sun:05:00-sun:07:00')
125
+ })
126
+
127
+ it('should disable encryption when requested', () => {
128
+ const { replicationGroup } = Cache.createRedis({
129
+ slug: 'my-app',
130
+ environment: 'production',
131
+ atRestEncryption: false,
132
+ transitEncryption: false,
133
+ })
134
+
135
+ expect(replicationGroup.Properties.AtRestEncryptionEnabled).toBe(false)
136
+ expect(replicationGroup.Properties.TransitEncryptionEnabled).toBe(false)
137
+ })
138
+ })
139
+
140
+ describe('createMemcached', () => {
141
+ it('should create Memcached cluster with default settings', () => {
142
+ const { cluster, logicalId } = Cache.createMemcached({
143
+ slug: 'my-app',
144
+ environment: 'production',
145
+ })
146
+
147
+ expect(cluster.Type).toBe('AWS::ElastiCache::CacheCluster')
148
+ expect(cluster.Properties.Engine).toBe('memcached')
149
+ expect(cluster.Properties.EngineVersion).toBe('1.6.22')
150
+ expect(cluster.Properties.CacheNodeType).toBe('cache.t3.micro')
151
+ expect(cluster.Properties.Port).toBe(11211)
152
+ expect(cluster.Properties.NumCacheNodes).toBe(2)
153
+ expect(cluster.Properties.AZMode).toBe('cross-az')
154
+ expect(logicalId).toBeDefined()
155
+ })
156
+
157
+ it('should create Memcached with subnet group', () => {
158
+ const { cluster, subnetGroup, subnetGroupId } = Cache.createMemcached({
159
+ slug: 'my-app',
160
+ environment: 'production',
161
+ subnetIds: ['subnet-1', 'subnet-2'],
162
+ })
163
+
164
+ expect(subnetGroup).toBeDefined()
165
+ expect(subnetGroup?.Type).toBe('AWS::ElastiCache::SubnetGroup')
166
+ expect(subnetGroup?.Properties.SubnetIds).toEqual(['subnet-1', 'subnet-2'])
167
+ expect(subnetGroupId).toBeDefined()
168
+ })
169
+
170
+ it('should support custom configuration', () => {
171
+ const { cluster } = Cache.createMemcached({
172
+ slug: 'my-app',
173
+ environment: 'production',
174
+ nodeType: 'cache.m5.large',
175
+ engineVersion: '1.6.17',
176
+ port: 11212,
177
+ numCacheNodes: 3,
178
+ azMode: 'single-az',
179
+ })
180
+
181
+ expect(cluster.Properties.CacheNodeType).toBe('cache.m5.large')
182
+ expect(cluster.Properties.EngineVersion).toBe('1.6.17')
183
+ expect(cluster.Properties.Port).toBe(11212)
184
+ expect(cluster.Properties.NumCacheNodes).toBe(3)
185
+ expect(cluster.Properties.AZMode).toBe('single-az')
186
+ })
187
+
188
+ it('should support security groups', () => {
189
+ const { cluster } = Cache.createMemcached({
190
+ slug: 'my-app',
191
+ environment: 'production',
192
+ securityGroupIds: ['sg-123'],
193
+ })
194
+
195
+ expect(cluster.Properties.VpcSecurityGroupIds).toEqual(['sg-123'])
196
+ })
197
+
198
+ it('should support preferred availability zones', () => {
199
+ const { cluster } = Cache.createMemcached({
200
+ slug: 'my-app',
201
+ environment: 'production',
202
+ preferredAzs: ['us-east-1a', 'us-east-1b'],
203
+ })
204
+
205
+ expect(cluster.Properties.PreferredAvailabilityZones).toEqual(['us-east-1a', 'us-east-1b'])
206
+ })
207
+
208
+ it('should support maintenance window', () => {
209
+ const { cluster } = Cache.createMemcached({
210
+ slug: 'my-app',
211
+ environment: 'production',
212
+ maintenanceWindow: 'sun:05:00-sun:07:00',
213
+ })
214
+
215
+ expect(cluster.Properties.PreferredMaintenanceWindow).toBe('sun:05:00-sun:07:00')
216
+ })
217
+ })
218
+
219
+ describe('enableClusterMode', () => {
220
+ it('should enable cluster mode on Redis', () => {
221
+ const { replicationGroup } = Cache.createRedis({
222
+ slug: 'my-app',
223
+ environment: 'production',
224
+ })
225
+
226
+ Cache.enableClusterMode(replicationGroup, 3, 2)
227
+
228
+ expect(replicationGroup.Properties.NumNodeGroups).toBe(3)
229
+ expect(replicationGroup.Properties.ReplicasPerNodeGroup).toBe(2)
230
+ expect(replicationGroup.Properties.NumCacheClusters).toBeUndefined()
231
+ })
232
+ })
233
+
234
+ describe('createRedisParameterGroup', () => {
235
+ it('should create Redis parameter group', () => {
236
+ const { parameterGroup, logicalId } = Cache.createRedisParameterGroup('7.1', {
237
+ slug: 'my-app',
238
+ environment: 'production',
239
+ parameters: {
240
+ 'maxmemory-policy': 'allkeys-lru',
241
+ 'timeout': '300',
242
+ },
243
+ })
244
+
245
+ expect(parameterGroup.Type).toBe('AWS::ElastiCache::ParameterGroup')
246
+ expect(parameterGroup.Properties.CacheParameterGroupFamily).toBe('redis7.x')
247
+ expect(parameterGroup.Properties.Properties?.['maxmemory-policy']).toBe('allkeys-lru')
248
+ expect(parameterGroup.Properties.Properties?.timeout).toBe('300')
249
+ expect(logicalId).toBeDefined()
250
+ })
251
+
252
+ it('should support different Redis versions', () => {
253
+ const { parameterGroup: v6 } = Cache.createRedisParameterGroup('6.2', {
254
+ slug: 'my-app',
255
+ environment: 'production',
256
+ })
257
+
258
+ const { parameterGroup: v7 } = Cache.createRedisParameterGroup('7.0', {
259
+ slug: 'my-app',
260
+ environment: 'production',
261
+ })
262
+
263
+ expect(v6.Properties.CacheParameterGroupFamily).toBe('redis6.x')
264
+ expect(v7.Properties.CacheParameterGroupFamily).toBe('redis7.x')
265
+ })
266
+ })
267
+
268
+ describe('createMemcachedParameterGroup', () => {
269
+ it('should create Memcached parameter group', () => {
270
+ const { parameterGroup, logicalId } = Cache.createMemcachedParameterGroup('1.6.22', {
271
+ slug: 'my-app',
272
+ environment: 'production',
273
+ parameters: {
274
+ 'max_item_size': '10485760',
275
+ },
276
+ })
277
+
278
+ expect(parameterGroup.Type).toBe('AWS::ElastiCache::ParameterGroup')
279
+ expect(parameterGroup.Properties.CacheParameterGroupFamily).toBe('memcached1.6')
280
+ expect(parameterGroup.Properties.Properties?.max_item_size).toBe('10485760')
281
+ expect(logicalId).toBeDefined()
282
+ })
283
+ })
284
+
285
+ describe('NodeTypes', () => {
286
+ it('should provide common node type constants', () => {
287
+ expect(Cache.NodeTypes.T3_Micro).toBe('cache.t3.micro')
288
+ expect(Cache.NodeTypes.T3_Small).toBe('cache.t3.small')
289
+ expect(Cache.NodeTypes.M5_Large).toBe('cache.m5.large')
290
+ expect(Cache.NodeTypes.R5_XLarge).toBe('cache.r5.xlarge')
291
+ expect(Cache.NodeTypes.R6g_Large).toBe('cache.r6g.large')
292
+ })
293
+ })
294
+
295
+ describe('Integration with TemplateBuilder', () => {
296
+ it('should create Redis cluster infrastructure', () => {
297
+ const template = new TemplateBuilder('Redis Cluster')
298
+
299
+ const { replicationGroup, subnetGroup, logicalId, subnetGroupId } = Cache.createRedis({
300
+ slug: 'my-app',
301
+ environment: 'production',
302
+ subnetIds: ['subnet-1', 'subnet-2', 'subnet-3'],
303
+ securityGroupIds: ['sg-123'],
304
+ numCacheClusters: 3,
305
+ authToken: 'MySecureToken123!',
306
+ })
307
+
308
+ if (subnetGroup && subnetGroupId) {
309
+ template.addResource(subnetGroupId, subnetGroup)
310
+ }
311
+
312
+ template.addResource(logicalId, replicationGroup)
313
+
314
+ const result = template.build()
315
+
316
+ expect(Object.keys(result.Resources)).toHaveLength(2)
317
+ expect(result.Resources[logicalId].Type).toBe('AWS::ElastiCache::ReplicationGroup')
318
+ })
319
+
320
+ it('should create Redis cluster mode infrastructure', () => {
321
+ const template = new TemplateBuilder('Redis Cluster Mode')
322
+
323
+ const { replicationGroup, logicalId } = Cache.createRedis({
324
+ slug: 'my-app',
325
+ environment: 'production',
326
+ clusterMode: true,
327
+ numNodeGroups: 3,
328
+ replicasPerNodeGroup: 2,
329
+ nodeType: Cache.NodeTypes.R5_Large,
330
+ })
331
+
332
+ template.addResource(logicalId, replicationGroup)
333
+
334
+ const result = template.build()
335
+
336
+ expect(Object.keys(result.Resources)).toHaveLength(1)
337
+ expect(result.Resources[logicalId]!.Properties!.NumNodeGroups).toBe(3)
338
+ expect(result.Resources[logicalId]!.Properties!.ReplicasPerNodeGroup).toBe(2)
339
+ })
340
+
341
+ it('should create Memcached cluster infrastructure', () => {
342
+ const template = new TemplateBuilder('Memcached Cluster')
343
+
344
+ const { cluster, subnetGroup, logicalId, subnetGroupId } = Cache.createMemcached({
345
+ slug: 'my-app',
346
+ environment: 'production',
347
+ subnetIds: ['subnet-1', 'subnet-2'],
348
+ numCacheNodes: 3,
349
+ azMode: 'cross-az',
350
+ })
351
+
352
+ if (subnetGroup && subnetGroupId) {
353
+ template.addResource(subnetGroupId, subnetGroup)
354
+ }
355
+
356
+ template.addResource(logicalId, cluster)
357
+
358
+ const result = template.build()
359
+
360
+ expect(Object.keys(result.Resources)).toHaveLength(2)
361
+ expect(result.Resources[logicalId].Type).toBe('AWS::ElastiCache::CacheCluster')
362
+ })
363
+
364
+ it('should create Redis with parameter group', () => {
365
+ const template = new TemplateBuilder('Redis with Params')
366
+
367
+ const { replicationGroup, logicalId: redisId } = Cache.createRedis({
368
+ slug: 'my-app',
369
+ environment: 'production',
370
+ })
371
+
372
+ const { parameterGroup, logicalId: paramsId } = Cache.createRedisParameterGroup('7.1', {
373
+ slug: 'my-app',
374
+ environment: 'production',
375
+ parameters: {
376
+ 'maxmemory-policy': 'allkeys-lru',
377
+ },
378
+ })
379
+
380
+ template.addResource(paramsId, parameterGroup)
381
+ template.addResource(redisId, replicationGroup)
382
+
383
+ const result = template.build()
384
+
385
+ expect(Object.keys(result.Resources)).toHaveLength(2)
386
+ expect(result.Resources[paramsId].Type).toBe('AWS::ElastiCache::ParameterGroup')
387
+ })
388
+
389
+ it('should generate valid JSON template', () => {
390
+ const template = new TemplateBuilder('Cache Test')
391
+
392
+ const { replicationGroup, logicalId } = Cache.createRedis({
393
+ slug: 'test',
394
+ environment: 'development',
395
+ })
396
+
397
+ template.addResource(logicalId, replicationGroup)
398
+
399
+ const json = template.toJSON()
400
+ const parsed = JSON.parse(json)
401
+
402
+ expect(parsed.Resources[logicalId].Type).toBe('AWS::ElastiCache::ReplicationGroup')
403
+ expect(parsed.Resources[logicalId].Properties.Engine).toBe('redis')
404
+ })
405
+ })
406
+ })
@@ -0,0 +1,247 @@
1
+ import { describe, expect, it } from 'bun:test'
2
+ import { CDN } from '../src/modules/cdn'
3
+ import { TemplateBuilder } from '../src/template-builder'
4
+
5
+ describe('CDN Module', () => {
6
+ describe('createDistribution', () => {
7
+ it('should create a basic CloudFront distribution with S3 origin', () => {
8
+ const { distribution, originAccessControl, logicalId } = CDN.createDistribution({
9
+ slug: 'my-app',
10
+ environment: 'production',
11
+ origin: {
12
+ type: 's3',
13
+ domainName: 'my-bucket.s3.amazonaws.com',
14
+ },
15
+ })
16
+
17
+ expect(distribution.Type).toBe('AWS::CloudFront::Distribution')
18
+ expect(distribution.Properties.DistributionConfig.Enabled).toBe(true)
19
+ expect(distribution.Properties.DistributionConfig.Origins).toHaveLength(1)
20
+ expect(distribution.Properties.DistributionConfig.Origins[0].DomainName).toBe('my-bucket.s3.amazonaws.com')
21
+ expect(originAccessControl).toBeDefined()
22
+ expect(originAccessControl?.Type).toBe('AWS::CloudFront::OriginAccessControl')
23
+ })
24
+
25
+ it('should create distribution with custom domain and certificate', () => {
26
+ const { distribution } = CDN.createDistribution({
27
+ slug: 'my-app',
28
+ environment: 'production',
29
+ origin: {
30
+ type: 's3',
31
+ domainName: 'my-bucket.s3.amazonaws.com',
32
+ },
33
+ customDomain: 'www.example.com',
34
+ certificateArn: 'arn:aws:acm:us-east-1:123456789:certificate/abc',
35
+ })
36
+
37
+ expect(distribution.Properties.DistributionConfig.Aliases).toContain('www.example.com')
38
+ expect(distribution.Properties.DistributionConfig.ViewerCertificate?.AcmCertificateArn).toBe(
39
+ 'arn:aws:acm:us-east-1:123456789:certificate/abc',
40
+ )
41
+ expect(distribution.Properties.DistributionConfig.ViewerCertificate?.SslSupportMethod).toBe('sni-only')
42
+ })
43
+
44
+ it('should create distribution with ALB origin', () => {
45
+ const { distribution, originAccessControl } = CDN.createDistribution({
46
+ slug: 'my-app',
47
+ environment: 'production',
48
+ origin: {
49
+ type: 'alb',
50
+ domainName: 'my-alb.us-east-1.elb.amazonaws.com',
51
+ },
52
+ })
53
+
54
+ expect(distribution.Properties.DistributionConfig.Origins[0].CustomOriginConfig).toBeDefined()
55
+ expect(distribution.Properties.DistributionConfig.Origins[0].CustomOriginConfig?.OriginProtocolPolicy).toBe(
56
+ 'https-only',
57
+ )
58
+ expect(originAccessControl).toBeUndefined() // ALB doesn't use OAC
59
+ })
60
+
61
+ it('should configure error pages for SPA', () => {
62
+ const { distribution } = CDN.createDistribution({
63
+ slug: 'my-app',
64
+ environment: 'production',
65
+ origin: {
66
+ type: 's3',
67
+ domainName: 'my-bucket.s3.amazonaws.com',
68
+ },
69
+ errorPages: [
70
+ { errorCode: 404, responseCode: 200, responsePagePath: '/index.html' },
71
+ { errorCode: 403, responseCode: 200, responsePagePath: '/index.html' },
72
+ ],
73
+ })
74
+
75
+ expect(distribution.Properties.DistributionConfig.CustomErrorResponses).toHaveLength(2)
76
+ expect(distribution.Properties.DistributionConfig.CustomErrorResponses?.[0].ErrorCode).toBe(404)
77
+ expect(distribution.Properties.DistributionConfig.CustomErrorResponses?.[0].ResponsePagePath).toBe('/index.html')
78
+ })
79
+
80
+ it('should enable HTTP/3 when specified', () => {
81
+ const { distribution } = CDN.createDistribution({
82
+ slug: 'my-app',
83
+ environment: 'production',
84
+ origin: {
85
+ type: 's3',
86
+ domainName: 'my-bucket.s3.amazonaws.com',
87
+ },
88
+ http3: true,
89
+ })
90
+
91
+ expect(distribution.Properties.DistributionConfig.HttpVersion).toBe('http2and3')
92
+ })
93
+
94
+ it('should configure Lambda@Edge functions', () => {
95
+ const { distribution } = CDN.createDistribution({
96
+ slug: 'my-app',
97
+ environment: 'production',
98
+ origin: {
99
+ type: 's3',
100
+ domainName: 'my-bucket.s3.amazonaws.com',
101
+ },
102
+ edgeFunctions: [
103
+ {
104
+ event: 'origin-request',
105
+ functionArn: 'arn:aws:lambda:us-east-1:123456789:function:my-function:1',
106
+ },
107
+ ],
108
+ })
109
+
110
+ expect(
111
+ distribution.Properties.DistributionConfig.DefaultCacheBehavior.LambdaFunctionAssociations,
112
+ ).toHaveLength(1)
113
+ expect(
114
+ distribution.Properties.DistributionConfig.DefaultCacheBehavior.LambdaFunctionAssociations?.[0].EventType,
115
+ ).toBe('origin-request')
116
+ })
117
+ })
118
+
119
+ describe('createSpaDistribution', () => {
120
+ it('should create SPA distribution with 404/403 → index.html mapping', () => {
121
+ const { distribution } = CDN.createSpaDistribution({
122
+ slug: 'my-app',
123
+ environment: 'production',
124
+ origin: {
125
+ type: 's3',
126
+ domainName: 'my-bucket.s3.amazonaws.com',
127
+ },
128
+ })
129
+
130
+ const errorResponses = distribution.Properties.DistributionConfig.CustomErrorResponses
131
+ expect(errorResponses).toHaveLength(2)
132
+ expect(errorResponses?.find(r => r.ErrorCode === 404)?.ResponseCode).toBe(200)
133
+ expect(errorResponses?.find(r => r.ErrorCode === 403)?.ResponseCode).toBe(200)
134
+ })
135
+ })
136
+
137
+ describe('setCustomDomain', () => {
138
+ it('should add custom domain to existing distribution', () => {
139
+ const { distribution } = CDN.createDistribution({
140
+ slug: 'my-app',
141
+ environment: 'production',
142
+ origin: {
143
+ type: 's3',
144
+ domainName: 'my-bucket.s3.amazonaws.com',
145
+ },
146
+ })
147
+
148
+ const updated = CDN.setCustomDomain(
149
+ distribution,
150
+ 'cdn.example.com',
151
+ 'arn:aws:acm:us-east-1:123456789:certificate/xyz',
152
+ )
153
+
154
+ expect(updated.Properties.DistributionConfig.Aliases).toContain('cdn.example.com')
155
+ expect(updated.Properties.DistributionConfig.ViewerCertificate?.AcmCertificateArn).toContain('certificate/xyz')
156
+ })
157
+ })
158
+
159
+ describe('enableHttp3', () => {
160
+ it('should enable HTTP/3 on existing distribution', () => {
161
+ const { distribution } = CDN.createDistribution({
162
+ slug: 'my-app',
163
+ environment: 'production',
164
+ origin: {
165
+ type: 's3',
166
+ domainName: 'my-bucket.s3.amazonaws.com',
167
+ },
168
+ })
169
+
170
+ const updated = CDN.enableHttp3(distribution)
171
+
172
+ expect(updated.Properties.DistributionConfig.HttpVersion).toBe('http2and3')
173
+ })
174
+ })
175
+
176
+ describe('addEdgeFunction', () => {
177
+ it('should add Lambda@Edge function to existing distribution', () => {
178
+ const { distribution } = CDN.createDistribution({
179
+ slug: 'my-app',
180
+ environment: 'production',
181
+ origin: {
182
+ type: 's3',
183
+ domainName: 'my-bucket.s3.amazonaws.com',
184
+ },
185
+ })
186
+
187
+ const updated = CDN.addEdgeFunction(
188
+ distribution,
189
+ 'viewer-request',
190
+ 'arn:aws:lambda:us-east-1:123456789:function:auth:1',
191
+ )
192
+
193
+ const associations = updated.Properties.DistributionConfig.DefaultCacheBehavior.LambdaFunctionAssociations
194
+ expect(associations).toHaveLength(1)
195
+ expect(associations?.[0].EventType).toBe('viewer-request')
196
+ })
197
+ })
198
+
199
+ describe('Integration with TemplateBuilder', () => {
200
+ it('should integrate with CloudFormation template', () => {
201
+ const template = new TemplateBuilder('CDN Infrastructure')
202
+
203
+ const { distribution, originAccessControl, logicalId } = CDN.createDistribution({
204
+ slug: 'my-app',
205
+ environment: 'production',
206
+ origin: {
207
+ type: 's3',
208
+ domainName: 'my-bucket.s3.amazonaws.com',
209
+ },
210
+ customDomain: 'www.example.com',
211
+ certificateArn: 'arn:aws:acm:us-east-1:123456789:certificate/abc',
212
+ })
213
+
214
+ template.addResource(logicalId, distribution)
215
+
216
+ if (originAccessControl) {
217
+ template.addResource(`${logicalId}OAC`, originAccessControl)
218
+ }
219
+
220
+ const result = template.build()
221
+
222
+ expect(result.Resources[logicalId]).toBeDefined()
223
+ expect(result.Resources[logicalId].Type).toBe('AWS::CloudFront::Distribution')
224
+ })
225
+
226
+ it('should generate valid JSON template', () => {
227
+ const template = new TemplateBuilder('CDN Test')
228
+
229
+ const { distribution, logicalId } = CDN.createSpaDistribution({
230
+ slug: 'spa',
231
+ environment: 'production',
232
+ origin: {
233
+ type: 's3',
234
+ domainName: 'spa-bucket.s3.amazonaws.com',
235
+ },
236
+ })
237
+
238
+ template.addResource(logicalId, distribution)
239
+
240
+ const json = template.toJSON()
241
+ const parsed = JSON.parse(json)
242
+
243
+ expect(parsed.Resources[logicalId].Type).toBe('AWS::CloudFront::Distribution')
244
+ expect(parsed.Resources[logicalId].Properties.DistributionConfig.CustomErrorResponses).toHaveLength(2)
245
+ })
246
+ })
247
+ })