@stacksjs/ts-cloud-core 0.1.3 → 0.1.7

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

@@ -0,0 +1,78 @@
+/**
+ * Email Analytics
+ *
+ * Provides open tracking, click tracking, and email metrics
+ */
+export declare interface EmailAnalytics {
+  messageId: string
+  sent: boolean
+  sentAt?: string
+  delivered: boolean
+  deliveredAt?: string
+  opened: boolean
+  openedAt?: string
+  openCount: number
+  clicked: boolean
+  clickedAt?: string
+  clickCount: number
+  clicks: ClickEvent[]
+  bounced: boolean
+  bouncedAt?: string
+  bounceType?: string
+  complained: boolean
+  complainedAt?: string
+  unsubscribed: boolean
+  unsubscribedAt?: string
+}
+export declare interface ClickEvent {
+  url: string
+  clickedAt: string
+  userAgent?: string
+  ipAddress?: string
+}
+export declare interface EmailMetrics {
+  period: string
+  sent: number
+  delivered: number
+  opened: number
+  clicked: number
+  bounced: number
+  complained: number
+  unsubscribed: number
+  deliveryRate: number
+  openRate: number
+  clickRate: number
+  bounceRate: number
+  complaintRate: number
+}
+/**
+ * Email Analytics Module
+ */
+export declare class EmailAnalyticsModule {
+  static TrackingPixelLambdaCode: any;
+  static ClickTrackingLambdaCode: any;
+  static SesEventProcessorCode: any;
+  static createAnalyticsTable(config: { slug: string }): Record<string, any>;
+  static createTrackingPixelLambda(config: {
+    slug: string
+    roleArn: string
+    analyticsTable: string
+  }): Record<string, any>;
+  static createClickTrackingLambda(config: {
+    slug: string
+    roleArn: string
+    analyticsTable: string
+  }): Record<string, any>;
+  static createSesEventProcessorLambda(config: {
+    slug: string
+    roleArn: string
+    analyticsTable: string
+  }): Record<string, any>;
+  static injectTracking(params: {
+    html: string
+    messageId: string
+    trackingDomain: string
+  }): string;
+  static calculateMetrics(analytics: EmailAnalytics[]): EmailMetrics;
+}
+export default EmailAnalyticsModule;

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

@@ -0,0 +1,7 @@
+export * from './search';
+export * from './threading';
+export * from './scheduling';
+export * from './analytics';
+export * from './templates';
+export * from './shared-mailboxes';
+export * from './rules';

package/dist/email/advanced/rules.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Email Rules and Automation
+ *
+ * Provides email filtering, routing, and automation
+ */
+export declare interface EmailRule {
+  id: string
+  name: string
+  enabled: boolean
+  priority: number
+  conditions: RuleCondition[]
+  conditionOperator: 'and' | 'or'
+  actions: RuleAction[]
+  createdAt: string
+  updatedAt: string
+}
+export declare interface RuleCondition {
+  field: 'from' | 'to' | 'subject' | 'body' | 'headers' | 'attachments' | 'size'
+  operator: 'contains' | 'not-contains' | 'equals' | 'not-equals' | 'starts-with' | 'ends-with' | 'regex' | 'greater-than' | 'less-than'
+  value: string
+  caseSensitive?: boolean
+}
+export declare interface RuleAction {
+  type: 'move' | 'copy' | 'delete' | 'label' | 'forward' | 'reply' | 'mark-read' | 'mark-starred' | 'webhook' | 'lambda'
+  params: Record<string, any>
+}
+export declare interface AutomationWorkflow {
+  id: string
+  name: string
+  trigger: WorkflowTrigger
+  steps: WorkflowStep[]
+  enabled: boolean
+}
+export declare interface WorkflowTrigger {
+  type: 'email-received' | 'email-sent' | 'schedule' | 'webhook'
+  conditions?: RuleCondition[]
+}
+export declare interface WorkflowStep {
+  id: string
+  type: 'delay' | 'condition' | 'action' | 'loop'
+  config: Record<string, any>
+  next?: string
+  onTrue?: string
+  onFalse?: string
+}
+/**
+ * Email Rules Module
+ */
+export declare class EmailRules {
+  static RuleProcessorCode: any;
+  static createRulesTable(config: { slug: string }): Record<string, any>;
+  static createRuleProcessorLambda(config: {
+    slug: string
+    roleArn: string
+    emailBucket: string
+    rulesTable: string
+  }): Record<string, any>;
+  static readonly RuleTemplates: any;
+}
+export default EmailRules;

package/dist/email/advanced/scheduling.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Email Scheduling (Send Later)
+ *
+ * Provides scheduled email sending functionality
+ */
+export declare interface ScheduledEmail {
+  id: string
+  email: {
+    from: string
+    to: string | string[]
+    cc?: string[]
+    bcc?: string[]
+    subject: string
+    html?: string
+    text?: string
+    attachments?: Array<{
+      filename: string
+      content: string
+      contentType?: string
+    }>
+  }
+  scheduledFor: string
+  timezone?: string
+  status: 'pending' | 'sent' | 'failed' | 'cancelled'
+  createdAt: string
+  sentAt?: string
+  error?: string
+  retryCount?: number
+}
+/**
+ * Email Scheduling Module
+ */
+export declare class EmailScheduling {
+  static SchedulerLambdaCode: any;
+  static createSchedulerLambda(config: {
+    slug: string
+    roleArn: string
+    emailBucket: string
+  }): Record<string, any>;
+  static createSchedulerRule(config: {
+    slug: string
+    lambdaArn: string
+    scheduleExpression?: string
+  }): Record<string, any>;
+  static scheduleEmail(params: {
+    s3Client: any
+    bucket: string
+    email: ScheduledEmail['email']
+    scheduledFor: Date | string
+    timezone?: string
+  }): Promise<ScheduledEmail>;
+  static cancelScheduledEmail(params: {
+    s3Client: any
+    bucket: string
+    id: string
+  }): Promise<boolean>;
+  static listScheduledEmails(params: {
+    s3Client: any
+    bucket: string
+    status?: ScheduledEmail['status']
+  }): Promise<ScheduledEmail[]>;
+}
+export default EmailScheduling;

package/dist/email/advanced/search.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Email Search and Indexing
+ *
+ * Provides OpenSearch integration for email search functionality
+ */
+export declare interface EmailSearchConfig {
+  slug: string
+  environment: string
+  domainName?: string
+  instanceType?: string
+  instanceCount?: number
+  ebsVolumeSize?: number
+  masterUserName?: string
+  masterUserPassword?: string
+}
+export declare interface EmailSearchDocument {
+  messageId: string
+  from: string
+  fromName?: string
+  to: string
+  toName?: string
+  cc?: string[]
+  subject: string
+  body: string
+  bodyPreview: string
+  date: string
+  receivedAt: string
+  hasAttachments: boolean
+  attachmentNames?: string[]
+  labels?: string[]
+  folder: string
+  threadId?: string
+  isRead: boolean
+  isStarred?: boolean
+  mailbox: string
+}
+export declare interface SearchQuery {
+  query: string
+  from?: string
+  to?: string
+  subject?: string
+  hasAttachments?: boolean
+  dateFrom?: string
+  dateTo?: string
+  folder?: string
+  labels?: string[]
+  isRead?: boolean
+  limit?: number
+  offset?: number
+  sort?: 'date' | 'relevance'
+  sortOrder?: 'asc' | 'desc'
+}
+export declare interface SearchResult {
+  total: number
+  hits: Array<{
+    score: number
+    document: EmailSearchDocument
+    highlights?: Record<string, string[]>
+  }>
+}
+/**
+ * Email Search Module
+ */
+export declare class EmailSearch {
+  static createSearchDomain(config: EmailSearchConfig): Record<string, any>;
+  static createIndexerLambda(config: {
+    slug: string
+    roleArn: string
+    searchDomainEndpoint: string
+    emailBucket: string
+  }): Record<string, any>;
+  static IndexerLambdaCode: any;
+  static getIndexMapping(): Record<string, any>;
+  static buildSearchQuery(params: SearchQuery): Record<string, any>;
+}
+export default EmailSearch;

package/dist/email/advanced/shared-mailboxes.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Shared Mailboxes for Teams
+ *
+ * Provides shared mailbox functionality with team access
+ */
+export declare interface SharedMailbox {
+  id: string
+  address: string
+  displayName: string
+  description?: string
+  members: MailboxMember[]
+  settings: MailboxSettings
+  createdAt: string
+  updatedAt: string
+}
+export declare interface MailboxMember {
+  userId: string
+  email: string
+  name?: string
+  role: 'owner' | 'admin' | 'member' | 'viewer'
+  permissions: MailboxPermissions
+  addedAt: string
+  addedBy: string
+}
+export declare interface MailboxPermissions {
+  read: boolean
+  send: boolean
+  delete: boolean
+  manage: boolean
+  assignTo: boolean
+}
+export declare interface MailboxSettings {
+  autoAssign: boolean
+  assignmentStrategy: 'round-robin' | 'least-busy' | 'manual'
+  notifyOnNew: boolean
+  notifyMembers: string[]
+  signature?: string
+  autoResponder?: {
+    enabled: boolean
+    subject: string
+    body: string
+  }
+}
+export declare interface MailboxAssignment {
+  messageId: string
+  assignedTo: string
+  assignedBy: string
+  assignedAt: string
+  status: 'open' | 'in-progress' | 'resolved' | 'closed'
+  notes?: string
+}
+/**
+ * Shared Mailboxes Module
+ */
+export declare class SharedMailboxes {
+  static SharedMailboxLambdaCode: any;
+  static createMailboxTable(config: { slug: string }): Record<string, any>;
+  static createSharedMailboxLambda(config: {
+    slug: string
+    roleArn: string
+    emailBucket: string
+    mailboxTable: string
+  }): Record<string, any>;
+  static readonly PermissionSets: any;
+}
+export default SharedMailboxes;

package/dist/email/advanced/templates.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Email Templates with Stacks Views
+ *
+ * Provides template management and rendering
+ */
+export declare interface EmailTemplate {
+  id: string
+  name: string
+  subject: string
+  html: string
+  text?: string
+  variables: string[]
+  category?: string
+  createdAt: string
+  updatedAt: string
+  version: number
+}
+export declare interface TemplateRenderOptions {
+  data: Record<string, any>
+  locale?: string
+  timezone?: string
+}
+/**
+ * Email Templates Module
+ */
+export declare class EmailTemplates {
+  static TemplateRendererCode: any;
+  static BuiltInTemplates: any;
+  static createTemplateBucket(config: { slug: string }): Record<string, any>;
+  static createTemplateRendererLambda(config: {
+    slug: string
+    roleArn: string
+    templateBucket: string
+  }): Record<string, any>;
+  static render(template: string, data: Record<string, any>): string;
+  static private getNestedValue(obj: Record<string, any>, path: string): any;
+  static extractVariables(template: string): string[];
+}
+export default EmailTemplates;

package/dist/email/advanced/threading.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Email Threading and Conversation View
+ *
+ * Groups emails into conversations based on subject and references
+ */
+export declare interface EmailThread {
+  threadId: string
+  subject: string
+  participants: string[]
+  messageCount: number
+  unreadCount: number
+  lastMessageDate: string
+  firstMessageDate: string
+  messages: ThreadMessage[]
+  labels?: string[]
+  isStarred?: boolean
+}
+export declare interface ThreadMessage {
+  messageId: string
+  from: string
+  fromName?: string
+  to: string[]
+  cc?: string[]
+  date: string
+  bodyPreview: string
+  isRead: boolean
+  hasAttachments: boolean
+}
+/**
+ * Email Threading Module
+ */
+export declare class EmailThreading {
+  static ThreadingLambdaCode: any;
+  static createThreadingLambda(config: {
+    slug: string
+    roleArn: string
+    emailBucket: string
+  }): Record<string, any>;
+  static getThreads(params: {
+    s3Client: any
+    bucket: string
+    mailbox: string
+    limit?: number
+    offset?: number
+  }): Promise<EmailThread[]>;
+  static getThread(params: {
+    s3Client: any
+    bucket: string
+    mailbox: string
+    threadId: string
+  }): Promise<EmailThread | null>;
+}
+export default EmailThreading;

package/dist/email/analytics.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Global email analytics manager instance
+ */
+export declare const emailAnalyticsManager: EmailAnalyticsManager;
+/**
+ * SES Email Analytics
+ * Email tracking, analytics, and reporting
+ */
+export declare interface EmailEvent {
+  id: string
+  messageId: string
+  eventType: 'send' | 'delivery' | 'open' | 'click' | 'bounce' | 'complaint' | 'reject' | 'renderingFailure'
+  timestamp: Date
+  recipient: string
+  subject?: string
+  tags?: Record<string, string>
+}
+export declare interface OpenEvent extends EmailEvent {
+  eventType: 'open'
+  ipAddress: string
+  userAgent: string
+}
+export declare interface ClickEvent extends EmailEvent {
+  eventType: 'click'
+  link: string
+  ipAddress: string
+  userAgent: string
+}
+export declare interface EmailCampaign {
+  id: string
+  name: string
+  subject: string
+  fromEmail: string
+  tags: Record<string, string>
+  sentCount: number
+  deliveredCount: number
+  openCount: number
+  clickCount: number
+  bounceCount: number
+  complaintCount: number
+  createdAt: Date
+}
+export declare interface AnalyticsReport {
+  id: string
+  campaignId?: string
+  startDate: Date
+  endDate: Date
+  totalSent: number
+  totalDelivered: number
+  totalOpened: number
+  totalClicked: number
+  totalBounced: number
+  totalComplaints: number
+  deliveryRate: number
+  openRate: number
+  clickRate: number
+  clickToOpenRate: number
+  bounceRate: number
+  complaintRate: number
+  topLinks: Array<{ link: string; clicks: number }>
+  deviceBreakdown: Record<string, number>
+  locationBreakdown: Record<string, number>
+}
+export declare interface ABTest {
+  id: string
+  name: string
+  variants: ABTestVariant[]
+  status: 'draft' | 'running' | 'completed'
+  startedAt?: Date
+  completedAt?: Date
+  winner?: string
+}
+export declare interface ABTestVariant {
+  id: string
+  name: string
+  subject: string
+  content: string
+  weight: number
+  sentCount: number
+  openCount: number
+  clickCount: number
+  conversionCount: number
+}
+/**
+ * Email analytics manager
+ */
+export declare class EmailAnalyticsManager {
+  private events: Map<string, EmailEvent>;
+  private campaigns: Map<string, EmailCampaign>;
+  private reports: Map<string, AnalyticsReport>;
+  private abTests: Map<string, ABTest>;
+  private eventCounter: any;
+  private campaignCounter: any;
+  private reportCounter: any;
+  private abTestCounter: any;
+  trackEvent(event: Omit<EmailEvent, 'id'>): EmailEvent;
+  trackOpen(options: {
+    messageId: string
+    recipient: string
+    ipAddress: string
+    userAgent: string
+    tags?: Record<string, string>
+  }): OpenEvent;
+  trackClick(options: {
+    messageId: string
+    recipient: string
+    link: string
+    ipAddress: string
+    userAgent: string
+    tags?: Record<string, string>
+  }): ClickEvent;
+  createCampaign(campaign: Omit<EmailCampaign, 'id' | 'sentCount' | 'deliveredCount' | 'openCount' | 'clickCount' | 'bounceCount' | 'complaintCount' | 'createdAt'>): EmailCampaign;
+  private updateCampaignStats(campaignId: string, eventType: string): void;
+  generateReport(options: {
+    campaignId?: string
+    startDate: Date
+    endDate: Date
+  }): AnalyticsReport;
+  createABTest(options: {
+    name: string
+    variants: Array<{
+      name: string
+      subject: string
+      content: string
+      weight: number
+    }>
+  }): ABTest;
+  startABTest(abTestId: string): ABTest;
+  completeABTest(abTestId: string): ABTest;
+  getCampaign(id: string): EmailCampaign | undefined;
+  listCampaigns(): EmailCampaign[];
+  getEvents(options?: {
+    messageId?: string
+    eventType?: string
+    startDate?: Date
+    endDate?: Date
+  }): EmailEvent[];
+  generateTrackingConfigurationCF(options: {
+    configurationSetName: string
+    openTracking?: boolean
+    clickTracking?: boolean
+  }): any;
+  clear(): void;
+}

package/dist/email/bounce-handling.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Global bounce and complaint handler instance
+ */
+export declare const bounceComplaintHandler: BounceComplaintHandler;
+/**
+ * SES Bounce and Complaint Handling
+ * Automated bounce processing and reputation management
+ */
+export declare interface BounceEvent {
+  id: string
+  timestamp: Date
+  messageId: string
+  recipient: string
+  bounceType: 'Permanent' | 'Transient' | 'Undetermined'
+  bounceSubType: string
+  diagnosticCode?: string
+  feedbackId: string
+}
+export declare interface ComplaintEvent {
+  id: string
+  timestamp: Date
+  messageId: string
+  recipients: string[]
+  complaintFeedbackType?: string
+  userAgent?: string
+  feedbackId: string
+  arrivalDate?: Date
+}
+export declare interface BounceHandler {
+  id: string
+  name: string
+  bounceThreshold: number
+  complaintThreshold: number
+  suppressionDuration: number
+  autoSuppress: boolean
+  notificationTopicArn?: string
+}
+export declare interface SuppressionListEntry {
+  id: string
+  emailAddress: string
+  reason: 'BOUNCE' | 'COMPLAINT'
+  suppressedAt: Date
+  expiresAt?: Date
+  bounceCount?: number
+  complaintCount?: number
+}
+export declare interface ReputationMetrics {
+  id: string
+  timestamp: Date
+  bounceRate: number
+  complaintRate: number
+  sendingQuota: number
+  maxSendRate: number
+  sentLast24Hours: number
+  reputationStatus: 'Good' | 'Warning' | 'Probation' | 'Shutdown'
+}
+/**
+ * Bounce and complaint handler
+ */
+export declare class BounceComplaintHandler {
+  private bounces: Map<string, BounceEvent>;
+  private complaints: Map<string, ComplaintEvent>;
+  private handlers: Map<string, BounceHandler>;
+  private suppressionList: Map<string, SuppressionListEntry>;
+  private metrics: Map<string, ReputationMetrics>;
+  private bounceCounter: any;
+  private complaintCounter: any;
+  private handlerCounter: any;
+  private suppressionCounter: any;
+  private metricsCounter: any;
+  recordBounce(bounce: Omit<BounceEvent, 'id'>): BounceEvent;
+  recordComplaint(complaint: Omit<ComplaintEvent, 'id'>): ComplaintEvent;
+  createBounceHandler(handler: Omit<BounceHandler, 'id'>): BounceHandler;
+  createAutomaticBounceHandler(options: {
+    name: string
+    notificationTopicArn: string
+  }): BounceHandler;
+  addToSuppressionList(entry: {
+    emailAddress: string
+    reason: 'BOUNCE' | 'COMPLAINT'
+    expirationDays?: number
+  }): SuppressionListEntry;
+  removeFromSuppressionList(emailAddress: string): boolean;
+  isSuppressed(emailAddress: string): boolean;
+  getBounceStatistics(startDate: Date, endDate: Date): {
+    totalBounces: number
+    permanentBounces: number
+    transientBounces: number
+    bounceRate: number
+    topRecipients: Array<{ email: string; count: number }>
+  };
+  getComplaintStatistics(startDate: Date, endDate: Date): {
+    totalComplaints: number
+    uniqueComplainters: number
+    complaintRate: number
+  };
+  calculateReputationMetrics(): ReputationMetrics;
+  getBounces(messageId?: string): BounceEvent[];
+  getComplaints(messageId?: string): ComplaintEvent[];
+  listSuppressionList(reason?: 'BOUNCE' | 'COMPLAINT'): SuppressionListEntry[];
+  generateSNSSubscriptionCF(options: {
+    topicArn: string
+    endpoint: string
+    protocol: 'email' | 'email-json' | 'http' | 'https' | 'sqs' | 'lambda'
+  }): any;
+  generateEventDestinationCF(options: {
+    configurationSetName: string
+    eventDestinationName: string
+    eventTypes: Array<'send' | 'reject' | 'bounce' | 'complaint' | 'delivery' | 'open' | 'click' | 'renderingFailure'>
+    snsTopicArn?: string
+    cloudWatchDestination?: {
+      dimensionConfigurations: Array<{
+        dimensionName: string
+        dimensionValueSource: 'messageTag' | 'emailHeader' | 'linkTag'
+        defaultDimensionValue: string
+      }>
+    }
+  }): any;
+  clear(): void;
+}