@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,173 @@
1
+ /**
2
+ * CloudFormation Template Types
3
+ * Based on AWS CloudFormation Resource Specification
4
+ */
5
+
6
+ export interface CloudFormationTemplate {
7
+ AWSTemplateFormatVersion: '2010-09-09'
8
+ Description?: string
9
+ Metadata?: Record<string, any>
10
+ Parameters?: Record<string, CloudFormationParameter>
11
+ Mappings?: Record<string, Record<string, Record<string, string>>>
12
+ Conditions?: Record<string, CloudFormationCondition>
13
+ Resources: Record<string, CloudFormationResource>
14
+ Outputs?: Record<string, CloudFormationOutput>
15
+ }
16
+
17
+ export interface CloudFormationParameter {
18
+ Type: 'String' | 'Number' | 'List<Number>' | 'CommaDelimitedList' | 'AWS::EC2::AvailabilityZone::Name' | 'AWS::EC2::Image::Id' | 'AWS::EC2::Instance::Id' | 'AWS::EC2::KeyPair::KeyName' | 'AWS::EC2::SecurityGroup::GroupName' | 'AWS::EC2::SecurityGroup::Id' | 'AWS::EC2::Subnet::Id' | 'AWS::EC2::Volume::Id' | 'AWS::EC2::VPC::Id' | 'AWS::Route53::HostedZone::Id' | 'List<AWS::EC2::AvailabilityZone::Name>' | 'List<AWS::EC2::Image::Id>' | 'List<AWS::EC2::Instance::Id>' | 'List<AWS::EC2::SecurityGroup::GroupName>' | 'List<AWS::EC2::SecurityGroup::Id>' | 'List<AWS::EC2::Subnet::Id>' | 'List<AWS::EC2::Volume::Id>' | 'List<AWS::EC2::VPC::Id>' | 'List<AWS::Route53::HostedZone::Id>'
19
+ Default?: string | number
20
+ Description?: string
21
+ AllowedValues?: string[]
22
+ AllowedPattern?: string
23
+ MinLength?: number
24
+ MaxLength?: number
25
+ MinValue?: number
26
+ MaxValue?: number
27
+ ConstraintDescription?: string
28
+ NoEcho?: boolean
29
+ }
30
+
31
+ export interface CloudFormationResource {
32
+ Type: string
33
+ Properties?: Record<string, any>
34
+ DependsOn?: string | string[]
35
+ Condition?: string
36
+ Metadata?: Record<string, any>
37
+ CreationPolicy?: Record<string, any>
38
+ UpdatePolicy?: Record<string, any>
39
+ DeletionPolicy?: 'Delete' | 'Retain' | 'Snapshot'
40
+ UpdateReplacePolicy?: 'Delete' | 'Retain' | 'Snapshot'
41
+ }
42
+
43
+ export interface CloudFormationOutput {
44
+ Value: any
45
+ Description?: string
46
+ Export?: {
47
+ Name: any
48
+ }
49
+ Condition?: string
50
+ }
51
+
52
+ export type CloudFormationCondition =
53
+ | CloudFormationIntrinsicFunction
54
+ | boolean
55
+
56
+ /**
57
+ * CloudFormation Intrinsic Functions
58
+ */
59
+ export type CloudFormationIntrinsicFunction =
60
+ | { Ref: string }
61
+ | { 'Fn::GetAtt': [string, string] }
62
+ | { 'Fn::Join': [string, any[]] }
63
+ | { 'Fn::Sub': string | [string, Record<string, any>] }
64
+ | { 'Fn::Select': [number, any[] | CloudFormationIntrinsicFunction] }
65
+ | { 'Fn::Split': [string, string] }
66
+ | { 'Fn::GetAZs': string }
67
+ | { 'Fn::ImportValue': any }
68
+ | { 'Fn::FindInMap': [string, any, any] }
69
+ | { 'Fn::Base64': any }
70
+ | { 'Fn::Cidr': [any, number, number] }
71
+ | { 'Fn::Equals': [any, any] }
72
+ | { 'Fn::If': [string, any, any] }
73
+ | { 'Fn::Not': [any] }
74
+ | { 'Fn::And': any[] }
75
+ | { 'Fn::Or': any[] }
76
+
77
+ /**
78
+ * Helper functions for creating CloudFormation intrinsic functions
79
+ */
80
+ export const Fn = {
81
+ ref: (logicalId: string): { Ref: string } => ({ Ref: logicalId }),
82
+
83
+ getAtt: (logicalId: string, attribute: string): { 'Fn::GetAtt': [string, string] } =>
84
+ ({ 'Fn::GetAtt': [logicalId, attribute] as [string, string] }),
85
+
86
+ join: (delimiter: string, values: any[]): { 'Fn::Join': [string, any[]] } =>
87
+ ({ 'Fn::Join': [delimiter, values] as [string, any[]] }),
88
+
89
+ sub: (template: string, variables?: Record<string, any>): { 'Fn::Sub': string | [string, Record<string, any>] } =>
90
+ variables ? { 'Fn::Sub': [template, variables] as [string, Record<string, any>] } : { 'Fn::Sub': template },
91
+
92
+ select: (index: number, list: any[] | CloudFormationIntrinsicFunction): { 'Fn::Select': [number, any[] | CloudFormationIntrinsicFunction] } =>
93
+ ({ 'Fn::Select': [index, list] as [number, any[] | CloudFormationIntrinsicFunction] }),
94
+
95
+ split: (delimiter: string, source: string): { 'Fn::Split': [string, string] } =>
96
+ ({ 'Fn::Split': [delimiter, source] as [string, string] }),
97
+
98
+ getAZs: (region: string = ''): { 'Fn::GetAZs': string } => ({ 'Fn::GetAZs': region }),
99
+
100
+ importValue: (name: any): { 'Fn::ImportValue': any } => ({ 'Fn::ImportValue': name }),
101
+
102
+ findInMap: (mapName: string, topLevelKey: any, secondLevelKey: any): { 'Fn::FindInMap': [string, any, any] } =>
103
+ ({ 'Fn::FindInMap': [mapName, topLevelKey, secondLevelKey] as [string, any, any] }),
104
+
105
+ base64: (value: any): { 'Fn::Base64': any } => ({ 'Fn::Base64': value }),
106
+
107
+ cidr: (ipBlock: any, count: number, cidrBits: number): { 'Fn::Cidr': [any, number, number] } =>
108
+ ({ 'Fn::Cidr': [ipBlock, count, cidrBits] as [any, number, number] }),
109
+
110
+ equals: (value1: any, value2: any): { 'Fn::Equals': [any, any] } =>
111
+ ({ 'Fn::Equals': [value1, value2] as [any, any] }),
112
+
113
+ if: (conditionName: string, trueValue: any, falseValue: any): { 'Fn::If': [string, any, any] } =>
114
+ ({ 'Fn::If': [conditionName, trueValue, falseValue] as [string, any, any] }),
115
+
116
+ not: (condition: any): { 'Fn::Not': [any] } => ({ 'Fn::Not': [condition] as [any] }),
117
+
118
+ and: (...conditions: any[]): { 'Fn::And': any[] } => ({ 'Fn::And': conditions }),
119
+
120
+ or: (...conditions: any[]): { 'Fn::Or': any[] } => ({ 'Fn::Or': conditions }),
121
+ }
122
+
123
+ /**
124
+ * Common AWS resource ARN patterns
125
+ */
126
+ export const Arn = {
127
+ s3Bucket: (bucketName: any): { 'Fn::Sub': string | [string, Record<string, any>] } =>
128
+ Fn.sub(`arn:aws:s3:::${bucketName}`),
129
+
130
+ s3Object: (bucketName: any, key: string = '*'): { 'Fn::Sub': string | [string, Record<string, any>] } =>
131
+ Fn.sub(`arn:aws:s3:::${bucketName}/${key}`),
132
+
133
+ lambda: (functionName: string, region?: string, account?: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
134
+ Fn.sub(
135
+ `arn:aws:lambda:\${AWS::Region}:\${AWS::AccountId}:function:${functionName}`,
136
+ region && account ? { 'AWS::Region': region, 'AWS::AccountId': account } : undefined,
137
+ ),
138
+
139
+ dynamodb: (tableName: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
140
+ Fn.sub(`arn:aws:dynamodb:\${AWS::Region}:\${AWS::AccountId}:table/${tableName}`),
141
+
142
+ sqs: (queueName: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
143
+ Fn.sub(`arn:aws:sqs:\${AWS::Region}:\${AWS::AccountId}:${queueName}`),
144
+
145
+ sns: (topicName: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
146
+ Fn.sub(`arn:aws:sns:\${AWS::Region}:\${AWS::AccountId}:${topicName}`),
147
+
148
+ kinesis: (streamName: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
149
+ Fn.sub(`arn:aws:kinesis:\${AWS::Region}:\${AWS::AccountId}:stream/${streamName}`),
150
+
151
+ iam: (resourceType: 'role' | 'policy' | 'user' | 'group', name: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
152
+ Fn.sub(`arn:aws:iam::\${AWS::AccountId}:${resourceType}/${name}`),
153
+
154
+ secretsManager: (secretName: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
155
+ Fn.sub(`arn:aws:secretsmanager:\${AWS::Region}:\${AWS::AccountId}:secret:${secretName}`),
156
+
157
+ cloudwatch: (logGroup: string): { 'Fn::Sub': string | [string, Record<string, any>] } =>
158
+ Fn.sub(`arn:aws:logs:\${AWS::Region}:\${AWS::AccountId}:log-group:${logGroup}`),
159
+ }
160
+
161
+ /**
162
+ * Common CloudFormation pseudo parameters
163
+ */
164
+ export const AWS_PSEUDO_PARAMETERS = {
165
+ ACCOUNT_ID: { Ref: 'AWS::AccountId' },
166
+ NOTIFICATION_ARNS: { Ref: 'AWS::NotificationARNs' },
167
+ NO_VALUE: { Ref: 'AWS::NoValue' },
168
+ PARTITION: { Ref: 'AWS::Partition' },
169
+ REGION: { Ref: 'AWS::Region' },
170
+ STACK_ID: { Ref: 'AWS::StackId' },
171
+ STACK_NAME: { Ref: 'AWS::StackName' },
172
+ URL_SUFFIX: { Ref: 'AWS::URLSuffix' },
173
+ }
@@ -0,0 +1,543 @@
1
+ /**
2
+ * AWS Config Rules
3
+ * Automated compliance checking and configuration management
4
+ */
5
+
6
+ export interface ConfigRule {
7
+ id: string
8
+ name: string
9
+ description: string
10
+ source: 'AWS_MANAGED' | 'CUSTOM_LAMBDA'
11
+ identifier?: string
12
+ lambdaFunctionArn?: string
13
+ inputParameters?: Record<string, any>
14
+ scope?: ConfigScope
15
+ maxExecutionFrequency?: 'One_Hour' | 'Three_Hours' | 'Six_Hours' | 'Twelve_Hours' | 'TwentyFour_Hours'
16
+ }
17
+
18
+ export interface ConfigScope {
19
+ complianceResourceTypes?: string[]
20
+ tagKey?: string
21
+ tagValue?: string
22
+ }
23
+
24
+ export interface ConfigRecorder {
25
+ name: string
26
+ roleArn: string
27
+ recordingGroup?: RecordingGroup
28
+ }
29
+
30
+ export interface RecordingGroup {
31
+ allSupported?: boolean
32
+ includeGlobalResourceTypes?: boolean
33
+ resourceTypes?: string[]
34
+ }
35
+
36
+ export interface DeliveryChannel {
37
+ name: string
38
+ s3BucketName: string
39
+ s3KeyPrefix?: string
40
+ snsTopicArn?: string
41
+ configSnapshotDeliveryProperties?: {
42
+ deliveryFrequency?: 'One_Hour' | 'Three_Hours' | 'Six_Hours' | 'Twelve_Hours' | 'TwentyFour_Hours'
43
+ }
44
+ }
45
+
46
+ /**
47
+ * AWS Config manager
48
+ */
49
+ export class AWSConfigManager {
50
+ private configRules: Map<string, ConfigRule> = new Map()
51
+ private configRecorders: Map<string, ConfigRecorder> = new Map()
52
+ private deliveryChannels: Map<string, DeliveryChannel> = new Map()
53
+ private ruleCounter = 0
54
+
55
+ /**
56
+ * Create config recorder
57
+ */
58
+ createConfigRecorder(recorder: ConfigRecorder): ConfigRecorder {
59
+ this.configRecorders.set(recorder.name, recorder)
60
+ return recorder
61
+ }
62
+
63
+ /**
64
+ * Create delivery channel
65
+ */
66
+ createDeliveryChannel(channel: DeliveryChannel): DeliveryChannel {
67
+ this.deliveryChannels.set(channel.name, channel)
68
+ return channel
69
+ }
70
+
71
+ /**
72
+ * Create config rule
73
+ */
74
+ createConfigRule(rule: Omit<ConfigRule, 'id'>): ConfigRule {
75
+ const id = `config-rule-${Date.now()}-${this.ruleCounter++}`
76
+
77
+ const configRule: ConfigRule = {
78
+ id,
79
+ ...rule,
80
+ }
81
+
82
+ this.configRules.set(id, configRule)
83
+
84
+ return configRule
85
+ }
86
+
87
+ /**
88
+ * Create S3 bucket encryption rule
89
+ */
90
+ createS3EncryptionRule(): ConfigRule {
91
+ return this.createConfigRule({
92
+ name: 's3-bucket-server-side-encryption-enabled',
93
+ description: 'Checks that S3 buckets have server-side encryption enabled',
94
+ source: 'AWS_MANAGED',
95
+ identifier: 'S3_BUCKET_SERVER_SIDE_ENCRYPTION_ENABLED',
96
+ scope: {
97
+ complianceResourceTypes: ['AWS::S3::Bucket'],
98
+ },
99
+ })
100
+ }
101
+
102
+ /**
103
+ * Create S3 bucket public access block rule
104
+ */
105
+ createS3PublicAccessBlockRule(): ConfigRule {
106
+ return this.createConfigRule({
107
+ name: 's3-bucket-public-read-prohibited',
108
+ description: 'Checks that S3 buckets do not allow public read access',
109
+ source: 'AWS_MANAGED',
110
+ identifier: 'S3_BUCKET_PUBLIC_READ_PROHIBITED',
111
+ scope: {
112
+ complianceResourceTypes: ['AWS::S3::Bucket'],
113
+ },
114
+ })
115
+ }
116
+
117
+ /**
118
+ * Create S3 bucket versioning rule
119
+ */
120
+ createS3VersioningRule(): ConfigRule {
121
+ return this.createConfigRule({
122
+ name: 's3-bucket-versioning-enabled',
123
+ description: 'Checks whether versioning is enabled for S3 buckets',
124
+ source: 'AWS_MANAGED',
125
+ identifier: 'S3_BUCKET_VERSIONING_ENABLED',
126
+ scope: {
127
+ complianceResourceTypes: ['AWS::S3::Bucket'],
128
+ },
129
+ })
130
+ }
131
+
132
+ /**
133
+ * Create RDS encryption rule
134
+ */
135
+ createRdsEncryptionRule(): ConfigRule {
136
+ return this.createConfigRule({
137
+ name: 'rds-storage-encrypted',
138
+ description: 'Checks whether storage encryption is enabled for RDS DB instances',
139
+ source: 'AWS_MANAGED',
140
+ identifier: 'RDS_STORAGE_ENCRYPTED',
141
+ scope: {
142
+ complianceResourceTypes: ['AWS::RDS::DBInstance'],
143
+ },
144
+ })
145
+ }
146
+
147
+ /**
148
+ * Create RDS snapshot encryption rule
149
+ */
150
+ createRdsSnapshotEncryptionRule(): ConfigRule {
151
+ return this.createConfigRule({
152
+ name: 'rds-snapshots-public-prohibited',
153
+ description: 'Checks if RDS snapshots are public',
154
+ source: 'AWS_MANAGED',
155
+ identifier: 'RDS_SNAPSHOTS_PUBLIC_PROHIBITED',
156
+ scope: {
157
+ complianceResourceTypes: ['AWS::RDS::DBSnapshot', 'AWS::RDS::DBClusterSnapshot'],
158
+ },
159
+ })
160
+ }
161
+
162
+ /**
163
+ * Create RDS backup rule
164
+ */
165
+ createRdsBackupRule(retentionPeriod: number = 7): ConfigRule {
166
+ return this.createConfigRule({
167
+ name: 'db-backup-enabled',
168
+ description: 'Checks whether RDS DB instances have backups enabled',
169
+ source: 'AWS_MANAGED',
170
+ identifier: 'DB_BACKUP_ENABLED',
171
+ inputParameters: {
172
+ backupRetentionPeriod: retentionPeriod,
173
+ },
174
+ scope: {
175
+ complianceResourceTypes: ['AWS::RDS::DBInstance'],
176
+ },
177
+ })
178
+ }
179
+
180
+ /**
181
+ * Create EC2 instance profile rule
182
+ */
183
+ createEc2InstanceProfileRule(): ConfigRule {
184
+ return this.createConfigRule({
185
+ name: 'ec2-instance-managed-by-systems-manager',
186
+ description: 'Checks if EC2 instances are managed by Systems Manager',
187
+ source: 'AWS_MANAGED',
188
+ identifier: 'EC2_INSTANCE_MANAGED_BY_SSM',
189
+ scope: {
190
+ complianceResourceTypes: ['AWS::EC2::Instance'],
191
+ },
192
+ })
193
+ }
194
+
195
+ /**
196
+ * Create EBS encryption rule
197
+ */
198
+ createEbsEncryptionRule(): ConfigRule {
199
+ return this.createConfigRule({
200
+ name: 'encrypted-volumes',
201
+ description: 'Checks whether EBS volumes are encrypted',
202
+ source: 'AWS_MANAGED',
203
+ identifier: 'ENCRYPTED_VOLUMES',
204
+ scope: {
205
+ complianceResourceTypes: ['AWS::EC2::Volume'],
206
+ },
207
+ })
208
+ }
209
+
210
+ /**
211
+ * Create IAM password policy rule
212
+ */
213
+ createIamPasswordPolicyRule(): ConfigRule {
214
+ return this.createConfigRule({
215
+ name: 'iam-password-policy',
216
+ description: 'Checks whether the IAM password policy meets specified requirements',
217
+ source: 'AWS_MANAGED',
218
+ identifier: 'IAM_PASSWORD_POLICY',
219
+ inputParameters: {
220
+ RequireUppercaseCharacters: true,
221
+ RequireLowercaseCharacters: true,
222
+ RequireSymbols: true,
223
+ RequireNumbers: true,
224
+ MinimumPasswordLength: 14,
225
+ PasswordReusePrevention: 24,
226
+ MaxPasswordAge: 90,
227
+ },
228
+ })
229
+ }
230
+
231
+ /**
232
+ * Create IAM MFA rule
233
+ */
234
+ createIamMfaRule(): ConfigRule {
235
+ return this.createConfigRule({
236
+ name: 'iam-user-mfa-enabled',
237
+ description: 'Checks whether IAM users have MFA enabled',
238
+ source: 'AWS_MANAGED',
239
+ identifier: 'IAM_USER_MFA_ENABLED',
240
+ })
241
+ }
242
+
243
+ /**
244
+ * Create IAM root account MFA rule
245
+ */
246
+ createRootAccountMfaRule(): ConfigRule {
247
+ return this.createConfigRule({
248
+ name: 'root-account-mfa-enabled',
249
+ description: 'Checks whether the root account has MFA enabled',
250
+ source: 'AWS_MANAGED',
251
+ identifier: 'ROOT_ACCOUNT_MFA_ENABLED',
252
+ })
253
+ }
254
+
255
+ /**
256
+ * Create VPC flow logs rule
257
+ */
258
+ createVpcFlowLogsRule(): ConfigRule {
259
+ return this.createConfigRule({
260
+ name: 'vpc-flow-logs-enabled',
261
+ description: 'Checks whether VPC Flow Logs is enabled',
262
+ source: 'AWS_MANAGED',
263
+ identifier: 'VPC_FLOW_LOGS_ENABLED',
264
+ scope: {
265
+ complianceResourceTypes: ['AWS::EC2::VPC'],
266
+ },
267
+ })
268
+ }
269
+
270
+ /**
271
+ * Create CloudTrail enabled rule
272
+ */
273
+ createCloudTrailEnabledRule(): ConfigRule {
274
+ return this.createConfigRule({
275
+ name: 'cloudtrail-enabled',
276
+ description: 'Checks whether CloudTrail is enabled',
277
+ source: 'AWS_MANAGED',
278
+ identifier: 'CLOUD_TRAIL_ENABLED',
279
+ maxExecutionFrequency: 'TwentyFour_Hours',
280
+ })
281
+ }
282
+
283
+ /**
284
+ * Create CloudWatch alarm rule
285
+ */
286
+ createCloudWatchAlarmRule(): ConfigRule {
287
+ return this.createConfigRule({
288
+ name: 'cloudwatch-alarm-action-check',
289
+ description: 'Checks whether CloudWatch alarms have actions configured',
290
+ source: 'AWS_MANAGED',
291
+ identifier: 'CLOUDWATCH_ALARM_ACTION_CHECK',
292
+ inputParameters: {
293
+ alarmActionRequired: true,
294
+ insufficientDataActionRequired: false,
295
+ okActionRequired: false,
296
+ },
297
+ scope: {
298
+ complianceResourceTypes: ['AWS::CloudWatch::Alarm'],
299
+ },
300
+ })
301
+ }
302
+
303
+ /**
304
+ * Create custom Lambda rule
305
+ */
306
+ createCustomLambdaRule(options: {
307
+ name: string
308
+ description: string
309
+ lambdaFunctionArn: string
310
+ resourceTypes?: string[]
311
+ maxExecutionFrequency?: ConfigRule['maxExecutionFrequency']
312
+ inputParameters?: Record<string, any>
313
+ }): ConfigRule {
314
+ return this.createConfigRule({
315
+ name: options.name,
316
+ description: options.description,
317
+ source: 'CUSTOM_LAMBDA',
318
+ lambdaFunctionArn: options.lambdaFunctionArn,
319
+ scope: options.resourceTypes
320
+ ? {
321
+ complianceResourceTypes: options.resourceTypes,
322
+ }
323
+ : undefined,
324
+ maxExecutionFrequency: options.maxExecutionFrequency,
325
+ inputParameters: options.inputParameters,
326
+ })
327
+ }
328
+
329
+ /**
330
+ * Create compliance preset rules
331
+ */
332
+ createCompliancePreset(preset: 'hipaa' | 'pci-dss' | 'sox' | 'gdpr' | 'basic'): ConfigRule[] {
333
+ const rules: ConfigRule[] = []
334
+
335
+ switch (preset) {
336
+ case 'hipaa':
337
+ rules.push(
338
+ this.createS3EncryptionRule(),
339
+ this.createRdsEncryptionRule(),
340
+ this.createEbsEncryptionRule(),
341
+ this.createCloudTrailEnabledRule(),
342
+ this.createIamPasswordPolicyRule(),
343
+ this.createRdsBackupRule(7),
344
+ this.createVpcFlowLogsRule(),
345
+ )
346
+ break
347
+
348
+ case 'pci-dss':
349
+ rules.push(
350
+ this.createS3EncryptionRule(),
351
+ this.createS3PublicAccessBlockRule(),
352
+ this.createRdsEncryptionRule(),
353
+ this.createEbsEncryptionRule(),
354
+ this.createCloudTrailEnabledRule(),
355
+ this.createIamPasswordPolicyRule(),
356
+ this.createIamMfaRule(),
357
+ this.createRootAccountMfaRule(),
358
+ this.createVpcFlowLogsRule(),
359
+ )
360
+ break
361
+
362
+ case 'sox':
363
+ rules.push(
364
+ this.createS3VersioningRule(),
365
+ this.createCloudTrailEnabledRule(),
366
+ this.createRdsBackupRule(30),
367
+ this.createIamPasswordPolicyRule(),
368
+ )
369
+ break
370
+
371
+ case 'gdpr':
372
+ rules.push(
373
+ this.createS3EncryptionRule(),
374
+ this.createRdsEncryptionRule(),
375
+ this.createEbsEncryptionRule(),
376
+ this.createCloudTrailEnabledRule(),
377
+ this.createRdsSnapshotEncryptionRule(),
378
+ )
379
+ break
380
+
381
+ case 'basic':
382
+ rules.push(
383
+ this.createS3EncryptionRule(),
384
+ this.createS3PublicAccessBlockRule(),
385
+ this.createRdsEncryptionRule(),
386
+ this.createCloudTrailEnabledRule(),
387
+ this.createIamMfaRule(),
388
+ this.createRootAccountMfaRule(),
389
+ )
390
+ break
391
+ }
392
+
393
+ return rules
394
+ }
395
+
396
+ /**
397
+ * Get config rule
398
+ */
399
+ getConfigRule(id: string): ConfigRule | undefined {
400
+ return this.configRules.get(id)
401
+ }
402
+
403
+ /**
404
+ * List config rules
405
+ */
406
+ listConfigRules(): ConfigRule[] {
407
+ return Array.from(this.configRules.values())
408
+ }
409
+
410
+ /**
411
+ * Get config recorder
412
+ */
413
+ getConfigRecorder(name: string): ConfigRecorder | undefined {
414
+ return this.configRecorders.get(name)
415
+ }
416
+
417
+ /**
418
+ * List config recorders
419
+ */
420
+ listConfigRecorders(): ConfigRecorder[] {
421
+ return Array.from(this.configRecorders.values())
422
+ }
423
+
424
+ /**
425
+ * Get delivery channel
426
+ */
427
+ getDeliveryChannel(name: string): DeliveryChannel | undefined {
428
+ return this.deliveryChannels.get(name)
429
+ }
430
+
431
+ /**
432
+ * List delivery channels
433
+ */
434
+ listDeliveryChannels(): DeliveryChannel[] {
435
+ return Array.from(this.deliveryChannels.values())
436
+ }
437
+
438
+ /**
439
+ * Generate CloudFormation for config rule
440
+ */
441
+ generateConfigRuleCF(rule: ConfigRule): any {
442
+ const cfRule: any = {
443
+ Type: 'AWS::Config::ConfigRule',
444
+ Properties: {
445
+ ConfigRuleName: rule.name,
446
+ Description: rule.description,
447
+ Source: {
448
+ Owner: rule.source === 'AWS_MANAGED' ? 'AWS' : 'CUSTOM_LAMBDA',
449
+ },
450
+ },
451
+ }
452
+
453
+ if (rule.source === 'AWS_MANAGED' && rule.identifier) {
454
+ cfRule.Properties.Source.SourceIdentifier = rule.identifier
455
+ }
456
+
457
+ if (rule.source === 'CUSTOM_LAMBDA' && rule.lambdaFunctionArn) {
458
+ cfRule.Properties.Source.SourceIdentifier = rule.lambdaFunctionArn
459
+ cfRule.Properties.Source.SourceDetails = [
460
+ {
461
+ EventSource: 'aws.config',
462
+ MessageType: 'ConfigurationItemChangeNotification',
463
+ },
464
+ ]
465
+ }
466
+
467
+ if (rule.inputParameters) {
468
+ cfRule.Properties.InputParameters = JSON.stringify(rule.inputParameters)
469
+ }
470
+
471
+ if (rule.scope) {
472
+ cfRule.Properties.Scope = {}
473
+
474
+ if (rule.scope.complianceResourceTypes) {
475
+ cfRule.Properties.Scope.ComplianceResourceTypes = rule.scope.complianceResourceTypes
476
+ }
477
+
478
+ if (rule.scope.tagKey) {
479
+ cfRule.Properties.Scope.TagKey = rule.scope.tagKey
480
+ }
481
+
482
+ if (rule.scope.tagValue) {
483
+ cfRule.Properties.Scope.TagValue = rule.scope.tagValue
484
+ }
485
+ }
486
+
487
+ if (rule.maxExecutionFrequency) {
488
+ cfRule.Properties.MaximumExecutionFrequency = rule.maxExecutionFrequency
489
+ }
490
+
491
+ return cfRule
492
+ }
493
+
494
+ /**
495
+ * Generate CloudFormation for config recorder
496
+ */
497
+ generateConfigRecorderCF(recorder: ConfigRecorder): any {
498
+ return {
499
+ Type: 'AWS::Config::ConfigurationRecorder',
500
+ Properties: {
501
+ Name: recorder.name,
502
+ RoleArn: recorder.roleArn,
503
+ RecordingGroup: recorder.recordingGroup || {
504
+ AllSupported: true,
505
+ IncludeGlobalResourceTypes: true,
506
+ },
507
+ },
508
+ }
509
+ }
510
+
511
+ /**
512
+ * Generate CloudFormation for delivery channel
513
+ */
514
+ generateDeliveryChannelCF(channel: DeliveryChannel): any {
515
+ return {
516
+ Type: 'AWS::Config::DeliveryChannel',
517
+ Properties: {
518
+ Name: channel.name,
519
+ S3BucketName: channel.s3BucketName,
520
+ ...(channel.s3KeyPrefix && { S3KeyPrefix: channel.s3KeyPrefix }),
521
+ ...(channel.snsTopicArn && { SnsTopicARN: channel.snsTopicArn }),
522
+ ...(channel.configSnapshotDeliveryProperties && {
523
+ ConfigSnapshotDeliveryProperties: channel.configSnapshotDeliveryProperties,
524
+ }),
525
+ },
526
+ }
527
+ }
528
+
529
+ /**
530
+ * Clear all data
531
+ */
532
+ clear(): void {
533
+ this.configRules.clear()
534
+ this.configRecorders.clear()
535
+ this.deliveryChannels.clear()
536
+ this.ruleCounter = 0
537
+ }
538
+ }
539
+
540
+ /**
541
+ * Global AWS Config manager instance
542
+ */
543
+ export const awsConfigManager: AWSConfigManager = new AWSConfigManager()