@stacksjs/ts-cloud-core 0.1.3 → 0.1.7

package/dist/security/secrets-rotation.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Global secrets rotation manager instance
+ */
+export declare const secretsRotationManager: SecretsRotationManager;
+/**
+ * Automated Secrets Rotation
+ * Automatic rotation for RDS credentials, API keys, and other secrets
+ */
+export declare interface SecretRotation {
+  id: string
+  secretId: string
+  secretType: SecretType
+  rotationEnabled: boolean
+  rotationDays: number
+  rotationLambdaArn?: string
+  lastRotated?: Date
+  nextRotation?: Date
+  versionStages?: string[]
+}
+export declare interface RotationConfig {
+  automaticallyAfterDays: number
+  rotationLambda?: RotationLambda
+  requireMasterPassword?: boolean
+  excludeCharacters?: string
+  passwordLength?: number
+}
+export declare interface RotationLambda {
+  functionArn: string
+  functionName: string
+  runtime: string
+  handler: string
+}
+export declare interface RotationSchedule {
+  id: string
+  name: string
+  secrets: string[]
+  schedule: string
+  enabled: boolean
+  lastRun?: Date
+  nextRun?: Date
+}
+export declare interface RotationResult {
+  success: boolean
+  secretId: string
+  oldVersion: string
+  newVersion: string
+  rotatedAt: Date
+  error?: string
+}
+export declare interface RDSRotationConfig {
+  secretArn: string
+  databaseIdentifier: string
+  engine: 'postgres' | 'mysql' | 'sqlserver' | 'oracle'
+  masterSecretArn?: string
+  superuserSecretArn?: string
+}
+export type SecretType = | 'rds_credentials'
+  | 'api_key'
+  | 'oauth_token'
+  | 'ssh_key'
+  | 'certificate'
+  | 'generic'
+/**
+ * Secrets rotation manager
+ */
+export declare class SecretsRotationManager {
+  private rotations: Map<string, SecretRotation>;
+  private schedules: Map<string, RotationSchedule>;
+  private rotationCounter: any;
+  private scheduleCounter: any;
+  createRotation(rotation: Omit<SecretRotation, 'id'>): SecretRotation;
+  enableRDSRotation(options: {
+    secretId: string
+    databaseIdentifier: string
+    engine: 'postgres' | 'mysql' | 'sqlserver' | 'oracle'
+    rotationDays?: number
+    masterSecretArn?: string
+  }): SecretRotation;
+  enableAPIKeyRotation(options: {
+    secretId: string
+    rotationDays?: number
+    rotationLambdaArn?: string
+  }): SecretRotation;
+  enableOAuthRotation(options: {
+    secretId: string
+    rotationDays?: number
+    rotationLambdaArn: string
+  }): SecretRotation;
+  enableSSHKeyRotation(options: {
+    secretId: string
+    rotationDays?: number
+    rotationLambdaArn: string
+  }): SecretRotation;
+  createSchedule(schedule: Omit<RotationSchedule, 'id'>): RotationSchedule;
+  executeRotation(rotationId: string): Promise<RotationResult>;
+  needsRotation(rotationId: string): boolean;
+  getSecretsNeedingRotation(): SecretRotation[];
+  private generateRDSRotationLambdaArn(engine: string): string;
+  getRotation(id: string): SecretRotation | undefined;
+  listRotations(): SecretRotation[];
+  getSchedule(id: string): RotationSchedule | undefined;
+  listSchedules(): RotationSchedule[];
+  generateRotationCF(rotation: SecretRotation): any;
+  generateRotationLambdaCF(options: {
+    functionName: string
+    secretType: SecretType
+    vpcConfig?: {
+      subnetIds: string[]
+      securityGroupIds: string[]
+    }
+  }): any;
+  generateRotationLambdaRoleCF(): any;
+  generateRotationScheduleCF(schedule: RotationSchedule): any;
+  clear(): void;
+}

package/dist/sms/advanced/ab-testing.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A/B Testing for SMS Content
+ *
+ * Provides A/B testing capabilities for SMS campaigns
+ */
+export declare interface AbTest {
+  id: string
+  name: string
+  status: 'draft' | 'running' | 'completed' | 'cancelled'
+  variants: AbVariant[]
+  trafficSplit: number[]
+  winningCriteria: 'delivery_rate' | 'click_rate' | 'reply_rate' | 'conversion_rate'
+  sampleSize: number
+  currentSample: number
+  winner?: string
+  createdAt: string
+  startedAt?: string
+  completedAt?: string
+}
+export declare interface AbVariant {
+  id: string
+  name: string
+  message: string
+  stats: VariantStats
+}
+export declare interface VariantStats {
+  sent: number
+  delivered: number
+  clicked: number
+  replied: number
+  converted: number
+  deliveryRate: number
+  clickRate: number
+  replyRate: number
+  conversionRate: number
+}
+/**
+ * A/B Testing Module
+ */
+export declare class AbTesting {
+  static AbTestManagerCode: any;
+  static createAbTestsTable(config: { slug: string }): Record<string, any>;
+  static createAbTestManagerLambda(config: {
+    slug: string
+    roleArn: string
+    abTestsTable: string
+  }): Record<string, any>;
+  static selectVariant(test: AbTest, recipientId: string): AbVariant;
+  static determineWinner(test: AbTest): AbVariant | null;
+  static calculateSignificance(variantA: AbVariant, variantB: AbVariant, criteria: string): number;
+  static private getMetricValue(variant: AbVariant, criteria: string): number;
+  static private hashString(str: string): number;
+}
+export default AbTesting;

package/dist/sms/advanced/analytics.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SMS Analytics
+ *
+ * Provides delivery rates, engagement metrics, and reporting
+ */
+export declare interface SmsMetrics {
+  period: string
+  sent: number
+  delivered: number
+  failed: number
+  pending: number
+  optedOut: number
+  deliveryRate: number
+  failureRate: number
+  averageDeliveryTime: number
+  cost: number
+}
+export declare interface SmsEngagement {
+  messageId: string
+  delivered: boolean
+  deliveredAt?: string
+  clicked?: boolean
+  clickedAt?: string
+  replied?: boolean
+  repliedAt?: string
+  replyContent?: string
+  optedOut?: boolean
+  optedOutAt?: string
+}
+export declare interface DeliveryReport {
+  messageId: string
+  to: string
+  status: 'PENDING' | 'SUCCESSFUL' | 'FAILED' | 'UNKNOWN'
+  statusCode?: string
+  statusMessage?: string
+  carrier?: string
+  countryCode?: string
+  priceInMillicents?: number
+  timestamp: string
+}
+/**
+ * SMS Analytics Module
+ */
+export declare class SmsAnalytics {
+  static AnalyticsAggregatorCode: any;
+  static DeliveryTrackerCode: any;
+  static createAnalyticsTable(config: { slug: string }): Record<string, any>;
+  static createDeliveryReportsTable(config: { slug: string }): Record<string, any>;
+  static createAnalyticsAggregatorLambda(config: {
+    slug: string
+    roleArn: string
+    messageLogTable: string
+    analyticsTable: string
+  }): Record<string, any>;
+}
+export default SmsAnalytics;

package/dist/sms/advanced/campaigns.d.ts

@@ -0,0 +1,82 @@
+/**
+ * SMS Campaigns and Scheduling
+ *
+ * Provides campaign management and scheduled SMS sending
+ */
+export declare interface SmsCampaign {
+  id: string
+  name: string
+  description?: string
+  status: 'draft' | 'scheduled' | 'running' | 'paused' | 'completed' | 'cancelled'
+  message: {
+    body: string
+    template?: string
+    variables?: string[]
+  }
+  audience: CampaignAudience
+  schedule: CampaignSchedule
+  settings: CampaignSettings
+  stats: CampaignStats
+  createdAt: string
+  updatedAt: string
+  startedAt?: string
+  completedAt?: string
+}
+export declare interface CampaignAudience {
+  type: 'list' | 'segment' | 'all'
+  listId?: string
+  segmentId?: string
+  filters?: AudienceFilter[]
+  estimatedSize?: number
+}
+export declare interface AudienceFilter {
+  field: string
+  operator: 'equals' | 'not-equals' | 'contains' | 'greater-than' | 'less-than'
+  value: string
+}
+export declare interface CampaignSchedule {
+  type: 'immediate' | 'scheduled' | 'recurring'
+  scheduledFor?: string
+  timezone?: string
+  recurrence?: {
+    frequency: 'daily' | 'weekly' | 'monthly'
+    interval: number
+    endDate?: string
+    maxOccurrences?: number
+  }
+}
+export declare interface CampaignSettings {
+  messageType: 'TRANSACTIONAL' | 'PROMOTIONAL'
+  senderId?: string
+  originationNumber?: string
+  throttleRate?: number
+  quietHours?: {
+    start: string // HH:MM
+    end: string
+    timezone: string
+  }
+  optOutHandling: boolean
+}
+export declare interface CampaignStats {
+  totalRecipients: number
+  sent: number
+  delivered: number
+  failed: number
+  optedOut: number
+  deliveryRate: number
+  cost: number
+}
+/**
+ * SMS Campaigns Module
+ */
+export declare class SmsCampaigns {
+  static CampaignManagerCode: any;
+  static CampaignExecutorCode: any;
+  static createCampaignsTable(config: { slug: string }): Record<string, any>;
+  static createCampaignManagerLambda(config: {
+    slug: string
+    roleArn: string
+    campaignsTable: string
+  }): Record<string, any>;
+}
+export default SmsCampaigns;

package/dist/sms/advanced/chatbot.d.ts

@@ -0,0 +1,48 @@
+/**
+ * SMS Chatbot Integration
+ *
+ * Provides conversational SMS with AI/rule-based responses
+ */
+export declare interface ChatbotConfig {
+  enabled: boolean
+  provider: 'rules' | 'bedrock' | 'openai' | 'custom'
+  welcomeMessage?: string
+  fallbackMessage?: string
+  sessionTimeout?: number
+  maxTurns?: number
+}
+export declare interface ChatSession {
+  sessionId: string
+  phoneNumber: string
+  startedAt: string
+  lastMessageAt: string
+  turnCount: number
+  context: Record<string, any>
+  status: 'active' | 'ended' | 'timeout'
+}
+export declare interface ChatRule {
+  id: string
+  priority: number
+  patterns: string[]
+  response: string
+  action?: 'respond' | 'transfer' | 'end' | 'webhook'
+  actionParams?: Record<string, any>
+}
+/**
+ * SMS Chatbot Module
+ */
+export declare class SmsChatbot {
+  static ChatbotProcessorCode: string;
+  static createSessionsTable(config: { slug: string }): Record<string, any>;
+  static createRulesTable(config: { slug: string }): Record<string, any>;
+  static createChatbotProcessorLambda(config: {
+    slug: string
+    roleArn: string
+    sessionsTable: string
+    rulesTable: string
+    chatbotConfig: ChatbotConfig
+    originationNumber?: string
+  }): Record<string, any>;
+  static readonly DefaultRules: ChatRule[];
+}
+export default SmsChatbot;

package/dist/sms/advanced/index.d.ts

@@ -0,0 +1,6 @@
+export * from './campaigns';
+export * from './analytics';
+export * from './mms';
+export * from './chatbot';
+export * from './link-tracking';
+export * from './ab-testing';

package/dist/sms/advanced/link-tracking.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Link Shortening and Tracking
+ *
+ * Provides URL shortening and click tracking for SMS
+ */
+export declare interface ShortenedLink {
+  id: string
+  originalUrl: string
+  shortUrl: string
+  campaignId?: string
+  messageId?: string
+  clicks: number
+  uniqueClicks: number
+  createdAt: string
+  expiresAt?: string
+}
+export declare interface LinkClick {
+  linkId: string
+  clickedAt: string
+  userAgent?: string
+  ipAddress?: string
+  country?: string
+  device?: string
+}
+/**
+ * Link Tracking Module
+ */
+export declare class LinkTracking {
+  static LinkShortenerCode: any;
+  static createLinksTable(config: { slug: string }): Record<string, any>;
+  static createLinkShortenerLambda(config: {
+    slug: string
+    roleArn: string
+    linksTable: string
+    shortDomain?: string
+  }): Record<string, any>;
+  static shortenUrlsInMessage(message: string, shortDomain: string, linkIdPrefix: string): {
+    message: string
+    links: Array<{ original: string; short: string; id: string }>
+  };
+}
+export default LinkTracking;

package/dist/sms/advanced/mms.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MMS Support (Images, Media)
+ *
+ * Provides multimedia messaging capabilities
+ */
+export declare interface MmsMessage {
+  to: string
+  body?: string
+  mediaUrls: string[]
+  mediaType?: 'image' | 'video' | 'audio' | 'document'
+  fallbackSms?: string
+}
+export declare interface MmsMedia {
+  url: string
+  contentType: string
+  size: number
+  filename?: string
+}
+/**
+ * MMS Module
+ */
+export declare class MmsSupport {
+  static MmsSenderCode: any;
+  static createMediaBucket(config: { slug: string }): Record<string, any>;
+  static createMmsSenderLambda(config: {
+    slug: string
+    roleArn: string
+    mediaBucket: string
+    messageLogTable: string
+    originationNumber?: string
+  }): Record<string, any>;
+  static readonly SupportedMediaTypes: any;
+  static readonly MediaSizeLimits: { image: number, video: number, audio: number };
+}
+export default MmsSupport;

package/{src/sms/handlers/delivery-status.ts → dist/sms/handlers/delivery-status.d.ts}

@@ -6,8 +6,7 @@
  * - Update message status
  * - Handle failures
  */
-
-export const handler = `
+export declare const handler: `
 const { DynamoDBClient, UpdateItemCommand } = require('@aws-sdk/client-dynamodb');
 const { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');
 
@@ -128,6 +127,5 @@ exports.handler = async (event) => {
 
   return { statusCode: 200, body: 'OK' };
 };
-`
-
-export default handler
+`;
+export default handler;

package/{src/sms/handlers/receive.ts → dist/sms/handlers/receive.d.ts}

@@ -6,8 +6,7 @@
  * - Handle opt-out keywords
  * - Forward to webhook
  */
-
-export const handler = `
+export declare const handler: `
 const { DynamoDBClient, PutItemCommand, GetItemCommand, DeleteItemCommand } = require('@aws-sdk/client-dynamodb');
 const { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');
 
@@ -157,6 +156,5 @@ exports.handler = async (event) => {
 
   return { statusCode: 200, body: 'OK' };
 };
-`
-
-export default handler
+`;
+export default handler;

package/{src/sms/handlers/send.ts → dist/sms/handlers/send.d.ts}

@@ -6,8 +6,7 @@
  * - Handle templated messages
  * - Track delivery status
  */
-
-export const handler = `
+export declare const handler: `
 const { PinpointClient, SendMessagesCommand } = require('@aws-sdk/client-pinpoint');
 const { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');
 const { DynamoDBClient, PutItemCommand } = require('@aws-sdk/client-dynamodb');
@@ -169,6 +168,5 @@ function resolveTemplate(template, data) {
   }
   return result;
 }
-`
-
-export default handler
+`;
+export default handler;

package/dist/sms/index.d.ts

@@ -0,0 +1,2 @@
+export * as SmsAdvanced from './advanced';
+export * as SmsHandlers from './handlers/send';

package/dist/stack-diff.d.ts

@@ -0,0 +1,34 @@
+import type { CloudFormationTemplate } from '@stacksjs/ts-cloud-aws-types';
+/**
+ * Analyze differences between two CloudFormation templates
+ */
+export declare function analyzeStackDiff(oldTemplate: CloudFormationTemplate, newTemplate: CloudFormationTemplate): StackDiff;
+/**
+ * Format diff for display
+ */
+export declare function formatDiff(diff: StackDiff): string;
+export declare interface ResourceDiff {
+  logicalId: string
+  action: 'add' | 'remove' | 'update' | 'replace'
+  resourceType: string
+  changes?: PropertyChange[]
+  reason?: string
+}
+export declare interface PropertyChange {
+  path: string
+  oldValue: any
+  newValue: any
+  requiresReplacement?: boolean
+}
+export declare interface StackDiff {
+  added: ResourceDiff[]
+  removed: ResourceDiff[]
+  updated: ResourceDiff[]
+  replaced: ResourceDiff[]
+  unchanged: string[]
+  summary: {
+    totalChanges: number
+    requiresReplacement: boolean
+    dangerousChanges: string[]
+  }
+}

package/dist/static-site/index.d.ts

@@ -0,0 +1,49 @@
+export declare const staticSiteManager: StaticSiteManager;
+/**
+ * Static Site Advanced Features
+ * Asset optimization, image optimization, SSG support, and prerendering
+ */
+export declare interface AssetOptimization {
+  id: string
+  name: string
+  minify: boolean
+  compress: boolean
+  compressionType: 'gzip' | 'brotli' | 'both'
+  sourceMaps: boolean
+  cacheControl: string
+}
+export declare interface ImageOptimization {
+  id: string
+  formats: Array<'webp' | 'avif' | 'jpeg' | 'png'>
+  quality: number
+  responsive: boolean
+  lazy: boolean
+  sizes: number[]
+}
+export declare interface SSGConfig {
+  id: string
+  framework: 'next' | 'gatsby' | 'astro' | 'hugo' | 'eleventy'
+  outputDir: string
+  buildCommand: string
+  routes: string[]
+}
+export declare interface PrerenderConfig {
+  id: string
+  routes: string[]
+  fallback: 'blocking' | 'static' | false
+  revalidate?: number
+}
+export declare class StaticSiteManager {
+  private optimizations: Map<string, AssetOptimization>;
+  private imageConfigs: Map<string, ImageOptimization>;
+  private ssgConfigs: Map<string, SSGConfig>;
+  private prerenderConfigs: Map<string, PrerenderConfig>;
+  private counter: any;
+  createAssetOptimization(config: Omit<AssetOptimization, 'id'>): AssetOptimization;
+  createImageOptimization(config: Omit<ImageOptimization, 'id'>): ImageOptimization;
+  createSSGConfig(config: Omit<SSGConfig, 'id'>): SSGConfig;
+  createPrerenderConfig(config: Omit<PrerenderConfig, 'id'>): PrerenderConfig;
+  listOptimizations(): AssetOptimization[];
+  listImageConfigs(): ImageOptimization[];
+  clear(): void;
+}

package/dist/template-builder.d.ts

@@ -0,0 +1,14 @@
+import type { CloudFormationResource, CloudFormationTemplate } from '@stacksjs/ts-cloud-aws-types';
+export declare class TemplateBuilder {
+  private template: CloudFormationTemplate;
+  constructor(description?: string);
+  addResource(logicalId: string, resource: CloudFormationResource): this;
+  addResources(resources: Record<string, CloudFormationResource>): this;
+  addParameter(name: string, parameter: NonNullable<CloudFormationTemplate['Parameters']>[string]): this;
+  addOutput(name: string, output: NonNullable<CloudFormationTemplate['Outputs']>[string]): this;
+  getResources(): Record<string, CloudFormationResource>;
+  build(): CloudFormationTemplate;
+  toJSON(pretty?: any): string;
+  toYAML(): string;
+  private convertToYAML(obj: any, indent?: any): string;
+}

package/dist/template-validator.d.ts

@@ -0,0 +1,24 @@
+import type { CloudFormationTemplate } from '@stacksjs/ts-cloud-aws-types';
+/**
+ * Validate a CloudFormation template
+ */
+export declare function validateTemplate(template: CloudFormationTemplate): ValidationResult;
+/**
+ * Validate template size
+ */
+export declare function validateTemplateSize(templateJson: string): ValidationResult;
+/**
+ * Validate resource limits
+ */
+export declare function validateResourceLimits(template: CloudFormationTemplate): ValidationResult;
+export declare interface ValidationError {
+  path: string
+  message: string
+  severity: 'error' | 'warning' | 'info'
+}
+export declare interface ValidationResult {
+  valid: boolean
+  errors: ValidationError[]
+  warnings: ValidationError[]
+  info: ValidationError[]
+}

package/dist/utils/cache.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Global template cache instance
+ */
+export declare const templateCache: TemplateCache;
+export declare interface CacheOptions {
+  ttl?: number
+  maxSize?: number
+}
+export declare interface CacheEntry<T> {
+  value: T
+  timestamp: number
+  hash?: string
+}
+/**
+ * Simple in-memory cache with TTL support
+ */
+export declare class Cache<T = any> {
+  private cache: Map<string, CacheEntry<T>>;
+  private ttl: number;
+  private maxSize: number;
+  constructor(options?: CacheOptions);
+  get(key: string): T | undefined;
+  set(key: string, value: T, hash?: string): void;
+  has(key: string): boolean;
+  clear(): void;
+  prune(): void;
+  stats(): { size: number, ttl: number, maxSize: number };
+}
+/**
+ * File-based cache for persistent caching
+ */
+export declare class FileCache<T = any> {
+  private cacheDir: string;
+  private ttl: number;
+  constructor(cacheDir: string, options?: CacheOptions);
+  private getCachePath(key: string): string;
+  get(key: string): T | undefined;
+  set(key: string, value: T, hash?: string): void;
+  has(key: string): boolean;
+  clear(): void;
+  prune(): void;
+}
+/**
+ * Template cache for CloudFormation templates
+ */
+export declare class TemplateCache {
+  private cache: FileCache<string>;
+  constructor(cacheDir?: string);
+  getTemplate(stackName: string): string | undefined;
+  setTemplate(stackName: string, template: string): void;
+  hasChanged(stackName: string, newTemplate: string): boolean;
+  private hashTemplate(template: string): string;
+  clear(): void;
+  prune(): void;
+}