@stacksjs/ts-cloud 0.1.3 → 0.1.6

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 (187) hide show
  1. package/README.md +98 -13
  2. package/dist/aws/acm.d.ts +129 -0
  3. package/dist/aws/application-autoscaling.d.ts +282 -0
  4. package/dist/aws/bedrock.d.ts +2292 -0
  5. package/dist/aws/client.d.ts +79 -0
  6. package/dist/aws/cloudformation.d.ts +105 -0
  7. package/dist/aws/cloudfront.d.ts +265 -0
  8. package/dist/aws/cloudwatch-logs.d.ts +48 -0
  9. package/dist/aws/comprehend.d.ts +505 -0
  10. package/dist/aws/connect.d.ts +377 -0
  11. package/dist/aws/deploy-imap.d.ts +14 -0
  12. package/dist/aws/dynamodb.d.ts +176 -0
  13. package/dist/aws/ec2.d.ts +272 -0
  14. package/dist/aws/ecr.d.ts +149 -0
  15. package/dist/aws/ecs.d.ts +162 -0
  16. package/dist/aws/elasticache.d.ts +71 -0
  17. package/dist/aws/elbv2.d.ts +248 -0
  18. package/dist/aws/email.d.ts +175 -0
  19. package/dist/aws/eventbridge.d.ts +142 -0
  20. package/dist/aws/iam.d.ts +638 -0
  21. package/dist/aws/imap-server.d.ts +119 -0
  22. package/{src/aws/index.ts → dist/aws/index.d.ts} +62 -83
  23. package/{src/aws/kendra.ts → dist/aws/kendra.d.ts} +71 -386
  24. package/dist/aws/lambda.d.ts +232 -0
  25. package/dist/aws/opensearch.d.ts +87 -0
  26. package/dist/aws/personalize.d.ts +516 -0
  27. package/dist/aws/polly.d.ts +214 -0
  28. package/dist/aws/rds.d.ts +240 -0
  29. package/dist/aws/rekognition.d.ts +543 -0
  30. package/dist/aws/route53-domains.d.ts +113 -0
  31. package/dist/aws/route53.d.ts +215 -0
  32. package/dist/aws/s3.d.ts +212 -0
  33. package/dist/aws/scheduler.d.ts +140 -0
  34. package/dist/aws/secrets-manager.d.ts +170 -0
  35. package/dist/aws/ses.d.ts +288 -0
  36. package/dist/aws/setup-phone.d.ts +0 -0
  37. package/dist/aws/setup-sms.d.ts +115 -0
  38. package/dist/aws/sms.d.ts +304 -0
  39. package/dist/aws/smtp-server.d.ts +61 -0
  40. package/dist/aws/sns.d.ts +117 -0
  41. package/dist/aws/sqs.d.ts +65 -0
  42. package/dist/aws/ssm.d.ts +179 -0
  43. package/dist/aws/sts.d.ts +15 -0
  44. package/dist/aws/support.d.ts +104 -0
  45. package/dist/aws/test-imap.d.ts +0 -0
  46. package/dist/aws/textract.d.ts +403 -0
  47. package/dist/aws/transcribe.d.ts +60 -0
  48. package/dist/aws/translate.d.ts +358 -0
  49. package/dist/aws/voice.d.ts +219 -0
  50. package/dist/bin/cli.js +1724 -0
  51. package/dist/config.d.ts +7 -0
  52. package/dist/deploy/index.d.ts +2 -0
  53. package/dist/deploy/static-site-external-dns.d.ts +51 -0
  54. package/dist/deploy/static-site.d.ts +71 -0
  55. package/dist/dns/cloudflare.d.ts +52 -0
  56. package/dist/dns/godaddy.d.ts +38 -0
  57. package/dist/dns/index.d.ts +45 -0
  58. package/dist/dns/porkbun.d.ts +18 -0
  59. package/dist/dns/route53-adapter.d.ts +38 -0
  60. package/{src/dns/types.ts → dist/dns/types.d.ts} +26 -63
  61. package/dist/dns/validator.d.ts +78 -0
  62. package/dist/generators/index.d.ts +1 -0
  63. package/dist/generators/infrastructure.d.ts +30 -0
  64. package/{src/index.ts → dist/index.d.ts} +70 -93
  65. package/dist/index.js +7881 -0
  66. package/dist/push/apns.d.ts +60 -0
  67. package/dist/push/fcm.d.ts +117 -0
  68. package/dist/push/index.d.ts +14 -0
  69. package/dist/security/pre-deploy-scanner.d.ts +69 -0
  70. package/dist/ssl/acme-client.d.ts +67 -0
  71. package/dist/ssl/index.d.ts +2 -0
  72. package/dist/ssl/letsencrypt.d.ts +48 -0
  73. package/dist/types.d.ts +1 -0
  74. package/dist/utils/cli.d.ts +123 -0
  75. package/dist/validation/index.d.ts +1 -0
  76. package/dist/validation/template.d.ts +23 -0
  77. package/package.json +8 -8
  78. package/bin/cli.ts +0 -133
  79. package/bin/commands/analytics.ts +0 -328
  80. package/bin/commands/api.ts +0 -379
  81. package/bin/commands/assets.ts +0 -221
  82. package/bin/commands/audit.ts +0 -501
  83. package/bin/commands/backup.ts +0 -682
  84. package/bin/commands/cache.ts +0 -294
  85. package/bin/commands/cdn.ts +0 -281
  86. package/bin/commands/config.ts +0 -202
  87. package/bin/commands/container.ts +0 -105
  88. package/bin/commands/cost.ts +0 -208
  89. package/bin/commands/database.ts +0 -401
  90. package/bin/commands/deploy.ts +0 -674
  91. package/bin/commands/domain.ts +0 -397
  92. package/bin/commands/email.ts +0 -423
  93. package/bin/commands/environment.ts +0 -285
  94. package/bin/commands/events.ts +0 -424
  95. package/bin/commands/firewall.ts +0 -145
  96. package/bin/commands/function.ts +0 -116
  97. package/bin/commands/generate.ts +0 -280
  98. package/bin/commands/git.ts +0 -139
  99. package/bin/commands/iam.ts +0 -464
  100. package/bin/commands/index.ts +0 -48
  101. package/bin/commands/init.ts +0 -120
  102. package/bin/commands/logs.ts +0 -148
  103. package/bin/commands/network.ts +0 -579
  104. package/bin/commands/notify.ts +0 -489
  105. package/bin/commands/queue.ts +0 -407
  106. package/bin/commands/scheduler.ts +0 -370
  107. package/bin/commands/secrets.ts +0 -54
  108. package/bin/commands/server.ts +0 -629
  109. package/bin/commands/shared.ts +0 -97
  110. package/bin/commands/ssl.ts +0 -138
  111. package/bin/commands/stack.ts +0 -325
  112. package/bin/commands/status.ts +0 -385
  113. package/bin/commands/storage.ts +0 -450
  114. package/bin/commands/team.ts +0 -96
  115. package/bin/commands/tunnel.ts +0 -489
  116. package/bin/commands/utils.ts +0 -202
  117. package/build.ts +0 -15
  118. package/cloud +0 -2
  119. package/src/aws/acm.ts +0 -768
  120. package/src/aws/application-autoscaling.ts +0 -845
  121. package/src/aws/bedrock.ts +0 -4074
  122. package/src/aws/client.ts +0 -878
  123. package/src/aws/cloudformation.ts +0 -896
  124. package/src/aws/cloudfront.ts +0 -1531
  125. package/src/aws/cloudwatch-logs.ts +0 -154
  126. package/src/aws/comprehend.ts +0 -839
  127. package/src/aws/connect.ts +0 -1056
  128. package/src/aws/deploy-imap.ts +0 -384
  129. package/src/aws/dynamodb.ts +0 -340
  130. package/src/aws/ec2.ts +0 -1385
  131. package/src/aws/ecr.ts +0 -621
  132. package/src/aws/ecs.ts +0 -615
  133. package/src/aws/elasticache.ts +0 -301
  134. package/src/aws/elbv2.ts +0 -942
  135. package/src/aws/email.ts +0 -928
  136. package/src/aws/eventbridge.ts +0 -248
  137. package/src/aws/iam.ts +0 -1689
  138. package/src/aws/imap-server.ts +0 -2100
  139. package/src/aws/lambda.ts +0 -786
  140. package/src/aws/opensearch.ts +0 -158
  141. package/src/aws/personalize.ts +0 -977
  142. package/src/aws/polly.ts +0 -559
  143. package/src/aws/rds.ts +0 -888
  144. package/src/aws/rekognition.ts +0 -846
  145. package/src/aws/route53-domains.ts +0 -359
  146. package/src/aws/route53.ts +0 -1046
  147. package/src/aws/s3.ts +0 -2318
  148. package/src/aws/scheduler.ts +0 -571
  149. package/src/aws/secrets-manager.ts +0 -769
  150. package/src/aws/ses.ts +0 -1081
  151. package/src/aws/setup-phone.ts +0 -104
  152. package/src/aws/setup-sms.ts +0 -580
  153. package/src/aws/sms.ts +0 -1735
  154. package/src/aws/smtp-server.ts +0 -531
  155. package/src/aws/sns.ts +0 -758
  156. package/src/aws/sqs.ts +0 -382
  157. package/src/aws/ssm.ts +0 -807
  158. package/src/aws/sts.ts +0 -92
  159. package/src/aws/support.ts +0 -391
  160. package/src/aws/test-imap.ts +0 -86
  161. package/src/aws/textract.ts +0 -780
  162. package/src/aws/transcribe.ts +0 -108
  163. package/src/aws/translate.ts +0 -641
  164. package/src/aws/voice.ts +0 -1379
  165. package/src/config.ts +0 -35
  166. package/src/deploy/index.ts +0 -7
  167. package/src/deploy/static-site-external-dns.ts +0 -906
  168. package/src/deploy/static-site.ts +0 -1125
  169. package/src/dns/godaddy.ts +0 -412
  170. package/src/dns/index.ts +0 -183
  171. package/src/dns/porkbun.ts +0 -362
  172. package/src/dns/route53-adapter.ts +0 -414
  173. package/src/dns/validator.ts +0 -369
  174. package/src/generators/index.ts +0 -5
  175. package/src/generators/infrastructure.ts +0 -1660
  176. package/src/push/apns.ts +0 -452
  177. package/src/push/fcm.ts +0 -506
  178. package/src/push/index.ts +0 -58
  179. package/src/ssl/acme-client.ts +0 -478
  180. package/src/ssl/index.ts +0 -7
  181. package/src/ssl/letsencrypt.ts +0 -747
  182. package/src/types.ts +0 -2
  183. package/src/utils/cli.ts +0 -398
  184. package/src/validation/index.ts +0 -5
  185. package/src/validation/template.ts +0 -405
  186. package/test/index.test.ts +0 -128
  187. package/tsconfig.json +0 -18
@@ -1,682 +0,0 @@
1
- import type { CLI } from '@stacksjs/clapp'
2
- import * as cli from '../../src/utils/cli'
3
- import { loadValidatedConfig } from './shared'
4
-
5
- // AWS Backup client
6
- async function getBackupClient(region: string) {
7
- const { AWSClient } = await import('../../src/aws/client')
8
-
9
- class BackupClient {
10
- private client: InstanceType<typeof AWSClient>
11
- private region: string
12
-
13
- constructor(region: string) {
14
- this.region = region
15
- this.client = new AWSClient()
16
- }
17
-
18
- private async jsonRpcRequest(action: string, params: Record<string, any>): Promise<any> {
19
- return this.client.request({
20
- service: 'backup',
21
- region: this.region,
22
- method: 'POST',
23
- path: '/',
24
- headers: {
25
- 'Content-Type': 'application/x-amz-json-1.1',
26
- 'X-Amz-Target': `CryoControllerFrontendService.${action}`,
27
- },
28
- body: JSON.stringify(params),
29
- })
30
- }
31
-
32
- async listBackupVaults() {
33
- return this.jsonRpcRequest('ListBackupVaults', {})
34
- }
35
-
36
- async listBackupPlans() {
37
- return this.jsonRpcRequest('ListBackupPlans', {})
38
- }
39
-
40
- async listRecoveryPointsByBackupVault(vaultName: string, params?: { MaxResults?: number }) {
41
- return this.jsonRpcRequest('ListRecoveryPointsByBackupVault', {
42
- BackupVaultName: vaultName,
43
- ...params,
44
- })
45
- }
46
-
47
- async describeBackupVault(vaultName: string) {
48
- return this.jsonRpcRequest('DescribeBackupVault', { BackupVaultName: vaultName })
49
- }
50
-
51
- async getBackupPlan(planId: string) {
52
- return this.jsonRpcRequest('GetBackupPlan', { BackupPlanId: planId })
53
- }
54
-
55
- async createBackupVault(vaultName: string, params?: { EncryptionKeyArn?: string }) {
56
- return this.jsonRpcRequest('CreateBackupVault', {
57
- BackupVaultName: vaultName,
58
- ...params,
59
- })
60
- }
61
-
62
- async deleteBackupVault(vaultName: string) {
63
- return this.jsonRpcRequest('DeleteBackupVault', { BackupVaultName: vaultName })
64
- }
65
-
66
- async createBackupPlan(plan: any) {
67
- return this.jsonRpcRequest('CreateBackupPlan', { BackupPlan: plan })
68
- }
69
-
70
- async deleteBackupPlan(planId: string) {
71
- return this.jsonRpcRequest('DeleteBackupPlan', { BackupPlanId: planId })
72
- }
73
-
74
- async startBackupJob(params: {
75
- BackupVaultName: string
76
- ResourceArn: string
77
- IamRoleArn: string
78
- IdempotencyToken?: string
79
- }) {
80
- return this.jsonRpcRequest('StartBackupJob', params)
81
- }
82
-
83
- async startRestoreJob(params: {
84
- RecoveryPointArn: string
85
- IamRoleArn: string
86
- Metadata: Record<string, string>
87
- IdempotencyToken?: string
88
- }) {
89
- return this.jsonRpcRequest('StartRestoreJob', params)
90
- }
91
-
92
- async describeBackupJob(jobId: string) {
93
- return this.jsonRpcRequest('DescribeBackupJob', { BackupJobId: jobId })
94
- }
95
-
96
- async describeRestoreJob(jobId: string) {
97
- return this.jsonRpcRequest('DescribeRestoreJob', { RestoreJobId: jobId })
98
- }
99
-
100
- async listBackupJobs(params?: { ByState?: string; MaxResults?: number }) {
101
- return this.jsonRpcRequest('ListBackupJobs', params || {})
102
- }
103
-
104
- async listRestoreJobs(params?: { ByStatus?: string; MaxResults?: number }) {
105
- return this.jsonRpcRequest('ListRestoreJobs', params || {})
106
- }
107
-
108
- async createBackupSelection(planId: string, selection: any) {
109
- return this.jsonRpcRequest('CreateBackupSelection', {
110
- BackupPlanId: planId,
111
- BackupSelection: selection,
112
- })
113
- }
114
-
115
- async listBackupSelections(planId: string) {
116
- return this.jsonRpcRequest('ListBackupSelections', { BackupPlanId: planId })
117
- }
118
- }
119
-
120
- return new BackupClient(region)
121
- }
122
-
123
- export function registerBackupCommands(app: CLI): void {
124
- app
125
- .command('backup:vaults', 'List backup vaults')
126
- .option('--region <region>', 'AWS region')
127
- .action(async (options: { region?: string }) => {
128
- cli.header('Backup Vaults')
129
-
130
- try {
131
- const config = await loadValidatedConfig()
132
- const region = options.region || config.project.region || 'us-east-1'
133
- const backup = await getBackupClient(region)
134
-
135
- const spinner = new cli.Spinner('Fetching vaults...')
136
- spinner.start()
137
-
138
- const result = await backup.listBackupVaults()
139
- const vaults = result.BackupVaultList || []
140
-
141
- spinner.succeed(`Found ${vaults.length} vault(s)`)
142
-
143
- if (vaults.length === 0) {
144
- cli.info('No backup vaults found')
145
- cli.info('Use `cloud backup:create-vault` to create a new vault')
146
- return
147
- }
148
-
149
- cli.table(
150
- ['Vault Name', 'Recovery Points', 'Created', 'Encrypted'],
151
- vaults.map((vault: any) => [
152
- vault.BackupVaultName || 'N/A',
153
- (vault.NumberOfRecoveryPoints || 0).toString(),
154
- vault.CreationDate ? new Date(vault.CreationDate).toLocaleDateString() : 'N/A',
155
- vault.EncryptionKeyArn ? 'Yes' : 'Default',
156
- ]),
157
- )
158
- }
159
- catch (error: any) {
160
- cli.error(`Failed to list vaults: ${error.message}`)
161
- process.exit(1)
162
- }
163
- })
164
-
165
- app
166
- .command('backup:list', 'List backup plans')
167
- .option('--region <region>', 'AWS region')
168
- .action(async (options: { region?: string }) => {
169
- cli.header('Backup Plans')
170
-
171
- try {
172
- const config = await loadValidatedConfig()
173
- const region = options.region || config.project.region || 'us-east-1'
174
- const backup = await getBackupClient(region)
175
-
176
- const spinner = new cli.Spinner('Fetching backup plans...')
177
- spinner.start()
178
-
179
- const result = await backup.listBackupPlans()
180
- const plans = result.BackupPlansList || []
181
-
182
- spinner.succeed(`Found ${plans.length} backup plan(s)`)
183
-
184
- if (plans.length === 0) {
185
- cli.info('No backup plans found')
186
- cli.info('Use `cloud backup:create` to create a backup plan')
187
- return
188
- }
189
-
190
- cli.table(
191
- ['Plan Name', 'Plan ID', 'Version', 'Created'],
192
- plans.map((plan: any) => [
193
- plan.BackupPlanName || 'N/A',
194
- plan.BackupPlanId || 'N/A',
195
- plan.VersionId?.substring(0, 8) || 'N/A',
196
- plan.CreationDate ? new Date(plan.CreationDate).toLocaleDateString() : 'N/A',
197
- ]),
198
- )
199
- }
200
- catch (error: any) {
201
- cli.error(`Failed to list backup plans: ${error.message}`)
202
- process.exit(1)
203
- }
204
- })
205
-
206
- app
207
- .command('backup:recovery-points <vaultName>', 'List recovery points in a vault')
208
- .option('--region <region>', 'AWS region')
209
- .option('--limit <number>', 'Maximum results', { default: '50' })
210
- .action(async (vaultName: string, options: { region?: string; limit: string }) => {
211
- cli.header(`Recovery Points: ${vaultName}`)
212
-
213
- try {
214
- const config = await loadValidatedConfig()
215
- const region = options.region || config.project.region || 'us-east-1'
216
- const backup = await getBackupClient(region)
217
-
218
- const spinner = new cli.Spinner('Fetching recovery points...')
219
- spinner.start()
220
-
221
- const result = await backup.listRecoveryPointsByBackupVault(vaultName, {
222
- MaxResults: Number.parseInt(options.limit),
223
- })
224
-
225
- const points = result.RecoveryPoints || []
226
-
227
- spinner.succeed(`Found ${points.length} recovery point(s)`)
228
-
229
- if (points.length === 0) {
230
- cli.info('No recovery points found')
231
- return
232
- }
233
-
234
- cli.table(
235
- ['Resource', 'Status', 'Created', 'Size', 'Lifecycle'],
236
- points.map((point: any) => [
237
- point.ResourceArn?.split(':').pop() || 'N/A',
238
- point.Status || 'N/A',
239
- point.CreationDate ? new Date(point.CreationDate).toLocaleString() : 'N/A',
240
- point.BackupSizeInBytes ? formatBytes(point.BackupSizeInBytes) : 'N/A',
241
- point.Lifecycle?.DeleteAfterDays ? `${point.Lifecycle.DeleteAfterDays} days` : 'Indefinite',
242
- ]),
243
- )
244
- }
245
- catch (error: any) {
246
- cli.error(`Failed to list recovery points: ${error.message}`)
247
- process.exit(1)
248
- }
249
- })
250
-
251
- app
252
- .command('backup:create-vault <vaultName>', 'Create a backup vault')
253
- .option('--region <region>', 'AWS region', { default: 'us-east-1' })
254
- .option('--kms-key <arn>', 'KMS key ARN for encryption')
255
- .action(async (vaultName: string, options: { region: string; kmsKey?: string }) => {
256
- cli.header('Create Backup Vault')
257
-
258
- try {
259
- const backup = await getBackupClient(options.region)
260
-
261
- cli.info(`Vault Name: ${vaultName}`)
262
- cli.info(`Region: ${options.region}`)
263
- cli.info(`Encryption: ${options.kmsKey ? 'Custom KMS' : 'AWS Managed'}`)
264
-
265
- const confirmed = await cli.confirm('\nCreate this vault?', true)
266
- if (!confirmed) {
267
- cli.info('Operation cancelled')
268
- return
269
- }
270
-
271
- const spinner = new cli.Spinner('Creating vault...')
272
- spinner.start()
273
-
274
- await backup.createBackupVault(vaultName, {
275
- EncryptionKeyArn: options.kmsKey,
276
- })
277
-
278
- spinner.succeed('Vault created')
279
-
280
- cli.success(`\nVault: ${vaultName}`)
281
- }
282
- catch (error: any) {
283
- cli.error(`Failed to create vault: ${error.message}`)
284
- process.exit(1)
285
- }
286
- })
287
-
288
- app
289
- .command('backup:create <planName>', 'Create a backup plan')
290
- .option('--region <region>', 'AWS region', { default: 'us-east-1' })
291
- .option('--vault <name>', 'Target backup vault', { default: 'Default' })
292
- .option('--schedule <cron>', 'Backup schedule (cron expression)', { default: 'cron(0 5 ? * * *)' })
293
- .option('--retention <days>', 'Retention period in days', { default: '30' })
294
- .option('--lifecycle-cold <days>', 'Move to cold storage after days')
295
- .action(async (planName: string, options: {
296
- region: string
297
- vault: string
298
- schedule: string
299
- retention: string
300
- lifecycleCold?: string
301
- }) => {
302
- cli.header('Create Backup Plan')
303
-
304
- try {
305
- const backup = await getBackupClient(options.region)
306
-
307
- cli.info(`Plan Name: ${planName}`)
308
- cli.info(`Vault: ${options.vault}`)
309
- cli.info(`Schedule: ${options.schedule}`)
310
- cli.info(`Retention: ${options.retention} days`)
311
-
312
- const confirmed = await cli.confirm('\nCreate this backup plan?', true)
313
- if (!confirmed) {
314
- cli.info('Operation cancelled')
315
- return
316
- }
317
-
318
- const spinner = new cli.Spinner('Creating backup plan...')
319
- spinner.start()
320
-
321
- const lifecycle: any = {
322
- DeleteAfterDays: Number.parseInt(options.retention),
323
- }
324
-
325
- if (options.lifecycleCold) {
326
- lifecycle.MoveToColdStorageAfterDays = Number.parseInt(options.lifecycleCold)
327
- }
328
-
329
- const result = await backup.createBackupPlan({
330
- BackupPlanName: planName,
331
- Rules: [
332
- {
333
- RuleName: `${planName}-daily`,
334
- TargetBackupVaultName: options.vault,
335
- ScheduleExpression: options.schedule,
336
- StartWindowMinutes: 60,
337
- CompletionWindowMinutes: 180,
338
- Lifecycle: lifecycle,
339
- },
340
- ],
341
- })
342
-
343
- spinner.succeed('Backup plan created')
344
-
345
- cli.success(`\nPlan ID: ${result.BackupPlanId}`)
346
- cli.info('\nNote: Add resource selections with `cloud backup:add-selection`')
347
- }
348
- catch (error: any) {
349
- cli.error(`Failed to create backup plan: ${error.message}`)
350
- process.exit(1)
351
- }
352
- })
353
-
354
- app
355
- .command('backup:add-selection <planId>', 'Add resources to a backup plan')
356
- .option('--region <region>', 'AWS region', { default: 'us-east-1' })
357
- .option('--name <name>', 'Selection name')
358
- .option('--role <arn>', 'IAM role ARN for backup')
359
- .option('--resource <arn>', 'Resource ARN to backup')
360
- .option('--tag-key <key>', 'Tag key for resource selection')
361
- .option('--tag-value <value>', 'Tag value for resource selection')
362
- .action(async (planId: string, options: {
363
- region: string
364
- name?: string
365
- role?: string
366
- resource?: string
367
- tagKey?: string
368
- tagValue?: string
369
- }) => {
370
- cli.header('Add Backup Selection')
371
-
372
- try {
373
- if (!options.role) {
374
- cli.error('--role is required (IAM role ARN for AWS Backup)')
375
- return
376
- }
377
-
378
- if (!options.resource && !options.tagKey) {
379
- cli.error('Specify --resource or --tag-key/--tag-value')
380
- return
381
- }
382
-
383
- const backup = await getBackupClient(options.region)
384
-
385
- const selectionName = options.name || `selection-${Date.now()}`
386
-
387
- const selection: any = {
388
- SelectionName: selectionName,
389
- IamRoleArn: options.role,
390
- }
391
-
392
- if (options.resource) {
393
- selection.Resources = [options.resource]
394
- cli.info(`Resource: ${options.resource}`)
395
- }
396
-
397
- if (options.tagKey && options.tagValue) {
398
- selection.ListOfTags = [{
399
- ConditionType: 'STRINGEQUALS',
400
- ConditionKey: options.tagKey,
401
- ConditionValue: options.tagValue,
402
- }]
403
- cli.info(`Tag: ${options.tagKey}=${options.tagValue}`)
404
- }
405
-
406
- const confirmed = await cli.confirm('\nAdd this selection?', true)
407
- if (!confirmed) {
408
- cli.info('Operation cancelled')
409
- return
410
- }
411
-
412
- const spinner = new cli.Spinner('Adding selection...')
413
- spinner.start()
414
-
415
- const result = await backup.createBackupSelection(planId, selection)
416
-
417
- spinner.succeed('Selection added')
418
-
419
- cli.success(`\nSelection ID: ${result.SelectionId}`)
420
- }
421
- catch (error: any) {
422
- cli.error(`Failed to add selection: ${error.message}`)
423
- process.exit(1)
424
- }
425
- })
426
-
427
- app
428
- .command('backup:start <resourceArn>', 'Start an on-demand backup')
429
- .option('--region <region>', 'AWS region', { default: 'us-east-1' })
430
- .option('--vault <name>', 'Backup vault name', { default: 'Default' })
431
- .option('--role <arn>', 'IAM role ARN for backup')
432
- .action(async (resourceArn: string, options: { region: string; vault: string; role?: string }) => {
433
- cli.header('Start Backup Job')
434
-
435
- try {
436
- if (!options.role) {
437
- cli.error('--role is required (IAM role ARN for AWS Backup)')
438
- return
439
- }
440
-
441
- const backup = await getBackupClient(options.region)
442
-
443
- cli.info(`Resource: ${resourceArn}`)
444
- cli.info(`Vault: ${options.vault}`)
445
-
446
- const confirmed = await cli.confirm('\nStart backup?', true)
447
- if (!confirmed) {
448
- cli.info('Operation cancelled')
449
- return
450
- }
451
-
452
- const spinner = new cli.Spinner('Starting backup job...')
453
- spinner.start()
454
-
455
- const result = await backup.startBackupJob({
456
- BackupVaultName: options.vault,
457
- ResourceArn: resourceArn,
458
- IamRoleArn: options.role,
459
- IdempotencyToken: `cli-${Date.now()}`,
460
- })
461
-
462
- spinner.succeed('Backup job started')
463
-
464
- cli.success(`\nJob ID: ${result.BackupJobId}`)
465
- cli.info('Use `cloud backup:jobs` to check status')
466
- }
467
- catch (error: any) {
468
- cli.error(`Failed to start backup: ${error.message}`)
469
- process.exit(1)
470
- }
471
- })
472
-
473
- app
474
- .command('backup:restore <recoveryPointArn>', 'Start a restore job')
475
- .option('--region <region>', 'AWS region', { default: 'us-east-1' })
476
- .option('--role <arn>', 'IAM role ARN for restore')
477
- .option('--metadata <json>', 'Restore metadata JSON')
478
- .action(async (recoveryPointArn: string, options: { region: string; role?: string; metadata?: string }) => {
479
- cli.header('Start Restore Job')
480
-
481
- try {
482
- if (!options.role) {
483
- cli.error('--role is required (IAM role ARN for AWS Backup)')
484
- return
485
- }
486
-
487
- const backup = await getBackupClient(options.region)
488
-
489
- cli.info(`Recovery Point: ${recoveryPointArn}`)
490
-
491
- let metadata: Record<string, string> = {}
492
- if (options.metadata) {
493
- metadata = JSON.parse(options.metadata)
494
- }
495
-
496
- cli.warn('\nRestore will create new resources. Review carefully.')
497
-
498
- const confirmed = await cli.confirm('\nStart restore?', false)
499
- if (!confirmed) {
500
- cli.info('Operation cancelled')
501
- return
502
- }
503
-
504
- const spinner = new cli.Spinner('Starting restore job...')
505
- spinner.start()
506
-
507
- const result = await backup.startRestoreJob({
508
- RecoveryPointArn: recoveryPointArn,
509
- IamRoleArn: options.role,
510
- Metadata: metadata,
511
- IdempotencyToken: `cli-${Date.now()}`,
512
- })
513
-
514
- spinner.succeed('Restore job started')
515
-
516
- cli.success(`\nJob ID: ${result.RestoreJobId}`)
517
- cli.info('Use `cloud backup:restore-jobs` to check status')
518
- }
519
- catch (error: any) {
520
- cli.error(`Failed to start restore: ${error.message}`)
521
- process.exit(1)
522
- }
523
- })
524
-
525
- app
526
- .command('backup:jobs', 'List recent backup jobs')
527
- .option('--region <region>', 'AWS region')
528
- .option('--state <state>', 'Filter by state (CREATED, PENDING, RUNNING, COMPLETED, FAILED)')
529
- .action(async (options: { region?: string; state?: string }) => {
530
- cli.header('Backup Jobs')
531
-
532
- try {
533
- const config = await loadValidatedConfig()
534
- const region = options.region || config.project.region || 'us-east-1'
535
- const backup = await getBackupClient(region)
536
-
537
- const spinner = new cli.Spinner('Fetching backup jobs...')
538
- spinner.start()
539
-
540
- const result = await backup.listBackupJobs({
541
- ByState: options.state,
542
- MaxResults: 50,
543
- })
544
-
545
- const jobs = result.BackupJobs || []
546
-
547
- spinner.succeed(`Found ${jobs.length} job(s)`)
548
-
549
- if (jobs.length === 0) {
550
- cli.info('No backup jobs found')
551
- return
552
- }
553
-
554
- cli.table(
555
- ['Job ID', 'Resource', 'State', 'Started', 'Size'],
556
- jobs.map((job: any) => [
557
- job.BackupJobId?.substring(0, 16) || 'N/A',
558
- job.ResourceArn?.split(':').pop() || 'N/A',
559
- job.State || 'N/A',
560
- job.CreationDate ? new Date(job.CreationDate).toLocaleString() : 'N/A',
561
- job.BackupSizeInBytes ? formatBytes(job.BackupSizeInBytes) : 'N/A',
562
- ]),
563
- )
564
- }
565
- catch (error: any) {
566
- cli.error(`Failed to list backup jobs: ${error.message}`)
567
- process.exit(1)
568
- }
569
- })
570
-
571
- app
572
- .command('backup:restore-jobs', 'List recent restore jobs')
573
- .option('--region <region>', 'AWS region')
574
- .option('--status <status>', 'Filter by status')
575
- .action(async (options: { region?: string; status?: string }) => {
576
- cli.header('Restore Jobs')
577
-
578
- try {
579
- const config = await loadValidatedConfig()
580
- const region = options.region || config.project.region || 'us-east-1'
581
- const backup = await getBackupClient(region)
582
-
583
- const spinner = new cli.Spinner('Fetching restore jobs...')
584
- spinner.start()
585
-
586
- const result = await backup.listRestoreJobs({
587
- ByStatus: options.status,
588
- MaxResults: 50,
589
- })
590
-
591
- const jobs = result.RestoreJobs || []
592
-
593
- spinner.succeed(`Found ${jobs.length} job(s)`)
594
-
595
- if (jobs.length === 0) {
596
- cli.info('No restore jobs found')
597
- return
598
- }
599
-
600
- cli.table(
601
- ['Job ID', 'Resource', 'Status', 'Started', 'Completed'],
602
- jobs.map((job: any) => [
603
- job.RestoreJobId?.substring(0, 16) || 'N/A',
604
- job.CreatedResourceArn?.split(':').pop() || 'Pending',
605
- job.Status || 'N/A',
606
- job.CreationDate ? new Date(job.CreationDate).toLocaleString() : 'N/A',
607
- job.CompletionDate ? new Date(job.CompletionDate).toLocaleString() : '-',
608
- ]),
609
- )
610
- }
611
- catch (error: any) {
612
- cli.error(`Failed to list restore jobs: ${error.message}`)
613
- process.exit(1)
614
- }
615
- })
616
-
617
- app
618
- .command('backup:schedule', 'Show backup schedule overview')
619
- .option('--region <region>', 'AWS region')
620
- .action(async (options: { region?: string }) => {
621
- cli.header('Backup Schedule Overview')
622
-
623
- try {
624
- const config = await loadValidatedConfig()
625
- const region = options.region || config.project.region || 'us-east-1'
626
- const backup = await getBackupClient(region)
627
-
628
- const spinner = new cli.Spinner('Fetching backup plans...')
629
- spinner.start()
630
-
631
- const plansResult = await backup.listBackupPlans()
632
- const plans = plansResult.BackupPlansList || []
633
-
634
- spinner.succeed(`Found ${plans.length} backup plan(s)`)
635
-
636
- if (plans.length === 0) {
637
- cli.info('No backup plans configured')
638
- return
639
- }
640
-
641
- for (const planSummary of plans) {
642
- cli.info(`\n${planSummary.BackupPlanName}`)
643
- cli.info('='.repeat(40))
644
-
645
- try {
646
- const plan = await backup.getBackupPlan(planSummary.BackupPlanId)
647
- const rules = plan.BackupPlan?.Rules || []
648
-
649
- for (const rule of rules) {
650
- cli.info(` Rule: ${rule.RuleName}`)
651
- cli.info(` Schedule: ${rule.ScheduleExpression}`)
652
- cli.info(` Vault: ${rule.TargetBackupVaultName}`)
653
- if (rule.Lifecycle?.DeleteAfterDays) {
654
- cli.info(` Retention: ${rule.Lifecycle.DeleteAfterDays} days`)
655
- }
656
- }
657
-
658
- // Get selections
659
- const selections = await backup.listBackupSelections(planSummary.BackupPlanId)
660
- if (selections.BackupSelectionsList && selections.BackupSelectionsList.length > 0) {
661
- cli.info(` Selections: ${selections.BackupSelectionsList.length}`)
662
- }
663
- }
664
- catch {
665
- cli.info(' (Unable to load plan details)')
666
- }
667
- }
668
- }
669
- catch (error: any) {
670
- cli.error(`Failed to get schedule: ${error.message}`)
671
- process.exit(1)
672
- }
673
- })
674
- }
675
-
676
- function formatBytes(bytes: number): string {
677
- if (bytes === 0) return '0 B'
678
- const k = 1024
679
- const sizes = ['B', 'KB', 'MB', 'GB', 'TB']
680
- const i = Math.floor(Math.log(bytes) / Math.log(k))
681
- return `${Number.parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`
682
- }