@stacksjs/ts-cloud 0.1.3 → 0.1.6

package/dist/aws/secrets-manager.d.ts

@@ -0,0 +1,170 @@
+import { AWSClient } from './client';
+export declare interface Secret {
+  ARN?: string
+  Name?: string
+  Description?: string
+  KmsKeyId?: string
+  RotationEnabled?: boolean
+  RotationLambdaARN?: string
+  RotationRules?: {
+    AutomaticallyAfterDays?: number
+    Duration?: string
+    ScheduleExpression?: string
+  }
+  LastRotatedDate?: string
+  LastChangedDate?: string
+  LastAccessedDate?: string
+  DeletedDate?: string
+  NextRotationDate?: string
+  Tags?: { Key: string, Value: string }[]
+  SecretVersionsToStages?: Record<string, string[]>
+  CreatedDate?: string
+  PrimaryRegion?: string
+}
+export declare interface SecretValue {
+  ARN?: string
+  Name?: string
+  VersionId?: string
+  SecretBinary?: string
+  SecretString?: string
+  VersionStages?: string[]
+  CreatedDate?: string
+}
+export declare interface CreateSecretOptions {
+  Name: string
+  Description?: string
+  KmsKeyId?: string
+  SecretBinary?: string
+  SecretString?: string
+  Tags?: { Key: string, Value: string }[]
+  AddReplicaRegions?: { Region: string, KmsKeyId?: string }[]
+  ForceOverwriteReplicaSecret?: boolean
+  ClientRequestToken?: string
+}
+export declare interface UpdateSecretOptions {
+  SecretId: string
+  Description?: string
+  KmsKeyId?: string
+  SecretBinary?: string
+  SecretString?: string
+}
+export declare interface PutSecretValueOptions {
+  SecretId: string
+  SecretBinary?: string
+  SecretString?: string
+  VersionStages?: string[]
+  ClientRequestToken?: string
+}
+export declare interface GetSecretValueOptions {
+  SecretId: string
+  VersionId?: string
+  VersionStage?: string
+}
+export declare interface RotationRules {
+  AutomaticallyAfterDays?: number
+  Duration?: string
+  ScheduleExpression?: string
+}
+/**
+ * Secrets Manager client using direct API calls
+ */
+export declare class SecretsManagerClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string, profile?: string);
+  createSecret(options: CreateSecretOptions): Promise<{
+    ARN?: string
+    Name?: string
+    VersionId?: string
+    ReplicationStatus?: { Region: string, Status: string, StatusMessage?: string }[]
+  }>;
+  updateSecret(options: UpdateSecretOptions): Promise<{
+    ARN?: string
+    Name?: string
+    VersionId?: string
+  }>;
+  putSecretValue(options: PutSecretValueOptions): Promise<{
+    ARN?: string
+    Name?: string
+    VersionId?: string
+    VersionStages?: string[]
+  }>;
+  getSecretValue(options: GetSecretValueOptions): Promise<SecretValue>;
+  describeSecret(secretId: string): Promise<Secret>;
+  listSecrets(options?: {
+    MaxResults?: number
+    NextToken?: string
+    Filters?: { Key: string, Values: string[] }[]
+    SortOrder?: 'asc' | 'desc'
+  }): Promise<{
+    SecretList?: Secret[]
+    NextToken?: string
+  }>;
+  deleteSecret(options: {
+    SecretId: string
+    RecoveryWindowInDays?: number
+    ForceDeleteWithoutRecovery?: boolean
+  }): Promise<{
+    ARN?: string
+    Name?: string
+    DeletionDate?: string
+  }>;
+  restoreSecret(secretId: string): Promise<{
+    ARN?: string
+    Name?: string
+  }>;
+  rotateSecret(options: {
+    SecretId: string
+    ClientRequestToken?: string
+    RotationLambdaARN?: string
+    RotationRules?: RotationRules
+    RotateImmediately?: boolean
+  }): Promise<{
+    ARN?: string
+    Name?: string
+    VersionId?: string
+  }>;
+  cancelRotateSecret(secretId: string): Promise<{
+    ARN?: string
+    Name?: string
+  }>;
+  getResourcePolicy(secretId: string): Promise<{
+    ARN?: string
+    Name?: string
+    ResourcePolicy?: string
+  }>;
+  putResourcePolicy(options: {
+    SecretId: string
+    ResourcePolicy: string
+    BlockPublicPolicy?: boolean
+  }): Promise<{
+    ARN?: string
+    Name?: string
+  }>;
+  deleteResourcePolicy(secretId: string): Promise<{
+    ARN?: string
+    Name?: string
+  }>;
+  tagResource(options: {
+    SecretId: string
+    Tags: { Key: string, Value: string }[]
+  }): Promise<void>;
+  untagResource(options: {
+    SecretId: string
+    TagKeys: string[]
+  }): Promise<void>;
+  setString(name: string, value: string, options?: {
+    description?: string
+    kmsKeyId?: string
+    tags?: { Key: string, Value: string }[]
+  }): Promise<{ ARN?: string, VersionId?: string }>;
+  setJson(name: string, value: Record<string, any>, options?: {
+    description?: string
+    kmsKeyId?: string
+    tags?: { Key: string, Value: string }[]
+  }): Promise<{ ARN?: string, VersionId?: string }>;
+  getString(secretId: string): Promise<string | undefined>;
+  getJson<T = Record<string, any>>(secretId: string): Promise<T | undefined>;
+  listAll(): Promise<Secret[]>;
+  private parseSecret(s: any): Secret;
+}

package/dist/aws/ses.d.ts

@@ -0,0 +1,288 @@
+import { AWSClient } from './client';
+export declare interface EmailIdentity {
+  IdentityType?: 'EMAIL_ADDRESS' | 'DOMAIN' | 'MANAGED_DOMAIN'
+  IdentityName?: string
+  SendingEnabled?: boolean
+  VerificationStatus?: 'PENDING' | 'SUCCESS' | 'FAILED' | 'TEMPORARY_FAILURE' | 'NOT_STARTED'
+  DkimAttributes?: {
+    SigningEnabled?: boolean
+    Status?: 'PENDING' | 'SUCCESS' | 'FAILED' | 'TEMPORARY_FAILURE' | 'NOT_STARTED'
+    Tokens?: string[]
+    SigningAttributesOrigin?: 'AWS_SES' | 'EXTERNAL'
+  }
+  MailFromAttributes?: {
+    MailFromDomain?: string
+    MailFromDomainStatus?: 'PENDING' | 'SUCCESS' | 'FAILED' | 'TEMPORARY_FAILURE'
+    BehaviorOnMxFailure?: 'USE_DEFAULT_VALUE' | 'REJECT_MESSAGE'
+  }
+}
+export declare interface SendEmailResult {
+  MessageId?: string
+}
+/**
+ * SES email service management using direct API calls
+ */
+export declare class SESClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string);
+  createEmailIdentity(params: {
+    EmailIdentity: string
+    DkimSigningAttributes?: {
+      DomainSigningSelector?: string
+      DomainSigningPrivateKey?: string
+    }
+    Tags?: Array<{ Key: string, Value: string }>
+  }): Promise<{
+    IdentityType?: string
+    VerifiedForSendingStatus?: boolean
+    DkimAttributes?: {
+      SigningEnabled?: boolean
+      Status?: string
+      Tokens?: string[]
+      SigningAttributesOrigin?: string
+    }
+  }>;
+  getEmailIdentity(emailIdentity: string): Promise<EmailIdentity>;
+  putEmailIdentityMailFromAttributes(emailIdentity: string, params: {
+    MailFromDomain?: string
+    BehaviorOnMxFailure?: 'USE_DEFAULT_VALUE' | 'REJECT_MESSAGE'
+  }): Promise<void>;
+  listEmailIdentities(params?: {
+    PageSize?: number
+    NextToken?: string
+  }): Promise<{
+    EmailIdentities?: Array<{
+      IdentityType?: string
+      IdentityName?: string
+      SendingEnabled?: boolean
+    }>
+    NextToken?: string
+  }>;
+  deleteEmailIdentity(emailIdentity: string): Promise<void>;
+  putEmailIdentityDkimAttributes(params: {
+    EmailIdentity: string
+    SigningEnabled: boolean
+  }): Promise<void>;
+  sendEmail(params: {
+    FromEmailAddress: string
+    Destination: {
+      ToAddresses?: string[]
+      CcAddresses?: string[]
+      BccAddresses?: string[]
+    }
+    Content: {
+      Simple?: {
+        Subject: { Data: string, Charset?: string }
+        Body: {
+          Text?: { Data: string, Charset?: string }
+          Html?: { Data: string, Charset?: string }
+        }
+      }
+      Raw?: {
+        Data: string // Base64 encoded
+      }
+      Template?: {
+        TemplateName: string
+        TemplateData?: string
+      }
+    }
+    ReplyToAddresses?: string[]
+    ConfigurationSetName?: string
+  }): Promise<SendEmailResult>;
+  sendBulkEmail(params: {
+    FromEmailAddress: string
+    BulkEmailEntries: Array<{
+      Destination: {
+        ToAddresses?: string[]
+        CcAddresses?: string[]
+        BccAddresses?: string[]
+      }
+      ReplacementEmailContent?: {
+        ReplacementTemplate?: {
+          ReplacementTemplateData?: string
+        }
+      }
+    }>
+    DefaultContent: {
+      Template: {
+        TemplateName: string
+        TemplateData?: string
+      }
+    }
+    ConfigurationSetName?: string
+  }): Promise<{
+    BulkEmailEntryResults?: Array<{
+      Status?: string
+      Error?: string
+      MessageId?: string
+    }>
+  }>;
+  createEmailTemplate(params: {
+    TemplateName: string
+    TemplateContent: {
+      Subject?: string
+      Text?: string
+      Html?: string
+    }
+  }): Promise<void>;
+  getEmailTemplate(templateName: string): Promise<{
+    TemplateName?: string
+    TemplateContent?: {
+      Subject?: string
+      Text?: string
+      Html?: string
+    }
+  }>;
+  deleteEmailTemplate(templateName: string): Promise<void>;
+  listEmailTemplates(params?: {
+    PageSize?: number
+    NextToken?: string
+  }): Promise<{
+    TemplatesMetadata?: Array<{
+      TemplateName?: string
+      CreatedTimestamp?: string
+    }>
+    NextToken?: string
+  }>;
+  getSendStatistics(): Promise<{
+    SendDataPoints?: Array<{
+      Timestamp?: string
+      DeliveryAttempts?: number
+      Bounces?: number
+      Complaints?: number
+      Rejects?: number
+    }>
+  }>;
+  getSendQuota(): Promise<{
+    Max24HourSend?: number
+    MaxSendRate?: number
+    SentLast24Hours?: number
+  }>;
+  verifyDomain(domain: string): Promise<{
+    dkimTokens?: string[]
+    verificationStatus?: string
+  }>;
+  sendSimpleEmail(params: {
+    from: string
+    to: string | string[]
+    subject: string
+    text?: string
+    html?: string
+    replyTo?: string | string[]
+  }): Promise<SendEmailResult>;
+  sendTemplatedEmail(params: {
+    from: string
+    to: string | string[]
+    templateName: string
+    templateData: Record<string, any>
+    replyTo?: string | string[]
+  }): Promise<SendEmailResult>;
+  getDkimRecords(domain: string): Promise<Array<{
+    name: string
+    type: string
+    value: string
+  }>>;
+  isDomainVerified(domain: string): Promise<boolean>;
+  waitForDomainVerification(domain: string, maxAttempts?: any, delayMs?: any): Promise<boolean>;
+  private buildFormBody(params: Record<string, string | undefined>): string;
+  createReceiptRuleSet(ruleSetName: string): Promise<void>;
+  deleteReceiptRuleSet(ruleSetName: string): Promise<void>;
+  setActiveReceiptRuleSet(ruleSetName: string): Promise<void>;
+  listReceiptRuleSets(nextToken?: string): Promise<{
+    RuleSets?: Array<{ Name?: string, CreatedTimestamp?: string }>
+    NextToken?: string
+  }>;
+  describeReceiptRuleSet(ruleSetName: string): Promise<{
+    Metadata?: { Name?: string, CreatedTimestamp?: string }
+    Rules?: Array<{
+      Name?: string
+      Enabled?: boolean
+      Recipients?: string[]
+      Actions?: Array<{
+        S3Action?: { BucketName?: string, ObjectKeyPrefix?: string }
+        LambdaAction?: { FunctionArn?: string, InvocationType?: string }
+        SNSAction?: { TopicArn?: string }
+      }>
+    }>
+  }>;
+  createReceiptRule(params: {
+    RuleSetName: string
+    Rule: {
+      Name: string
+      Enabled?: boolean
+      TlsPolicy?: 'Require' | 'Optional'
+      Recipients?: string[]
+      ScanEnabled?: boolean
+      Actions: Array<{
+        S3Action?: {
+          BucketName: string
+          ObjectKeyPrefix?: string
+          KmsKeyArn?: string
+        }
+        LambdaAction?: {
+          FunctionArn: string
+          InvocationType?: 'Event' | 'RequestResponse'
+        }
+        SNSAction?: {
+          TopicArn: string
+          Encoding?: 'UTF-8' | 'Base64'
+        }
+        StopAction?: {
+          Scope: 'RuleSet'
+          TopicArn?: string
+        }
+      }>
+    }
+    After?: string
+  }): Promise<void>;
+  deleteReceiptRule(ruleSetName: string, ruleName: string): Promise<void>;
+  receiptRuleSetExists(ruleSetName: string): Promise<boolean>;
+  getActiveReceiptRuleSet(): Promise<{
+    Metadata?: { Name?: string, CreatedTimestamp?: string }
+    Rules?: Array<{
+      Name?: string
+      Enabled?: boolean
+      Recipients?: string[]
+      Actions?: Array<{
+        S3Action?: { BucketName?: string, ObjectKeyPrefix?: string }
+        LambdaAction?: { FunctionArn?: string, InvocationType?: string }
+        SNSAction?: { TopicArn?: string }
+      }>
+    }>
+  } | null>;
+  updateReceiptRule(params: {
+    RuleSetName: string
+    Rule: {
+      Name: string
+      Enabled?: boolean
+      TlsPolicy?: 'Require' | 'Optional'
+      Recipients?: string[]
+      ScanEnabled?: boolean
+      Actions: Array<{
+        S3Action?: {
+          BucketName: string
+          ObjectKeyPrefix?: string
+          KmsKeyArn?: string
+        }
+        LambdaAction?: {
+          FunctionArn: string
+          InvocationType?: 'Event' | 'RequestResponse'
+        }
+        SNSAction?: {
+          TopicArn: string
+          Encoding?: 'UTF-8' | 'Base64'
+        }
+        StopAction?: {
+          Scope: 'RuleSet'
+          TopicArn?: string
+        }
+      }>
+    }
+  }): Promise<void>;
+  sendRawEmail(params: {
+    source: string
+    destinations: string[]
+    rawMessage: string
+  }): Promise<{ MessageId?: string }>;
+}

package/dist/aws/setup-sms.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Set up complete SMS infrastructure
+ * Called automatically during `buddy deploy` when SMS is enabled
+ */
+export declare function setupSmsInfrastructure(config: SmsSetupConfig): Promise<SmsSetupResult>;
+/**
+ * Get complete SMS infrastructure status
+ */
+export declare function getSmsInfrastructureStatus(config: {
+  region?: string
+  accountName?: string
+}): Promise<{
+  sandboxStatus: 'IN_SANDBOX' | 'OUT_OF_SANDBOX' | 'UNKNOWN'
+  spendingLimit: number
+  topics: Array<{
+    name: string
+    arn: string
+  }>
+}>;
+/**
+ * Create SMS infrastructure for Stacks deploy
+ * This is the main entry point called by the deploy command
+ */
+export declare 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>;
+export declare interface SmsSetupConfig {
+  region?: string
+  accountName?: string
+  accountId?: string
+  inbox?: {
+    enabled?: boolean
+    bucket?: string
+    prefix?: string
+    // Create lifecycle rules for retention
+    retentionDays?: number
+  }
+  twoWay?: {
+    enabled?: boolean
+    topicName?: string
+  }
+  spending?: {
+    monthlyLimit?: number
+    // Auto-request increase via AWS Support
+    autoRequestIncrease?: boolean
+  }
+  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
+  }
+  deliveryReceipts?: {
+    enabled?: boolean
+    // SNS topic for delivery receipts
+    topicName?: string
+    // Store receipts in S3
+    s3Bucket?: string
+    s3Prefix?: string
+  }
+  inboxLambda?: {
+    enabled?: boolean
+    functionName?: string
+    // Code location (for creating new Lambda)
+    codeS3Bucket?: string
+    codeS3Key?: string
+  }
+}
+export declare 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[]
+}
+export default {
+  setupSmsInfrastructure: setupSmsInfrastructure,
+  getSmsInfrastructureStatus: getSmsInfrastructureStatus,
+  createSmsInfrastructure: createSmsInfrastructure,
+} as {
+  setupSmsInfrastructure: typeof setupSmsInfrastructure
+  getSmsInfrastructureStatus: typeof getSmsInfrastructureStatus
+  createSmsInfrastructure: typeof createSmsInfrastructure
+};