@ts-cloud/core 0.2.3 → 0.2.5

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

@@ -0,0 +1,60 @@
+/**
+ * Link Shortening and Tracking
+ *
+ * Provides URL shortening and click tracking for SMS
+ */
+export interface ShortenedLink {
+    id: string;
+    originalUrl: string;
+    shortUrl: string;
+    campaignId?: string;
+    messageId?: string;
+    clicks: number;
+    uniqueClicks: number;
+    createdAt: string;
+    expiresAt?: string;
+}
+export interface LinkClick {
+    linkId: string;
+    clickedAt: string;
+    userAgent?: string;
+    ipAddress?: string;
+    country?: string;
+    device?: string;
+}
+/**
+ * Link Tracking Module
+ */
+export declare class LinkTracking {
+    /**
+     * Lambda code for link shortening
+     */
+    static LinkShortenerCode: string;
+    /**
+     * Create links DynamoDB table
+     */
+    static createLinksTable(config: {
+        slug: string;
+    }): Record<string, any>;
+    /**
+     * Create link shortener Lambda
+     */
+    static createLinkShortenerLambda(config: {
+        slug: string;
+        roleArn: string;
+        linksTable: string;
+        shortDomain?: string;
+    }): Record<string, any>;
+    /**
+     * Shorten URLs in message text
+     */
+    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,60 @@
+/**
+ * MMS Support (Images, Media)
+ *
+ * Provides multimedia messaging capabilities
+ */
+export interface MmsMessage {
+    to: string;
+    body?: string;
+    mediaUrls: string[];
+    mediaType?: 'image' | 'video' | 'audio' | 'document';
+    fallbackSms?: string;
+}
+export interface MmsMedia {
+    url: string;
+    contentType: string;
+    size: number;
+    filename?: string;
+}
+/**
+ * MMS Module
+ */
+export declare class MmsSupport {
+    /**
+     * Lambda code for MMS sending
+     */
+    static MmsSenderCode: string;
+    /**
+     * Create media storage bucket
+     */
+    static createMediaBucket(config: {
+        slug: string;
+    }): Record<string, any>;
+    /**
+     * Create MMS sender Lambda
+     */
+    static createMmsSenderLambda(config: {
+        slug: string;
+        roleArn: string;
+        mediaBucket: string;
+        messageLogTable: string;
+        originationNumber?: string;
+    }): Record<string, any>;
+    /**
+     * Supported media types
+     */
+    static readonly SupportedMediaTypes: {
+        readonly image: readonly ["image/jpeg", "image/png", "image/gif"];
+        readonly video: readonly ["video/mp4", "video/3gpp"];
+        readonly audio: readonly ["audio/mpeg", "audio/wav"];
+    };
+    /**
+     * Media size limits (in bytes)
+     */
+    static readonly MediaSizeLimits: {
+        image: number;
+        video: number;
+        audio: number;
+    };
+}
+export default MmsSupport;

package/dist/sms/handlers/__tests__/send.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sms/handlers/delivery-status.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SMS Delivery Status Lambda Handler
+ *
+ * Processes delivery status updates:
+ * - Process delivery receipts
+ * - Update message status
+ * - Handle failures
+ */
+export declare const handler = "\nconst { DynamoDBClient, UpdateItemCommand } = require('@aws-sdk/client-dynamodb');\nconst { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');\n\nconst dynamodb = new DynamoDBClient({});\nconst sns = new SNSClient({});\n\nexports.handler = async (event) => {\n  console.log('SMS delivery status event:', JSON.stringify(event, null, 2));\n\n  const messageLogTable = process.env.MESSAGE_LOG_TABLE;\n  const notificationTopicArn = process.env.NOTIFICATION_TOPIC_ARN;\n  const webhookUrl = process.env.WEBHOOK_URL;\n\n  for (const record of event.Records) {\n    try {\n      // Parse delivery status from SNS/Pinpoint\n      const message = JSON.parse(record.Sns?.Message || record.body || '{}');\n\n      const {\n        eventType,\n        messageId,\n        destinationPhoneNumber,\n        messageStatus,\n        messageStatusDescription,\n        isoCountryCode,\n        mcc,\n        mnc,\n        priceInMillicentsUSD,\n      } = message;\n\n      if (!messageId) {\n        console.log('No messageId in delivery status');\n        continue;\n      }\n\n      const timestamp = new Date().toISOString();\n      const status = messageStatus || eventType || 'UNKNOWN';\n\n      console.log(`Delivery status for ${messageId}: ${status}`);\n\n      // Update message log\n      if (messageLogTable) {\n        await dynamodb.send(new UpdateItemCommand({\n          TableName: messageLogTable,\n          Key: {\n            messageId: { S: messageId },\n          },\n          UpdateExpression: 'SET deliveryStatus = :status, statusDescription = :desc, deliveredAt = :at, priceMillicents = :price, countryCode = :country',\n          ExpressionAttributeValues: {\n            ':status': { S: status },\n            ':desc': { S: messageStatusDescription || '' },\n            ':at': { S: timestamp },\n            ':price': { N: String(priceInMillicentsUSD || 0) },\n            ':country': { S: isoCountryCode || '' },\n          },\n        }));\n      }\n\n      // Handle failures - notify admin\n      const isFailure = ['FAILED', 'UNREACHABLE', 'UNKNOWN', 'CARRIER_UNREACHABLE', 'BLOCKED', 'CARRIER_BLOCKED', 'INVALID', 'INVALID_MESSAGE', 'OPTED_OUT'].includes(status);\n\n      if (isFailure) {\n        console.log(`SMS delivery failed: ${status} - ${messageStatusDescription}`);\n\n        // Send failure notification\n        if (notificationTopicArn) {\n          await sns.send(new PublishCommand({\n            TopicArn: notificationTopicArn,\n            Subject: `SMS Delivery Failed: ${status}`,\n            Message: JSON.stringify({\n              type: 'sms_delivery_failed',\n              messageId,\n              to: destinationPhoneNumber,\n              status,\n              description: messageStatusDescription,\n              countryCode: isoCountryCode,\n              timestamp,\n            }, null, 2),\n            MessageAttributes: {\n              eventType: {\n                DataType: 'String',\n                StringValue: 'sms_delivery_failed',\n              },\n            },\n          }));\n        }\n      }\n\n      // Forward to webhook for all status updates\n      if (webhookUrl) {\n        try {\n          await fetch(webhookUrl, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({\n              event: 'sms_delivery_status',\n              data: {\n                messageId,\n                to: destinationPhoneNumber,\n                status,\n                description: messageStatusDescription,\n                countryCode: isoCountryCode,\n                carrier: { mcc, mnc },\n                priceMillicents: priceInMillicentsUSD,\n                timestamp,\n              },\n            }),\n          });\n        }\ncatch (err) {\n          console.error('Webhook failed:', err.message);\n        }\n      }\n\n    }\ncatch (error) {\n      console.error('Error processing delivery status:', error);\n    }\n  }\n\n  return { statusCode: 200, body: 'OK' };\n};\n";
+export default handler;

package/dist/sms/handlers/receive.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SMS Receive Lambda Handler
+ *
+ * Processes inbound SMS messages:
+ * - Process inbound SMS (two-way)
+ * - Handle opt-out keywords
+ * - Forward to webhook
+ */
+export declare const handler = "\nconst { DynamoDBClient, PutItemCommand, DeleteItemCommand } = require('@aws-sdk/client-dynamodb');\nconst { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');\n\nconst dynamodb = new DynamoDBClient({});\nconst sns = new SNSClient({});\n\nconst OPT_OUT_KEYWORDS = ['STOP', 'UNSUBSCRIBE', 'CANCEL', 'END', 'QUIT', 'OPTOUT', 'OPT OUT'];\nconst OPT_IN_KEYWORDS = ['START', 'SUBSCRIBE', 'OPTIN', 'OPT IN', 'YES'];\n\nexports.handler = async (event) => {\n  console.log('SMS receive event:', JSON.stringify(event, null, 2));\n\n  const optOutTable = process.env.OPT_OUT_TABLE;\n  const messageLogTable = process.env.MESSAGE_LOG_TABLE;\n  const notificationTopicArn = process.env.NOTIFICATION_TOPIC_ARN;\n  const webhookUrl = process.env.WEBHOOK_URL;\n\n  for (const record of event.Records) {\n    try {\n      // Parse SNS message from Pinpoint\n      const message = JSON.parse(record.Sns?.Message || record.body || '{}');\n\n      const {\n        originationNumber,\n        destinationNumber,\n        messageBody,\n        messageKeyword,\n        inboundMessageId,\n      } = message;\n\n      if (!originationNumber || !messageBody) {\n        console.log('Missing required fields');\n        continue;\n      }\n\n      const timestamp = new Date().toISOString();\n      const normalizedBody = messageBody.trim().toUpperCase();\n\n      // Check for opt-out keywords\n      if (OPT_OUT_KEYWORDS.some(kw => normalizedBody === kw || normalizedBody.startsWith(kw + ' '))) {\n        console.log(`Opt-out request from ${originationNumber}`);\n\n        if (optOutTable) {\n          await dynamodb.send(new PutItemCommand({\n            TableName: optOutTable,\n            Item: {\n              phoneNumber: { S: originationNumber },\n              optedOutAt: { S: timestamp },\n              keyword: { S: normalizedBody.split(' ')[0] },\n              originalMessage: { S: messageBody },\n            },\n          }));\n        }\n\n        // Send confirmation (optional - check carrier requirements)\n        // await sendOptOutConfirmation(originationNumber, destinationNumber);\n\n        continue;\n      }\n\n      // Check for opt-in keywords\n      if (OPT_IN_KEYWORDS.some(kw => normalizedBody === kw || normalizedBody.startsWith(kw + ' '))) {\n        console.log(`Opt-in request from ${originationNumber}`);\n\n        if (optOutTable) {\n          await dynamodb.send(new DeleteItemCommand({\n            TableName: optOutTable,\n            Key: {\n              phoneNumber: { S: originationNumber },\n            },\n          }));\n        }\n\n        continue;\n      }\n\n      // Log inbound message\n      if (messageLogTable) {\n        await dynamodb.send(new PutItemCommand({\n          TableName: messageLogTable,\n          Item: {\n            messageId: { S: inboundMessageId || `inbound-${Date.now()}` },\n            direction: { S: 'inbound' },\n            from: { S: originationNumber },\n            to: { S: destinationNumber },\n            body: { S: messageBody },\n            keyword: { S: messageKeyword || '' },\n            receivedAt: { S: timestamp },\n            ttl: { N: String(Math.floor(Date.now() / 1000) + 90 * 24 * 60 * 60) },\n          },\n        }));\n      }\n\n      // Send SNS notification\n      if (notificationTopicArn) {\n        await sns.send(new PublishCommand({\n          TopicArn: notificationTopicArn,\n          Subject: 'Inbound SMS',\n          Message: JSON.stringify({\n            type: 'inbound_sms',\n            from: originationNumber,\n            to: destinationNumber,\n            body: messageBody,\n            keyword: messageKeyword,\n            timestamp,\n          }, null, 2),\n          MessageAttributes: {\n            eventType: {\n              DataType: 'String',\n              StringValue: 'inbound_sms',\n            },\n          },\n        }));\n      }\n\n      // Forward to webhook\n      if (webhookUrl) {\n        try {\n          const response = await fetch(webhookUrl, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({\n              event: 'inbound_sms',\n              data: {\n                from: originationNumber,\n                to: destinationNumber,\n                body: messageBody,\n                keyword: messageKeyword,\n                messageId: inboundMessageId,\n                timestamp,\n              },\n            }),\n          });\n\n          console.log(`Webhook response: ${response.status}`);\n        }\ncatch (err) {\n          console.error('Webhook failed:', err.message);\n        }\n      }\n\n      console.log(`Processed inbound SMS from ${originationNumber}`);\n\n    }\ncatch (error) {\n      console.error('Error processing inbound SMS:', error);\n    }\n  }\n\n  return { statusCode: 200, body: 'OK' };\n};\n";
+export default handler;

package/dist/sms/handlers/send.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SMS Send Lambda Handler
+ *
+ * Sends SMS messages:
+ * - Send SMS via Pinpoint/SNS
+ * - Handle templated messages
+ * - Track delivery status
+ */
+export declare const handler = "\nconst { PinpointClient, SendMessagesCommand } = require('@aws-sdk/client-pinpoint');\nconst { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');\nconst { DynamoDBClient, PutItemCommand } = require('@aws-sdk/client-dynamodb');\n\nconst pinpoint = new PinpointClient({});\nconst sns = new SNSClient({});\nconst dynamodb = new DynamoDBClient({});\n\nexports.handler = async (event) => {\n  console.log('SMS send event:', JSON.stringify(event, null, 2));\n\n  const applicationId = process.env.PINPOINT_APP_ID;\n  const messageLogTable = process.env.MESSAGE_LOG_TABLE;\n  const senderId = process.env.SMS_SENDER_ID;\n  const originationNumber = process.env.SMS_ORIGINATION_NUMBER;\n\n  // Handle both direct invocation and SQS/SNS events\n  const messages = event.Records\n    ? event.Records.map(r => JSON.parse(r.body || r.Sns?.Message || '{}'))\n    : [event];\n\n  const results = [];\n\n  for (const message of messages) {\n    try {\n      const {\n        to,\n        body,\n        template,\n        templateData,\n        messageType = 'TRANSACTIONAL',\n      } = message;\n\n      if (!to || (!body && !template)) {\n        console.log('Missing required fields (to, body/template)');\n        continue;\n      }\n\n      // Resolve template if provided\n      let messageBody = body;\n      if (template && templateData) {\n        messageBody = resolveTemplate(template, templateData);\n      }\n\n      const messageId = `sms-${Date.now()}-${Math.random().toString(36).substr(2)}`;\n\n      // Send via Pinpoint if app ID is configured\n      if (applicationId) {\n        const sendResult = await pinpoint.send(new SendMessagesCommand({\n          ApplicationId: applicationId,\n          MessageRequest: {\n            Addresses: {\n              [to]: {\n                ChannelType: 'SMS',\n              },\n            },\n            MessageConfiguration: {\n              SMSMessage: {\n                Body: messageBody,\n                MessageType: messageType,\n                SenderId: senderId,\n                OriginationNumber: originationNumber,\n              },\n            },\n          },\n        }));\n\n        const result = sendResult.MessageResponse?.Result?.[to] || {};\n\n        // Log message\n        if (messageLogTable) {\n          await dynamodb.send(new PutItemCommand({\n            TableName: messageLogTable,\n            Item: {\n              messageId: { S: result.MessageId || messageId },\n              to: { S: to },\n              body: { S: messageBody },\n              messageType: { S: messageType },\n              deliveryStatus: { S: result.DeliveryStatus || 'UNKNOWN' },\n              statusCode: { N: String(result.StatusCode || 0) },\n              statusMessage: { S: result.StatusMessage || '' },\n              sentAt: { S: new Date().toISOString() },\n              ttl: { N: String(Math.floor(Date.now() / 1000) + 90 * 24 * 60 * 60) },\n            },\n          }));\n        }\n\n        results.push({\n          to,\n          messageId: result.MessageId || messageId,\n          status: result.DeliveryStatus,\n          statusCode: result.StatusCode,\n        });\n\n      }\nelse {\n        // Fallback to SNS\n        const snsResult = await sns.send(new PublishCommand({\n          PhoneNumber: to,\n          Message: messageBody,\n          MessageAttributes: {\n            'AWS.SNS.SMS.SMSType': {\n              DataType: 'String',\n              StringValue: messageType === 'PROMOTIONAL' ? 'Promotional' : 'Transactional',\n            },\n            ...(senderId && {\n              'AWS.SNS.SMS.SenderID': {\n                DataType: 'String',\n                StringValue: senderId,\n              },\n            }),\n          },\n        }));\n\n        // Log message\n        if (messageLogTable) {\n          await dynamodb.send(new PutItemCommand({\n            TableName: messageLogTable,\n            Item: {\n              messageId: { S: snsResult.MessageId || messageId },\n              to: { S: to },\n              body: { S: messageBody },\n              messageType: { S: messageType },\n              deliveryStatus: { S: 'SENT' },\n              sentAt: { S: new Date().toISOString() },\n              ttl: { N: String(Math.floor(Date.now() / 1000) + 90 * 24 * 60 * 60) },\n            },\n          }));\n        }\n\n        results.push({\n          to,\n          messageId: snsResult.MessageId || messageId,\n          status: 'SENT',\n        });\n      }\n\n      console.log(`SMS sent to ${to}: ${results[results.length - 1].status}`);\n\n    }\ncatch (error) {\n      console.error('Error sending SMS:', error);\n      results.push({\n        to: message.to,\n        error: error.message,\n        status: 'FAILED',\n      });\n    }\n  }\n\n  return {\n    statusCode: 200,\n    body: JSON.stringify({ results }),\n  };\n};\n\nfunction resolveTemplate(template, data) {\n  let result = template;\n  for (const [key, value] of Object.entries(data)) {\n    result = result.replace(new RegExp(`{{\\\\s*${key}\\\\s*}}`, 'g'), value);\n  }\n  return result;\n}\n";
+export default handler;

package/dist/sms/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SMS Advanced Features
+ */
+export * as SmsAdvanced from './advanced';
+export * as SmsHandlers from './handlers/send';

package/dist/stack-diff.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Stack Diff Analyzer
+ * Analyzes differences between CloudFormation templates for stack updates
+ */
+import type { CloudFormationTemplate } from '@ts-cloud/aws-types';
+export interface ResourceDiff {
+    logicalId: string;
+    action: 'add' | 'remove' | 'update' | 'replace';
+    resourceType: string;
+    changes?: PropertyChange[];
+    reason?: string;
+}
+export interface PropertyChange {
+    path: string;
+    oldValue: any;
+    newValue: any;
+    requiresReplacement?: boolean;
+}
+export interface StackDiff {
+    added: ResourceDiff[];
+    removed: ResourceDiff[];
+    updated: ResourceDiff[];
+    replaced: ResourceDiff[];
+    unchanged: string[];
+    summary: {
+        totalChanges: number;
+        requiresReplacement: boolean;
+        dangerousChanges: string[];
+    };
+}
+/**
+ * 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;

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

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

package/dist/template-builder.d.ts

@@ -0,0 +1,42 @@
+import type { CloudFormationResource, CloudFormationTemplate } from '@ts-cloud/aws-types';
+export declare class TemplateBuilder {
+    private template;
+    constructor(description?: string);
+    /**
+     * Add a resource to the template
+     */
+    addResource(logicalId: string, resource: CloudFormationResource): this;
+    /**
+     * Add multiple resources to the template
+     */
+    addResources(resources: Record<string, CloudFormationResource>): this;
+    /**
+     * Add a parameter to the template
+     */
+    addParameter(name: string, parameter: NonNullable<CloudFormationTemplate['Parameters']>[string]): this;
+    /**
+     * Add an output to the template
+     */
+    addOutput(name: string, output: NonNullable<CloudFormationTemplate['Outputs']>[string]): this;
+    /**
+     * Check if a resource already exists in the template
+     */
+    hasResource(logicalId: string): boolean;
+    /**
+     * Get resources from the template
+     */
+    getResources(): Record<string, CloudFormationResource>;
+    /**
+     * Build and return the CloudFormation template
+     */
+    build(): CloudFormationTemplate;
+    /**
+     * Convert template to JSON string
+     */
+    toJSON(pretty?: boolean): string;
+    /**
+     * Convert template to YAML string (simple implementation)
+     */
+    toYAML(): string;
+    private convertToYAML;
+}

package/dist/template-validator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CloudFormation Template Validator
+ * Validates CloudFormation templates for correctness and best practices
+ */
+import type { CloudFormationTemplate } from '@ts-cloud/aws-types';
+export interface ValidationError {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning' | 'info';
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+    info: ValidationError[];
+}
+/**
+ * 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;