@stacksjs/ts-cloud-core 0.1.6 → 0.1.8

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;
+}