@stacksjs/ts-cloud-core 0.1.3 → 0.1.7

package/dist/modules/email.d.ts

@@ -0,0 +1,217 @@
+import type { EnvironmentType } from '@stacksjs/ts-cloud-types';
+import type { IAMPolicy, IAMRole, LambdaFunction, LambdaPermission, Route53RecordSet, S3Bucket, SESConfigurationSet, SESEmailIdentity, SESReceiptRule, SESReceiptRuleSet,  } from '@stacksjs/ts-cloud-aws-types';
+export declare interface EmailIdentityOptions {
+  domain: string
+  slug: string
+  environment: EnvironmentType
+  enableDkim?: boolean
+  dkimKeyLength?: 'RSA_1024_BIT' | 'RSA_2048_BIT'
+}
+export declare interface ConfigurationSetOptions {
+  slug: string
+  environment: EnvironmentType
+  name?: string
+  reputationMetrics?: boolean
+  sendingEnabled?: boolean
+  suppressBounces?: boolean
+  suppressComplaints?: boolean
+}
+export declare interface ReceiptRuleSetOptions {
+  slug: string
+  environment: EnvironmentType
+  name?: string
+}
+export declare interface ReceiptRuleOptions {
+  slug: string
+  environment: EnvironmentType
+  ruleSetName: string
+  recipients?: string[]
+  enabled?: boolean
+  scanEnabled?: boolean
+  tlsPolicy?: 'Optional' | 'Require'
+  s3Action?: {
+    bucketName: string
+    prefix?: string
+    kmsKeyArn?: string
+  }
+  lambdaAction?: {
+    functionArn: string
+    invocationType?: 'Event' | 'RequestResponse'
+  }
+  snsAction?: {
+    topicArn: string
+    encoding?: 'UTF-8' | 'Base64'
+  }
+}
+/**
+ * Email Module - SES (Simple Email Service)
+ * Provides clean API for email sending, receiving, and domain verification
+ */
+export declare class Email {
+  static verifyDomain(options: EmailIdentityOptions): {
+    emailIdentity: SESEmailIdentity
+    logicalId: string
+  };
+  static createDkimRecords(domain: string, dkimTokens: string[], hostedZoneId: string): Array<{ record: Route53RecordSet, logicalId: string }>;
+  static createConfigurationSet(options: ConfigurationSetOptions): {
+    configurationSet: SESConfigurationSet
+    logicalId: string
+  };
+  static createReceiptRuleSet(options: ReceiptRuleSetOptions): {
+    ruleSet: SESReceiptRuleSet
+    logicalId: string
+  };
+  static createReceiptRule(ruleSetLogicalId: string, options: ReceiptRuleOptions): {
+      receiptRule: SESReceiptRule
+      logicalId: string
+    };
+  static createMxRecord(domain: string, hostedZoneId: string, region: string): {
+      record: Route53RecordSet
+      logicalId: string
+    };
+  static createVerificationRecord(domain: string, verificationToken: string, hostedZoneId: string): {
+      record: Route53RecordSet
+      logicalId: string
+    };
+  static getSmtpEndpoint(region: string): string;
+  static readonly SmtpPorts: any;
+  static createSpfRecord(domain: string, hostedZoneId: string, options?: {
+      includeDomains?: string[]
+      softFail?: boolean
+    }): {
+      record: Route53RecordSet
+      logicalId: string
+    };
+  static createDmarcRecord(domain: string, hostedZoneId: string, options?: {
+      policy?: 'none' | 'quarantine' | 'reject'
+      subdomainPolicy?: 'none' | 'quarantine' | 'reject'
+      percentage?: number
+      reportingEmail?: string
+      forensicEmail?: string
+    }): {
+      record: Route53RecordSet
+      logicalId: string
+    };
+  static createInboundEmailSetup(options: {
+    slug: string
+    environment: EnvironmentType
+    domain: string
+    s3BucketName: string
+    s3KeyPrefix?: string
+    region: string
+    hostedZoneId: string
+    lambdaFunctionArn?: string
+    snsTopicArn?: string
+  }): {
+    resources: Record<string, any>
+    outputs: {
+      ruleSetLogicalId: string
+      ruleLogicalId: string
+      mxRecordLogicalId: string
+    }
+  };
+  static createCompleteDomainSetup(options: {
+    slug: string
+    environment: EnvironmentType
+    domain: string
+    hostedZoneId: string
+    region: string
+    enableInbound?: boolean
+    inboundS3Bucket?: string
+    dmarcReportingEmail?: string
+  }): {
+    resources: Record<string, any>
+    outputs: {
+      identityLogicalId: string
+      configSetLogicalId: string
+    }
+  };
+  static readonly InboundSmtpEndpoints: Record<string, string>;
+  static supportsInboundEmail(region: string): boolean;
+  static createEmailLambdaRole(options: {
+    slug: string
+    environment: EnvironmentType
+    s3BucketArn: string
+    sesIdentityArn?: string
+  }): {
+    role: IAMRole
+    policy: IAMPolicy
+    roleLogicalId: string
+    policyLogicalId: string
+  };
+  static createOutboundEmailLambda(options: {
+    slug: string
+    environment: EnvironmentType
+    roleArn: string
+    domain: string
+    configurationSetName?: string
+    timeout?: number
+    memorySize?: number
+  }): {
+    function: LambdaFunction
+    logicalId: string
+  };
+  static createInboundEmailLambda(options: {
+    slug: string
+    environment: EnvironmentType
+    roleArn: string
+    s3BucketName: string
+    organizedPrefix?: string
+    timeout?: number
+    memorySize?: number
+  }): {
+    function: LambdaFunction
+    permission: LambdaPermission
+    logicalId: string
+    permissionLogicalId: string
+  };
+  static createEmailConversionLambda(options: {
+    slug: string
+    environment: EnvironmentType
+    roleArn: string
+    s3BucketName: string
+    convertedPrefix?: string
+    timeout?: number
+    memorySize?: number
+  }): {
+    function: LambdaFunction
+    logicalId: string
+  };
+  static createEmailBucketNotification(options: {
+    bucketLogicalId: string
+    lambdaArn: string
+    prefix?: string
+    suffix?: string
+    events?: string[]
+  }): {
+    notificationConfiguration: NonNullable<NonNullable<S3Bucket['Properties']>['NotificationConfiguration']>
+  };
+  static createS3LambdaPermission(options: {
+    slug: string
+    environment: EnvironmentType
+    lambdaLogicalId: string
+    s3BucketArn: string
+  }): {
+    permission: LambdaPermission
+    logicalId: string
+  };
+  static createEmailProcessingStack(options: {
+    slug: string
+    environment: EnvironmentType
+    domain: string
+    s3BucketName: string
+    s3BucketArn: string
+    configurationSetName?: string
+    enableInbound?: boolean
+    enableConversion?: boolean
+  }): {
+    resources: Record<string, any>
+    outputs: {
+      roleLogicalId: string
+      outboundLambdaLogicalId: string
+      inboundLambdaLogicalId?: string
+      conversionLambdaLogicalId?: string
+    }
+  };
+  static readonly LambdaCode: any;
+}

package/dist/modules/filesystem.d.ts

@@ -0,0 +1,94 @@
+import type { EC2SecurityGroup, EFSAccessPoint, EFSFileSystem, EFSMountTarget,  } from '@stacksjs/ts-cloud-aws-types';
+import type { EnvironmentType } from '@stacksjs/ts-cloud-types';
+export declare interface FileSystemOptions {
+  slug: string
+  environment: EnvironmentType
+  encrypted?: boolean
+  kmsKeyId?: string
+  performanceMode?: 'generalPurpose' | 'maxIO'
+  throughputMode?: 'bursting' | 'provisioned' | 'elastic'
+  provisionedThroughput?: number
+  enableBackup?: boolean
+}
+export declare interface MountTargetOptions {
+  slug: string
+  environment: EnvironmentType
+  subnetId: string
+  securityGroups: string[]
+  ipAddress?: string
+}
+export declare interface AccessPointOptions {
+  slug: string
+  environment: EnvironmentType
+  path?: string
+  uid?: string
+  gid?: string
+  permissions?: string
+}
+export declare interface LifecyclePolicyOptions {
+  transitionToIA?: 7 | 14 | 30 | 60 | 90
+  transitionToPrimary?: boolean
+}
+/**
+ * FileSystem Module - EFS (Elastic File System)
+ * Provides clean API for creating and configuring shared file systems
+ */
+export declare class FileSystem {
+  static createFileSystem(options: FileSystemOptions): {
+    fileSystem: EFSFileSystem
+    logicalId: string
+  };
+  static createMountTarget(fileSystemLogicalId: string, options: MountTargetOptions): {
+      mountTarget: EFSMountTarget
+      logicalId: string
+    };
+  static createAccessPoint(fileSystemLogicalId: string, options: AccessPointOptions): {
+      accessPoint: EFSAccessPoint
+      logicalId: string
+    };
+  static setLifecyclePolicy(fileSystem: EFSFileSystem, options: LifecyclePolicyOptions): EFSFileSystem;
+  static enableBackup(fileSystem: EFSFileSystem): EFSFileSystem;
+  static disableBackup(fileSystem: EFSFileSystem): EFSFileSystem;
+  static setProvisionedThroughput(fileSystem: EFSFileSystem, throughputInMibps: number): EFSFileSystem;
+  static setElasticThroughput(fileSystem: EFSFileSystem): EFSFileSystem;
+  static enableMaxIO(fileSystem: EFSFileSystem): EFSFileSystem;
+  static createEfsSecurityGroup(options: {
+    slug: string
+    environment: EnvironmentType
+    vpcId: string
+    sourceSecurityGroupIds?: string[]
+    sourceCidrBlocks?: string[]
+    description?: string
+  }): {
+    securityGroup: EC2SecurityGroup
+    logicalId: string
+  };
+  static createMultiAzMountTargets(fileSystemLogicalId: string, options: {
+      slug: string
+      environment: EnvironmentType
+      subnetIds: string[]
+      securityGroupId: string
+    }): {
+    mountTargets: EFSMountTarget[]
+    logicalIds: string[]
+  };
+  static createCompleteFileSystem(options: {
+    slug: string
+    environment: EnvironmentType
+    vpcId: string
+    subnetIds: string[]
+    sourceSecurityGroupIds?: string[]
+    encrypted?: boolean
+    performanceMode?: 'generalPurpose' | 'maxIO'
+    throughputMode?: 'bursting' | 'provisioned' | 'elastic'
+    enableBackup?: boolean
+    transitionToIA?: 7 | 14 | 30 | 60 | 90
+  }): {
+    resources: Record<string, any>
+    outputs: {
+      fileSystemId: string
+      securityGroupId: string
+      mountTargetIds: string[]
+    }
+  };
+}

package/dist/modules/index.d.ts

@@ -0,0 +1,27 @@
+export * from './storage';
+export * from './registry';
+export * from './cdn';
+export * from './dns';
+export * from './security';
+export * from './compute';
+export * from './network';
+export * from './filesystem';
+export * from './email';
+export * from './phone';
+export * from './queue';
+export * from './sms';
+export * from './ai';
+export * from './database';
+export * from './cache';
+export * from './permissions';
+export * from './api';
+export * from './messaging';
+export * from './workflow';
+export * from './monitoring';
+export * from './auth';
+export * from './deployment';
+export * from './secrets';
+export * from './parameter-store';
+export * from './search';
+export * from './redirects';
+export * from './communication';

package/dist/modules/messaging.d.ts

@@ -0,0 +1,108 @@
+import type { EnvironmentType } from '@stacksjs/ts-cloud-types';
+import type { SNSSubscription, SNSTopic, SNSTopicPolicy,  } from '@stacksjs/ts-cloud-aws-types';
+export declare interface TopicOptions {
+  slug: string
+  environment: EnvironmentType
+  topicName?: string
+  displayName?: string
+  encrypted?: boolean
+  kmsKeyId?: string
+}
+export declare interface SubscriptionOptions {
+  slug: string
+  environment: EnvironmentType
+  protocol: 'http' | 'https' | 'email' | 'email-json' | 'sms' | 'sqs' | 'application' | 'lambda' | 'firehose'
+  endpoint: string
+  filterPolicy?: Record<string, unknown>
+  rawMessageDelivery?: boolean
+}
+export declare interface TopicPolicyOptions {
+  slug: string
+  environment: EnvironmentType
+  allowedPrincipals?: string | string[]
+  allowedServices?: string | string[]
+  actions?: string | string[]
+}
+/**
+ * Messaging Module - SNS (Simple Notification Service)
+ * Provides clean API for pub/sub messaging, notifications, and event routing
+ */
+export declare class Messaging {
+  static createTopic(options: TopicOptions): {
+    topic: SNSTopic
+    logicalId: string
+  };
+  static subscribe(topicLogicalId: string, options: SubscriptionOptions): {
+      subscription: SNSSubscription
+      logicalId: string
+    };
+  static subscribeEmail(topicLogicalId: string, email: string, options: {
+      slug: string
+      environment: EnvironmentType
+      filterPolicy?: Record<string, unknown>
+    }): {
+      subscription: SNSSubscription
+      logicalId: string
+    };
+  static subscribeLambda(topicLogicalId: string, functionArn: string, options: {
+      slug: string
+      environment: EnvironmentType
+      filterPolicy?: Record<string, unknown>
+    }): {
+      subscription: SNSSubscription
+      logicalId: string
+    };
+  static subscribeSqs(topicLogicalId: string, queueArn: string, options: {
+      slug: string
+      environment: EnvironmentType
+      filterPolicy?: Record<string, unknown>
+      rawMessageDelivery?: boolean
+    }): {
+      subscription: SNSSubscription
+      logicalId: string
+    };
+  static subscribeHttp(topicLogicalId: string, url: string, options: {
+      slug: string
+      environment: EnvironmentType
+      filterPolicy?: Record<string, unknown>
+    }): {
+      subscription: SNSSubscription
+      logicalId: string
+    };
+  static subscribeSms(topicLogicalId: string, phoneNumber: string, options: {
+      slug: string
+      environment: EnvironmentType
+    }): {
+      subscription: SNSSubscription
+      logicalId: string
+    };
+  static setTopicPolicy(topicLogicalId: string, options: TopicPolicyOptions): {
+      policy: SNSTopicPolicy
+      logicalId: string
+    };
+  static allowCloudWatchAlarms(topicLogicalId: string, options: {
+      slug: string
+      environment: EnvironmentType
+    }): {
+      policy: SNSTopicPolicy
+      logicalId: string
+    };
+  static allowEventBridge(topicLogicalId: string, options: {
+      slug: string
+      environment: EnvironmentType
+    }): {
+      policy: SNSTopicPolicy
+      logicalId: string
+    };
+  static allowS3(topicLogicalId: string, options: {
+      slug: string
+      environment: EnvironmentType
+    }): {
+      policy: SNSTopicPolicy
+      logicalId: string
+    };
+  static enableEncryption(topic: SNSTopic, kmsKeyId: string): SNSTopic;
+  static addInlineSubscription(topic: SNSTopic, protocol: SubscriptionOptions['protocol'], endpoint: string): SNSTopic;
+  static readonly FilterPolicies: any;
+  static readonly UseCases: any;
+}

package/dist/modules/monitoring.d.ts

@@ -0,0 +1,127 @@
+import type { CloudWatchAlarm, CloudWatchDashboard, CloudWatchLogGroup, CloudWatchLogStream, CloudWatchMetricFilter, CloudWatchCompositeAlarm,  } from '@stacksjs/ts-cloud-aws-types';
+import type { EnvironmentType } from '@stacksjs/ts-cloud-types';
+export declare interface AlarmOptions {
+  slug: string
+  environment: EnvironmentType
+  alarmName?: string
+  metricName: string
+  namespace: string
+  statistic?: 'Average' | 'Sum' | 'Minimum' | 'Maximum' | 'SampleCount'
+  period?: number
+  evaluationPeriods?: number
+  threshold: number
+  comparisonOperator: 'GreaterThanThreshold' | 'GreaterThanOrEqualToThreshold' | 'LessThanThreshold' | 'LessThanOrEqualToThreshold'
+  treatMissingData?: 'breaching' | 'notBreaching' | 'ignore' | 'missing'
+  actionsEnabled?: boolean
+  alarmActions?: string[]
+  okActions?: string[]
+  insufficientDataActions?: string[]
+  dimensions?: Record<string, string>
+  unit?: string
+  datapointsToAlarm?: number
+}
+export declare interface DashboardOptions {
+  slug: string
+  environment: EnvironmentType
+  dashboardName?: string
+  widgets: DashboardWidget[]
+}
+export declare interface DashboardWidget {
+  type: 'metric' | 'log' | 'text' | 'alarm'
+  x: number
+  y: number
+  width: number
+  height: number
+  properties: Record<string, unknown>
+}
+export declare interface LogGroupOptions {
+  slug: string
+  environment: EnvironmentType
+  logGroupName?: string
+  retentionInDays?: number
+  kmsKeyId?: string
+}
+export declare interface LogStreamOptions {
+  slug: string
+  environment: EnvironmentType
+  logStreamName?: string
+}
+export declare interface MetricFilterOptions {
+  slug: string
+  environment: EnvironmentType
+  filterName?: string
+  filterPattern: string
+  metricTransformations: MetricTransformation[]
+}
+export declare interface MetricTransformation {
+  metricName: string
+  metricNamespace: string
+  metricValue: string
+  defaultValue?: number
+  unit?: string
+}
+export declare interface CompositeAlarmOptions {
+  slug: string
+  environment: EnvironmentType
+  alarmName?: string
+  alarmRule: string
+  actionsEnabled?: boolean
+  alarmActions?: string[]
+  okActions?: string[]
+  insufficientDataActions?: string[]
+}
+/**
+ * Monitoring Module - CloudWatch
+ * Provides clean API for alarms, dashboards, logs, and metrics
+ */
+export declare class Monitoring {
+  static createAlarm(options: AlarmOptions): {
+    alarm: CloudWatchAlarm
+    logicalId: string
+  };
+  static createCompositeAlarm(options: CompositeAlarmOptions): {
+    alarm: CloudWatchCompositeAlarm
+    logicalId: string
+  };
+  static createDashboard(options: DashboardOptions): {
+    dashboard: CloudWatchDashboard
+    logicalId: string
+  };
+  static createLogGroup(options: LogGroupOptions): {
+    logGroup: CloudWatchLogGroup
+    logicalId: string
+  };
+  static createLogStream(logGroupLogicalId: string, options: LogStreamOptions): {
+      logStream: CloudWatchLogStream
+      logicalId: string
+    };
+  static createMetricFilter(logGroupLogicalId: string, options: MetricFilterOptions): {
+      metricFilter: CloudWatchMetricFilter
+      logicalId: string
+    };
+  static readonly AlarmTypes: any;
+  static readonly DashboardWidgets: any;
+  static readonly RetentionPeriods: any;
+  static readonly FilterPatterns: any;
+  static createApplicationDashboard(options: {
+    slug: string
+    environment: EnvironmentType
+    region?: string
+    components?: {
+      ec2InstanceIds?: string[]
+      lambdaFunctionNames?: string[]
+      ecsClusterName?: string
+      ecsServiceName?: string
+      albName?: string
+      targetGroupName?: string
+      rdsInstanceId?: string
+      sqsQueueNames?: string[]
+      logGroupNames?: string[]
+    }
+  }): {
+    dashboard: CloudWatchDashboard
+    logicalId: string
+  };
+  static readonly DashboardTemplates: any;
+  static readonly Config: any;
+}

package/dist/modules/network.d.ts

@@ -0,0 +1,102 @@
+import type { EC2EIP, EC2FlowLog, EC2InternetGateway, EC2NatGateway, EC2Route, EC2RouteTable, EC2Subnet, EC2SubnetRouteTableAssociation, EC2VPC, EC2VPCGatewayAttachment,  } from '@stacksjs/ts-cloud-aws-types';
+import type { EnvironmentType } from '@stacksjs/ts-cloud-types';
+export declare interface VpcOptions {
+  slug: string
+  environment: EnvironmentType
+  cidr?: string
+  enableDnsHostnames?: boolean
+  enableDnsSupport?: boolean
+  zones?: number
+}
+export declare interface SubnetOptions {
+  slug: string
+  environment: EnvironmentType
+  vpcId: string
+  type: 'public' | 'private' | 'isolated'
+  cidr: string
+  availabilityZone: string
+  mapPublicIp?: boolean
+}
+export declare interface NatGatewayOptions {
+  slug: string
+  environment: EnvironmentType
+  subnetId: string
+}
+export declare interface FlowLogOptions {
+  slug: string
+  environment: EnvironmentType
+  resourceId: string
+  resourceType: 'VPC' | 'Subnet'
+  trafficType?: 'ACCEPT' | 'REJECT' | 'ALL'
+  logGroupName?: string
+}
+/**
+ * Network Module - VPC, Subnets, NAT, Internet Gateway
+ * Provides clean API for creating and configuring networking resources
+ */
+export declare class Network {
+  static createVpc(options: VpcOptions): {
+    vpc: EC2VPC
+    logicalId: string
+  };
+  static createSubnet(options: SubnetOptions): {
+    subnet: EC2Subnet
+    logicalId: string
+  };
+  static createInternetGateway(slug: string, environment: EnvironmentType): {
+      internetGateway: EC2InternetGateway
+      logicalId: string
+    };
+  static attachInternetGateway(vpcLogicalId: string, igwLogicalId: string): {
+      attachment: EC2VPCGatewayAttachment
+      logicalId: string
+    };
+  static createEip(slug: string, environment: EnvironmentType): {
+      eip: EC2EIP
+      logicalId: string
+    };
+  static createNatGateway(options: NatGatewayOptions, eipLogicalId: string): {
+      natGateway: EC2NatGateway
+      logicalId: string
+    };
+  static createRouteTable(slug: string, environment: EnvironmentType, vpcLogicalId: string, type: 'public' | 'private'): {
+      routeTable: EC2RouteTable
+      logicalId: string
+    };
+  static createRoute(routeTableLogicalId: string, destination: string, target: {
+      type: 'igw' | 'nat' | 'instance'
+      logicalId: string
+    }): {
+      route: EC2Route
+      logicalId: string
+    };
+  static associateSubnetWithRouteTable(subnetLogicalId: string, routeTableLogicalId: string): {
+      association: EC2SubnetRouteTableAssociation
+      logicalId: string
+    };
+  static enableFlowLogs(options: FlowLogOptions): {
+    flowLog: EC2FlowLog
+    logicalId: string
+  };
+  static calculateSubnetCidrs(vpcCidr: string, zones: number, subnetsPerZone?: any): string[];
+  static getAvailabilityZones(region: string, count: number): string[];
+  static createMultiAzNetwork(options: {
+    slug: string
+    environment: EnvironmentType
+    region: string
+    cidr?: string
+    zones?: number
+    enableNatGateway?: boolean
+    singleNatGateway?: boolean // Use single NAT for cost savings (not HA)
+    enableFlowLogs?: boolean
+  }): {
+    resources: Record<string, any>
+    outputs: {
+      vpcId: string
+      publicSubnetIds: string[]
+      privateSubnetIds: string[]
+      natGatewayIds?: string[]
+    }
+  };
+  static readonly NatGatewayCostWarning: any;
+}

package/dist/modules/parameter-store.d.ts

@@ -0,0 +1,33 @@
+import type { SSMParameter } from '@stacksjs/ts-cloud-aws-types';
+export declare interface ParameterOptions {
+  slug: string
+  environment: string
+  parameterName?: string
+  value: string
+  type?: 'String' | 'StringList' | 'SecureString'
+  description?: string
+  tier?: 'Standard' | 'Advanced' | 'Intelligent-Tiering'
+  tags?: Record<string, string>
+}
+/**
+ * Parameter Store Module
+ */
+export declare class ParameterStore {
+  static createParameter(options: ParameterOptions): {
+    parameter: SSMParameter
+    logicalId: string
+  };
+  static createString(slug: string, environment: string, name: string, value: string, description?: string): {
+    parameter: SSMParameter
+    logicalId: string
+  };
+  static createSecureString(slug: string, environment: string, name: string, value: string, description?: string): {
+    parameter: SSMParameter
+    logicalId: string
+  };
+  static createStringList(slug: string, environment: string, name: string, values: string[], description?: string): {
+    parameter: SSMParameter
+    logicalId: string
+  };
+  static readonly Parameters: any;
+}