@stacksjs/ts-cloud 0.1.7 → 0.1.9

package/src/aws/setup-phone.ts

@@ -0,0 +1,104 @@
+import { ConnectClient } from './connect'
+
+const connect = new ConnectClient('us-east-1')
+const instanceId = '7deb6488-8555-4304-b893-d6c461449eda'
+
+async function main() {
+  // First, check which phone number we have
+  console.log('Checking claimed phone numbers...')
+  const phones = await connect.listPhoneNumbers({ InstanceId: instanceId })
+  console.log('Claimed phone numbers:')
+  for (const p of phones.ListPhoneNumbersSummaryList || []) {
+    console.log('  ', p.PhoneNumber, '(ID:', p.PhoneNumberId + ')')
+  }
+
+  // Use the first phone number
+  const phoneNumber = phones.ListPhoneNumbersSummaryList?.[0]
+  if (!phoneNumber) {
+    console.log('No phone numbers found!')
+    process.exit(1)
+  }
+
+  // Create a contact flow with the correct format for call forwarding
+  console.log('\nCreating contact flow with call forwarding...')
+
+  // Use the correct format for TransferToPhoneNumber
+  // According to AWS documentation, the action type is "TransferToPhoneNumber"
+  const forwardingFlow = {
+    Version: '2019-10-30',
+    StartAction: 'transfer-to-phone',
+    Metadata: {
+      entryPointPosition: { x: 40, y: 40 },
+      ActionMetadata: {
+        'transfer-to-phone': { position: { x: 190, y: 40 } },
+        'end-call': { position: { x: 440, y: 40 } },
+      },
+    },
+    Actions: [
+      {
+        Identifier: 'transfer-to-phone',
+        Type: 'TransferToPhoneNumber',
+        Parameters: {
+          PhoneNumber: '+18088218241',
+          ContactFlowId: '', // Will use instance default
+        },
+        Transitions: {
+          NextAction: 'end-call',
+          Errors: [
+            { ErrorType: 'NoMatchingError', NextAction: 'end-call' },
+            { ErrorType: 'CallFailed', NextAction: 'end-call' },
+            { ErrorType: 'ConnectionTimeLimitExceeded', NextAction: 'end-call' },
+          ],
+        },
+      },
+      {
+        Identifier: 'end-call',
+        Type: 'DisconnectParticipant',
+        Parameters: {},
+        Transitions: {},
+      },
+    ],
+  }
+
+  try {
+    const flowResult = await connect.createContactFlow({
+      InstanceId: instanceId,
+      Name: 'Stacks Call Forwarding',
+      Type: 'CONTACT_FLOW',
+      Content: JSON.stringify(forwardingFlow),
+      Description: 'Forwards all calls to +18088218241',
+    })
+    console.log('Contact flow created!')
+    console.log('Flow ID:', flowResult.ContactFlowId)
+    console.log('Flow ARN:', flowResult.ContactFlowArn)
+
+    // Associate the phone number with the contact flow
+    console.log('\nAssociating phone number with contact flow...')
+    await connect.associatePhoneNumberContactFlow({
+      PhoneNumberId: phoneNumber.PhoneNumberId!,
+      InstanceId: instanceId,
+      ContactFlowId: flowResult.ContactFlowId!,
+    })
+    console.log('Phone number associated with contact flow!')
+
+    // Format the phone number
+    const num = phoneNumber.PhoneNumber!
+    const formatted = `+1 (${num.slice(2, 5)}) ${num.slice(5, 8)}-${num.slice(8)}`
+
+    console.log('\n========================================')
+    console.log('  STACKS PHONE NUMBER IS READY!')
+    console.log('========================================')
+    console.log('')
+    console.log('  Call: ' + formatted)
+    console.log('  Raw:  ' + num)
+    console.log('  Forwards to: +1 (808) 821-8241')
+    console.log('  Hours: 11:30 AM - 8:00 PM PST')
+    console.log('')
+    console.log('========================================')
+  }
+  catch (e: any) {
+    console.log('Error:', e.message)
+  }
+}
+
+main()

package/src/aws/setup-sms.ts

@@ -0,0 +1,580 @@
+/**
+ * SMS Setup Automation Module
+ * Handles complete SMS infrastructure setup during deploy
+ *
+ * This module automates:
+ * - S3 inbox setup for incoming messages
+ * - SNS topics for two-way messaging
+ * - Spending limit management
+ * - Sandbox exit requests via AWS Support
+ * - Delivery receipt configuration
+ *
+ * Note: Phone number provisioning requires AWS End User Messaging console.
+ * SNS uses a shared pool for sending unless you configure an origination number.
+ */
+
+import { SNSClient } from './sns'
+import { S3Client } from './s3'
+import { IAMClient } from './iam'
+import { LambdaClient } from './lambda'
+import { SupportClient, SupportTemplates } from './support'
+import { AWSClient } from './client'
+
+export interface SmsSetupConfig {
+  region?: string
+  // Account identifier (used for naming resources)
+  accountName?: string
+  // AWS account ID
+  accountId?: string
+  // S3 inbox configuration
+  inbox?: {
+    enabled?: boolean
+    bucket?: string
+    prefix?: string
+    // Create lifecycle rules for retention
+    retentionDays?: number
+  }
+  // SNS topic for incoming SMS
+  twoWay?: {
+    enabled?: boolean
+    topicName?: string
+  }
+  // Spending configuration
+  spending?: {
+    monthlyLimit?: number
+    // Auto-request increase via AWS Support
+    autoRequestIncrease?: boolean
+  }
+  // Sandbox configuration
+  sandbox?: {
+    // Auto-request sandbox exit via AWS Support
+    autoRequestExit?: boolean
+    // Company details for support ticket
+    companyName?: string
+    // Use case description for support ticket
+    useCase?: string
+    // Expected monthly SMS volume
+    expectedMonthlyVolume?: number
+    // Website URL
+    websiteUrl?: string
+  }
+  // Delivery receipts
+  deliveryReceipts?: {
+    enabled?: boolean
+    // SNS topic for delivery receipts
+    topicName?: string
+    // Store receipts in S3
+    s3Bucket?: string
+    s3Prefix?: string
+  }
+  // Lambda function for processing incoming SMS
+  inboxLambda?: {
+    enabled?: boolean
+    functionName?: string
+    // Code location (for creating new Lambda)
+    codeS3Bucket?: string
+    codeS3Key?: string
+  }
+}
+
+export interface SmsSetupResult {
+  success: boolean
+  inboxBucket?: string
+  inboxPrefix?: string
+  twoWayTopicArn?: string
+  deliveryReceiptTopicArn?: string
+  inboxLambdaArn?: string
+  spendingLimit?: number
+  sandboxStatus?: 'IN_SANDBOX' | 'OUT_OF_SANDBOX' | 'EXIT_REQUESTED'
+  supportCaseId?: string
+  errors: string[]
+  warnings: string[]
+}
+
+/**
+ * Set up complete SMS infrastructure
+ * Called automatically during `buddy deploy` when SMS is enabled
+ */
+export async function setupSmsInfrastructure(config: SmsSetupConfig): Promise<SmsSetupResult> {
+  const region = config.region || 'us-east-1'
+  const result: SmsSetupResult = {
+    success: true,
+    errors: [],
+    warnings: [],
+  }
+
+  const sns = new SNSClient(region)
+  const s3 = new S3Client(region)
+  const support = new SupportClient(region)
+  const awsClient = new AWSClient()
+
+  console.log('Setting up SMS infrastructure...')
+
+  // 1. Check current SMS status
+  console.log('  Checking SMS account status...')
+  try {
+    const accountStatus = await checkSmsAccountStatus(sns)
+    result.sandboxStatus = accountStatus.inSandbox ? 'IN_SANDBOX' : 'OUT_OF_SANDBOX'
+
+    if (accountStatus.inSandbox) {
+      console.log('  Account is in SMS sandbox')
+
+      // Auto-request sandbox exit if configured
+      if (config.sandbox?.autoRequestExit && config.sandbox.companyName) {
+        console.log('  Requesting SMS sandbox exit via AWS Support...')
+        try {
+          const caseParams = SupportTemplates.smsSandboxExit({
+            companyName: config.sandbox.companyName,
+            useCase: config.sandbox.useCase || 'Transactional notifications and verification codes',
+            expectedMonthlyVolume: config.sandbox.expectedMonthlyVolume || 1000,
+            websiteUrl: config.sandbox.websiteUrl,
+          })
+          const caseResult = await support.createCase(caseParams)
+          result.supportCaseId = caseResult.caseId
+          result.sandboxStatus = 'EXIT_REQUESTED'
+          console.log(`  Support case created: ${caseResult.caseId}`)
+        } catch (err: any) {
+          result.warnings.push(`Failed to create sandbox exit support case: ${err.message}`)
+          console.log(`  Warning: Could not create support case: ${err.message}`)
+        }
+      }
+    }
+
+    // Check spending limit
+    result.spendingLimit = accountStatus.spendingLimit
+    console.log(`  Current spending limit: $${accountStatus.spendingLimit}/month`)
+
+    // Request spending limit increase if needed
+    if (
+      config.spending?.autoRequestIncrease &&
+      config.spending.monthlyLimit &&
+      accountStatus.spendingLimit < config.spending.monthlyLimit
+    ) {
+      console.log(`  Requesting spending limit increase to $${config.spending.monthlyLimit}/month...`)
+      try {
+        // Try to set it directly via SNS attributes
+        await setSnsSpendingLimit(awsClient, region, config.spending.monthlyLimit)
+        result.spendingLimit = config.spending.monthlyLimit
+        console.log('  Spending limit updated successfully')
+      } catch (err: any) {
+        // If direct update fails, file a support ticket
+        if (config.sandbox?.companyName) {
+          try {
+            const caseParams = SupportTemplates.smsSpendLimitIncrease({
+              companyName: config.sandbox.companyName,
+              currentLimit: accountStatus.spendingLimit,
+              requestedLimit: config.spending.monthlyLimit,
+              useCase: config.sandbox.useCase || 'Production SMS messaging',
+            })
+            const caseResult = await support.createCase(caseParams)
+            result.supportCaseId = caseResult.caseId
+            result.warnings.push(`Spending limit increase requested via support case: ${caseResult.caseId}`)
+            console.log(`  Support case created for limit increase: ${caseResult.caseId}`)
+          } catch (supportErr: any) {
+            result.warnings.push(`Failed to request spending limit increase: ${supportErr.message}`)
+          }
+        } else {
+          result.warnings.push('Spending limit increase requires AWS Support ticket. Provide companyName in config.')
+        }
+      }
+    }
+  } catch (err: any) {
+    result.errors.push(`Failed to check SMS account status: ${err.message}`)
+    console.log(`  Error checking status: ${err.message}`)
+  }
+
+  // 2. Set up S3 inbox
+  if (config.inbox?.enabled && config.inbox.bucket) {
+    console.log('  Setting up S3 inbox...')
+    try {
+      await setupS3Inbox(s3, {
+        bucket: config.inbox.bucket,
+        prefix: config.inbox.prefix || 'sms/inbox/',
+        retentionDays: config.inbox.retentionDays,
+      })
+      result.inboxBucket = config.inbox.bucket
+      result.inboxPrefix = config.inbox.prefix || 'sms/inbox/'
+      console.log(`  Inbox configured: s3://${config.inbox.bucket}/${result.inboxPrefix}`)
+    } catch (err: any) {
+      result.errors.push(`Failed to set up S3 inbox: ${err.message}`)
+      console.log(`  Error setting up inbox: ${err.message}`)
+    }
+  }
+
+  // 3. Set up SNS topic for two-way SMS
+  if (config.twoWay?.enabled) {
+    console.log('  Setting up two-way SMS...')
+    try {
+      const topicName = config.twoWay.topicName || `${config.accountName || 'stacks'}-sms-inbox`
+      const topicArn = await setupTwoWayTopic(sns, awsClient, region, topicName, config.accountId)
+      result.twoWayTopicArn = topicArn
+      console.log(`  Two-way topic: ${topicArn}`)
+    } catch (err: any) {
+      result.errors.push(`Failed to set up two-way SMS topic: ${err.message}`)
+      console.log(`  Error setting up two-way: ${err.message}`)
+    }
+  }
+
+  // 4. Set up delivery receipts topic
+  if (config.deliveryReceipts?.enabled) {
+    console.log('  Setting up delivery receipts...')
+    try {
+      const topicName = config.deliveryReceipts.topicName || `${config.accountName || 'stacks'}-sms-delivery-receipts`
+      const topicArn = await setupDeliveryReceiptsTopic(sns, awsClient, region, topicName, config.accountId)
+      result.deliveryReceiptTopicArn = topicArn
+      console.log(`  Delivery receipts topic: ${topicArn}`)
+    } catch (err: any) {
+      result.errors.push(`Failed to set up delivery receipts: ${err.message}`)
+      console.log(`  Error setting up delivery receipts: ${err.message}`)
+    }
+  }
+
+  // Final status
+  result.success = result.errors.length === 0
+  console.log(result.success ? '  SMS setup completed successfully!' : '  SMS setup completed with errors')
+
+  // Note about phone numbers
+  if (result.success) {
+    result.warnings.push(
+      'For dedicated phone numbers, use AWS End User Messaging console. SNS uses shared pool by default.',
+    )
+  }
+
+  return result
+}
+
+/**
+ * Check SMS account status (sandbox, spending limits)
+ */
+async function checkSmsAccountStatus(sns: SNSClient): Promise<{
+  inSandbox: boolean
+  spendingLimit: number
+  usedThisMonth: number
+}> {
+  let inSandbox = true
+  let spendingLimit = 1
+  let usedThisMonth = 0
+
+  // Check SNS sandbox status
+  try {
+    const sandboxStatus = await sns.getSMSSandboxAccountStatus()
+    inSandbox = sandboxStatus.IsInSandbox
+  } catch {
+    // Assume sandbox if we can't check
+    inSandbox = true
+  }
+
+  // Get spending quota from SNS attributes
+  try {
+    const smsAttrs = await sns.getSMSAttributes()
+    if (smsAttrs.MonthlySpendLimit) {
+      spendingLimit = parseFloat(smsAttrs.MonthlySpendLimit)
+    }
+  } catch {
+    // Ignore
+  }
+
+  return { inSandbox, spendingLimit, usedThisMonth }
+}
+
+/**
+ * Set SNS SMS spending limit
+ */
+async function setSnsSpendingLimit(awsClient: AWSClient, region: string, limit: number): Promise<void> {
+  const params = new URLSearchParams({
+    Action: 'SetSMSAttributes',
+    Version: '2010-03-31',
+    'attributes.entry.1.key': 'MonthlySpendLimit',
+    'attributes.entry.1.value': limit.toString(),
+  })
+
+  await awsClient.request({
+    service: 'sns',
+    region,
+    method: 'POST',
+    path: '/',
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+    },
+    body: params.toString(),
+  })
+}
+
+/**
+ * Set up S3 bucket for SMS inbox
+ */
+async function setupS3Inbox(
+  s3: S3Client,
+  config: {
+    bucket: string
+    prefix: string
+    retentionDays?: number
+  },
+): Promise<void> {
+  // Check if bucket exists
+  try {
+    const buckets = await s3.listBuckets()
+    const bucketExists = buckets.Buckets?.some(b => b.Name === config.bucket)
+
+    if (!bucketExists) {
+      // Create bucket
+      await s3.createBucket(config.bucket)
+    }
+
+    // Create placeholder files to ensure prefixes exist
+    const prefixes = [
+      `${config.prefix}.keep`,
+      'sms/sent/.keep',
+      'sms/conversations/.keep',
+      'sms/templates/.keep',
+      'sms/scheduled/.keep',
+      'sms/receipts/.keep',
+    ]
+
+    for (const key of prefixes) {
+      try {
+        await s3.putObject({
+          bucket: config.bucket,
+          key,
+          body: `SMS folder created ${new Date().toISOString()}`,
+          contentType: 'text/plain',
+        })
+      } catch {
+        // Ignore if already exists
+      }
+    }
+
+    // Set up lifecycle rules for retention
+    if (config.retentionDays) {
+      try {
+        await s3.putBucketLifecycleConfiguration(config.bucket, [
+          {
+            ID: 'SmsInboxRetention',
+            Status: 'Enabled',
+            Filter: { Prefix: config.prefix },
+            Expiration: { Days: config.retentionDays },
+          },
+          {
+            ID: 'SmsReceiptsRetention',
+            Status: 'Enabled',
+            Filter: { Prefix: 'sms/receipts/' },
+            Expiration: { Days: config.retentionDays },
+          },
+        ])
+      } catch (err: any) {
+        // Lifecycle configuration might fail if not owner, continue anyway
+        console.log(`  Note: Could not set lifecycle rules: ${err.message}`)
+      }
+    }
+  } catch (err: any) {
+    throw new Error(`Failed to set up S3 inbox: ${err.message}`)
+  }
+}
+
+/**
+ * Set up SNS topic for two-way SMS
+ */
+async function setupTwoWayTopic(
+  sns: SNSClient,
+  awsClient: AWSClient,
+  region: string,
+  topicName: string,
+  accountId?: string,
+): Promise<string> {
+  // Check if topic exists
+  const topics = await sns.listTopics()
+  const existingTopic = topics.Topics?.find(t => t.TopicArn?.endsWith(`:${topicName}`))
+
+  if (existingTopic) {
+    return existingTopic.TopicArn!
+  }
+
+  // Create new topic
+  const params = new URLSearchParams({
+    Action: 'CreateTopic',
+    Version: '2010-03-31',
+    Name: topicName,
+  })
+
+  const result = await awsClient.request({
+    service: 'sns',
+    region,
+    method: 'POST',
+    path: '/',
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+    },
+    body: params.toString(),
+  })
+
+  const topicArn = result?.CreateTopicResponse?.CreateTopicResult?.TopicArn
+  if (!topicArn) {
+    throw new Error('Failed to create SNS topic')
+  }
+
+  // Set up topic policy to allow SMS Voice service to publish
+  const policyParams = new URLSearchParams({
+    Action: 'SetTopicAttributes',
+    Version: '2010-03-31',
+    TopicArn: topicArn,
+    AttributeName: 'Policy',
+    AttributeValue: JSON.stringify({
+      Version: '2012-10-17',
+      Statement: [
+        {
+          Sid: 'AllowSMSVoicePublish',
+          Effect: 'Allow',
+          Principal: {
+            Service: 'sms-voice.amazonaws.com',
+          },
+          Action: 'sns:Publish',
+          Resource: topicArn,
+        },
+      ],
+    }),
+  })
+
+  await awsClient.request({
+    service: 'sns',
+    region,
+    method: 'POST',
+    path: '/',
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+    },
+    body: policyParams.toString(),
+  })
+
+  return topicArn
+}
+
+/**
+ * Set up SNS topic for delivery receipts
+ */
+async function setupDeliveryReceiptsTopic(
+  sns: SNSClient,
+  awsClient: AWSClient,
+  region: string,
+  topicName: string,
+  accountId?: string,
+): Promise<string> {
+  // Same as two-way topic setup
+  return setupTwoWayTopic(sns, awsClient, region, topicName, accountId)
+}
+
+/**
+ * Get complete SMS infrastructure status
+ */
+export async function getSmsInfrastructureStatus(config: {
+  region?: string
+  accountName?: string
+}): Promise<{
+  sandboxStatus: 'IN_SANDBOX' | 'OUT_OF_SANDBOX' | 'UNKNOWN'
+  spendingLimit: number
+  topics: Array<{
+    name: string
+    arn: string
+  }>
+}> {
+  const region = config.region || 'us-east-1'
+  const sns = new SNSClient(region)
+
+  // Get sandbox status
+  const accountStatus = await checkSmsAccountStatus(sns)
+
+  // Get topics
+  const topicsResult = await sns.listTopics()
+  const smsTopics = (topicsResult.Topics || [])
+    .filter(t => t.TopicArn?.includes('sms'))
+    .map(t => ({
+      name: t.TopicArn?.split(':').pop() || '',
+      arn: t.TopicArn || '',
+    }))
+
+  return {
+    sandboxStatus: accountStatus.inSandbox ? 'IN_SANDBOX' : 'OUT_OF_SANDBOX',
+    spendingLimit: accountStatus.spendingLimit,
+    topics: smsTopics,
+  }
+}
+
+/**
+ * Create SMS infrastructure for Stacks deploy
+ * This is the main entry point called by the deploy command
+ */
+export async function createSmsInfrastructure(smsConfig: {
+  enabled: boolean
+  provider: 'sns'
+  originationNumber?: string
+  defaultCountryCode: string
+  messageType: 'TRANSACTIONAL' | 'PROMOTIONAL'
+  maxSpendPerMonth?: number
+  inbox?: {
+    enabled: boolean
+    bucket: string
+    prefix?: string
+    retentionDays?: number
+  }
+  twoWay?: {
+    enabled: boolean
+    snsTopicArn?: string
+  }
+  optOut: {
+    enabled: boolean
+    keywords: string[]
+  }
+}): Promise<SmsSetupResult> {
+  if (!smsConfig.enabled) {
+    return {
+      success: true,
+      errors: [],
+      warnings: ['SMS is disabled in config'],
+    }
+  }
+
+  // Build setup config from Stacks SMS config
+  const setupConfig: SmsSetupConfig = {
+    region: 'us-east-1',
+    accountName: 'stacks',
+    inbox: smsConfig.inbox
+      ? {
+          enabled: smsConfig.inbox.enabled,
+          bucket: smsConfig.inbox.bucket,
+          prefix: smsConfig.inbox.prefix,
+          retentionDays: smsConfig.inbox.retentionDays,
+        }
+      : undefined,
+    twoWay: smsConfig.twoWay
+      ? {
+          enabled: smsConfig.twoWay.enabled,
+        }
+      : undefined,
+    spending: {
+      monthlyLimit: smsConfig.maxSpendPerMonth,
+      autoRequestIncrease: true,
+    },
+    sandbox: {
+      autoRequestExit: true,
+      companyName: 'Stacks',
+      useCase:
+        'Transactional notifications, verification codes, and account alerts for web applications built with Stacks framework.',
+      expectedMonthlyVolume: 5000,
+      websiteUrl: 'https://stacksjs.com',
+    },
+    deliveryReceipts: {
+      enabled: true,
+    },
+  }
+
+  return setupSmsInfrastructure(setupConfig)
+}
+
+export default {
+  setupSmsInfrastructure: setupSmsInfrastructure,
+  getSmsInfrastructureStatus: getSmsInfrastructureStatus,
+  createSmsInfrastructure: createSmsInfrastructure,
+} as {
+  setupSmsInfrastructure: typeof setupSmsInfrastructure
+  getSmsInfrastructureStatus: typeof getSmsInfrastructureStatus
+  createSmsInfrastructure: typeof createSmsInfrastructure
+}