@stacksjs/ts-cloud 0.2.2 → 0.2.5

package/dist/dns/validator.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Unified DNS Validator for ACM Certificates
+ * Works with any DNS provider (Route53, Porkbun, GoDaddy, etc.)
+ */
+import type { DnsProvider, DnsProviderConfig } from './types';
+export interface ValidationRecord {
+    domainName: string;
+    recordName: string;
+    recordType: string;
+    recordValue: string;
+}
+export interface CertificateValidationResult {
+    certificateArn: string;
+    validationRecords: ValidationRecord[];
+    isNew: boolean;
+    status: 'pending' | 'issued' | 'failed';
+}
+/**
+ * Unified DNS Validator
+ * Handles ACM certificate validation with any DNS provider
+ */
+export declare class UnifiedDnsValidator {
+    private acm;
+    private dnsProvider;
+    constructor(dnsProvider: DnsProvider | DnsProviderConfig, acmRegion?: string);
+    /**
+     * Get the DNS provider being used
+     */
+    getProvider(): DnsProvider;
+    /**
+     * Request a certificate and create DNS validation records
+     */
+    requestAndValidate(params: {
+        domainName: string;
+        subjectAlternativeNames?: string[];
+        waitForValidation?: boolean;
+        maxWaitMinutes?: number;
+    }): Promise<CertificateValidationResult>;
+    /**
+     * Create validation records for an existing certificate
+     */
+    createValidationRecords(params: {
+        certificateArn: string;
+        domain: string;
+    }): Promise<{
+        success: boolean;
+        records: ValidationRecord[];
+        errors: string[];
+    }>;
+    /**
+     * Delete validation records (cleanup after certificate is issued)
+     */
+    deleteValidationRecords(params: {
+        certificateArn: string;
+        domain: string;
+    }): Promise<{
+        success: boolean;
+        errors: string[];
+    }>;
+    /**
+     * Find or create a certificate for a domain
+     */
+    findOrCreateCertificate(params: {
+        domainName: string;
+        subjectAlternativeNames?: string[];
+        waitForValidation?: boolean;
+        maxWaitMinutes?: number;
+    }): Promise<CertificateValidationResult>;
+    /**
+     * Request certificate with common SANs (www and wildcard)
+     */
+    requestCertificateWithCommonSans(params: {
+        domainName: string;
+        includeWww?: boolean;
+        includeWildcard?: boolean;
+        additionalSans?: string[];
+        waitForValidation?: boolean;
+    }): Promise<CertificateValidationResult>;
+    /**
+     * Wait for validation options to become available
+     */
+    private waitForValidationOptions;
+    /**
+     * Get the status of a certificate
+     */
+    getCertificateStatus(certificateArn: string): Promise<{
+        status: string;
+        domainValidations: Array<{
+            domain: string;
+            status: string;
+        }>;
+    }>;
+}
+/**
+ * Helper function to create a validator with Porkbun
+ */
+export declare function createPorkbunValidator(apiKey: string, secretKey: string, acmRegion?: string): UnifiedDnsValidator;
+/**
+ * Helper function to create a validator with GoDaddy
+ */
+export declare function createGoDaddyValidator(apiKey: string, apiSecret: string, acmRegion?: string, environment?: 'production' | 'ote'): UnifiedDnsValidator;
+/**
+ * Helper function to create a validator with Route53
+ */
+export declare function createRoute53Validator(region?: string, hostedZoneId?: string, acmRegion?: string): UnifiedDnsValidator;

package/dist/generators/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Infrastructure Generators
+ */
+export * from './infrastructure';

package/dist/generators/infrastructure.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Infrastructure Generator
+ * Generates CloudFormation templates from cloud.config.ts using all Phase 2 modules
+ */
+import type { CloudConfig } from '@ts-cloud/core';
+import { TemplateBuilder } from '@ts-cloud/core';
+export interface GenerationOptions {
+    config: CloudConfig;
+    environment: 'production' | 'staging' | 'development';
+    modules?: string[];
+}
+export declare class InfrastructureGenerator {
+    private builder;
+    private config;
+    private environment;
+    private mergedConfig;
+    private serverEipLogicalIds;
+    constructor(options: GenerationOptions);
+    /**
+     * Merge base config with environment-specific overrides
+     */
+    private mergeEnvironmentConfig;
+    /**
+     * Check if a resource should be deployed based on conditions
+     */
+    private shouldDeploy;
+    /**
+     * Generate complete infrastructure
+     * Auto-detects what to generate based on configuration
+     */
+    generate(): this;
+    /**
+     * Apply global tags to all resources
+     */
+    private applyGlobalTags;
+    /**
+     * Generate VPC/Network infrastructure required by ECS/Fargate
+     */
+    private generateNetworkInfrastructure;
+    /**
+     * Generate ECS/Fargate container infrastructure
+     * Creates ECS Cluster, Task Definition, Service, ALB, Security Groups, IAM roles, etc.
+     */
+    private generateContainerInfrastructure;
+    /**
+     * Generate serverless infrastructure (Lambda, ECS Fargate)
+     */
+    private generateServerless;
+    /**
+     * Generate server infrastructure (EC2)
+     * Creates a full stack per server: EC2 instance + security group + IAM role + instance profile + EIP
+     */
+    private generateServer;
+    /**
+     * Generate the new Forge-style EC2 app stack from `infrastructure.compute`.
+     *
+     * Creates:
+     *  - A deploy staging S3 bucket (`<slug>-<env>-deploy`) with 7-day lifecycle.
+     *    Holds release tarballs that the EC2 instance pulls during `cloud deploy`.
+     *  - An EC2 instance + IAM role + security group + EIP via Compute.createServerModeStack().
+     *  - User Data that bootstraps Bun, system packages, and a systemd `app.service` skeleton.
+     *  - Tags on the EC2 instance (Project / Environment / Role / ManagedBy) so
+     *    the deploy command can target by tag instead of instance ID.
+     *
+     * Triggered when `infrastructure.compute.start` is set (the signal that
+     * "this compute is hosting an app, not just an opaque server").
+     */
+    private generateComputeApp;
+    /**
+     * Generate jump box / bastion host infrastructure
+     */
+    private generateJumpBox;
+    /**
+     * Generate shared infrastructure (storage, database, etc.)
+     */
+    private generateSharedInfrastructure;
+    /**
+     * Generate Realtime (WebSocket) infrastructure
+     * Creates API Gateway WebSocket API, Lambda handlers, DynamoDB tables
+     */
+    private generateRealtimeResources;
+    /**
+     * Generate $connect Lambda handler code
+     */
+    private generateConnectHandlerCode;
+    /**
+     * Generate $disconnect Lambda handler code
+     */
+    private generateDisconnectHandlerCode;
+    /**
+     * Generate $default (message) Lambda handler code
+     */
+    private generateMessageHandlerCode;
+    /**
+     * Generate Realtime Server Mode infrastructure (ts-broadcasting)
+     * Creates ECS/EC2 resources for running the Bun WebSocket server
+     */
+    private generateRealtimeServerResources;
+    /**
+     * Generate broadcast.config.ts content for ts-broadcasting
+     */
+    generateBroadcastConfig(): string;
+    /**
+     * Generate YAML output
+     */
+    toYAML(): string;
+    /**
+     * Generate JSON output
+     */
+    toJSON(): string;
+    /**
+     * Get the template builder
+     */
+    getBuilder(): TemplateBuilder;
+}

package/dist/index.d.ts

@@ -1,169 +1,13 @@
-// Validation exports - types with prefixed names for conflicts with @ts-cloud/core
-export type {
-  ValidationError as TemplateValidationError,
-  ValidationResult as TemplateValidationResult,
-} from './validation';
-// Export AWS module - types with prefixed names where needed
-export type {
-  AWSRequestOptions,
-  AWSClientConfig,
-  AWSError,
-  AWSCredentials as AWSClientCredentials,
-  StackParameter,
-  StackTag,
-  CreateStackOptions,
-  UpdateStackOptions,
-  DescribeStacksOptions,
-  StackEvent,
-  Stack,
-  InvalidationOptions,
-  Distribution,
-  S3SyncOptions,
-  S3CopyOptions,
-  S3ListOptions,
-  S3Object,
-  CertificateDetail,
-  Certificate as ELBv2Certificate,
-  RekognitionS3Object,
-  RekognitionBoundingBox,
-  TextractS3Object,
-  TextractBoundingBox,
-  CountryCode,
-  ContactType,
-  ContactDetail,
-  KendraCreateDataSourceCommandInput,
-  KendraCreateDataSourceCommandOutput,
-  KendraListDataSourcesCommandInput,
-  KendraListDataSourcesCommandOutput,
-  InvokeModelCommandInput,
-  InvokeModelCommandOutput,
-  InvokeModelWithResponseStreamCommandInput,
-  InvokeModelWithResponseStreamCommandOutput,
-  CreateModelCustomizationJobCommandInput,
-  CreateModelCustomizationJobCommandOutput,
-  GetModelCustomizationJobCommandInput,
-  GetModelCustomizationJobCommandOutput,
-  ListFoundationModelsCommandInput,
-  ListFoundationModelsCommandOutput,
-  AttributeValue as DynamoDBAttributeValue,
-  KeySchemaElement,
-  AttributeDefinition as DynamoDBAttributeDefinition,
-} from './aws';
-export type {
-  StaticSiteConfig,
-  DeployResult,
-  UploadOptions,
-  // External DNS types
-  ExternalDnsStaticSiteConfig,
-  ExternalDnsDeployResult,
-} from './deploy';
-export type {
-  DnsProvider,
-  DnsProviderConfig,
-  DnsRecord,
-  DnsRecordType,
-  DnsRecordResult,
-  CreateRecordResult,
-  DeleteRecordResult,
-  ListRecordsResult,
-} from './dns';
-// Re-export @ts-cloud/aws-types with explicit handling for duplicates
-// Note: @ts-cloud/core also exports CloudFormation* types, so we skip re-exporting them here
-// to avoid duplicates. Users can import directly from @ts-cloud/aws-types if needed.
-export type {
-  // S3 types
-  S3Bucket,
-  S3BucketPolicy,
-  // CloudFront types
-  CloudFrontDistribution,
-  CloudFrontOriginAccessControl,
-  CloudFrontCacheBehavior,
-  CloudFrontOrigin,
-} from '@ts-cloud/aws-types';
 export * from './config';
 export * from './generators';
-// Validation exports - functions
-export {
-  validateTemplate,
-  validateTemplateSize,
-  validateResourceLimits,
-} from './validation';
-// Export AWS module - classes and functions
-export {
-  AWSClient,
-  CloudFormationClient,
-  CloudFormationClient as AWSCloudFormationClient,
-  CloudFrontClient,
-  CloudFrontClient as AWSCloudFrontClient,
-  EC2Client,
-  S3Client,
-  Route53Client,
-  Route53DomainsClient,
-  ACMClient,
-  ACMDnsValidator,
-  ECRClient,
-  ECSClient,
-  STSClient,
-  SSMClient,
-  SecretsManagerClient,
-  SESClient,
-  EmailClient,
-  SNSClient,
-  SQSClient,
-  LambdaClient,
-  CloudWatchLogsClient,
-  ConnectClient,
-  ELBv2Client,
-  RDSClient,
-  DynamoDBClient,
-  OpenSearchClient,
-  TranscribeClient,
-  BedrockClient,
-  BedrockRuntimeClient,
-  ComprehendClient,
-  RekognitionClient,
-  TextractClient,
-  PollyClient,
-  TranslateClient,
-  PersonalizeClient,
-  KendraClient,
-  EventBridgeClient,
-  ElastiCacheClient,
-  SchedulerClient,
-  IAMClient,
-  ApplicationAutoScalingClient,
-  SmsClient,
-  VoiceClient,
-  SupportClient,
-  EFSClient,
-} from './aws';
+export { validateTemplate, validateTemplateSize, validateResourceLimits, } from './validation';
+export type { ValidationError as TemplateValidationError, ValidationResult as TemplateValidationResult, } from './validation';
+export { AWSClient, CloudFormationClient, CloudFormationClient as AWSCloudFormationClient, CloudFrontClient, CloudFrontClient as AWSCloudFrontClient, EC2Client, S3Client, Route53Client, Route53DomainsClient, ACMClient, ACMDnsValidator, ECRClient, ECSClient, STSClient, SSMClient, SecretsManagerClient, SESClient, EmailClient, SNSClient, SQSClient, LambdaClient, CloudWatchLogsClient, ConnectClient, ELBv2Client, RDSClient, DynamoDBClient, OpenSearchClient, TranscribeClient, BedrockClient, BedrockRuntimeClient, ComprehendClient, RekognitionClient, TextractClient, PollyClient, TranslateClient, PersonalizeClient, KendraClient, EventBridgeClient, ElastiCacheClient, SchedulerClient, IAMClient, ApplicationAutoScalingClient, SmsClient, VoiceClient, SupportClient, EFSClient, } from './aws';
+export type { AWSRequestOptions, AWSClientConfig, AWSError, AWSCredentials as AWSClientCredentials, StackParameter, StackTag, CreateStackOptions, UpdateStackOptions, DescribeStacksOptions, StackEvent, Stack, InvalidationOptions, Distribution, S3SyncOptions, S3CopyOptions, S3ListOptions, S3Object, CertificateDetail, Certificate as ELBv2Certificate, RekognitionS3Object, RekognitionBoundingBox, TextractS3Object, TextractBoundingBox, CountryCode, ContactType, ContactDetail, KendraCreateDataSourceCommandInput, KendraCreateDataSourceCommandOutput, KendraListDataSourcesCommandInput, KendraListDataSourcesCommandOutput, InvokeModelCommandInput, InvokeModelCommandOutput, InvokeModelWithResponseStreamCommandInput, InvokeModelWithResponseStreamCommandOutput, CreateModelCustomizationJobCommandInput, CreateModelCustomizationJobCommandOutput, GetModelCustomizationJobCommandInput, GetModelCustomizationJobCommandOutput, ListFoundationModelsCommandInput, ListFoundationModelsCommandOutput, AttributeValue as DynamoDBAttributeValue, KeySchemaElement, AttributeDefinition as DynamoDBAttributeDefinition, } from './aws';
 export * from './ssl';
-// Export deployment modules
-export {
-  deployStaticSite,
-  deployStaticSiteFull,
-  uploadStaticFiles,
-  invalidateCache,
-  deleteStaticSite,
-  generateStaticSiteTemplate,
-  // External DNS support
-  deployStaticSiteWithExternalDns,
-  deployStaticSiteWithExternalDnsFull,
-  generateExternalDnsStaticSiteTemplate,
-} from './deploy';
-// Export DNS providers
-export {
-  createDnsProvider,
-  detectDnsProvider,
-  DnsProviderFactory,
-  dnsProviders,
-  PorkbunProvider,
-  GoDaddyProvider,
-  Route53Provider,
-  UnifiedDnsValidator,
-  createPorkbunValidator,
-  createGoDaddyValidator,
-  createRoute53Validator,
-} from './dns';
-// Re-export core functionality (these take precedence for common types)
+export { deployStaticSite, deployStaticSiteFull, uploadStaticFiles, invalidateCache, deleteStaticSite, generateStaticSiteTemplate, deployStaticSiteWithExternalDns, deployStaticSiteWithExternalDnsFull, generateExternalDnsStaticSiteTemplate, } from './deploy';
+export type { StaticSiteConfig, DeployResult, UploadOptions, ExternalDnsStaticSiteConfig, ExternalDnsDeployResult, } from './deploy';
+export { createDnsProvider, detectDnsProvider, DnsProviderFactory, dnsProviders, PorkbunProvider, GoDaddyProvider, Route53Provider, UnifiedDnsValidator, createPorkbunValidator, createGoDaddyValidator, createRoute53Validator, } from './dns';
+export type { DnsProvider, DnsProviderConfig, DnsRecord, DnsRecordType, DnsRecordResult, CreateRecordResult, DeleteRecordResult, ListRecordsResult, } from './dns';
 export * from '@ts-cloud/core';
+export type { S3Bucket, S3BucketPolicy, CloudFrontDistribution, CloudFrontOriginAccessControl, CloudFrontCacheBehavior, CloudFrontOrigin, } from '@ts-cloud/aws-types';