@stacksjs/ts-cloud-core 0.1.3 → 0.1.7

package/src/observability/xray.ts

@@ -1,358 +0,0 @@
-/**
- * AWS X-Ray Integration
- * Distributed tracing for microservices and serverless applications
- */
-
-export interface XRayConfig {
-  id: string
-  name: string
-  serviceName: string
-  samplingRate: number // 0-1 (e.g., 0.1 = 10%)
-  enableActiveTracing: boolean
-  segmentDocuments?: SegmentDocument[]
-}
-
-export interface SegmentDocument {
-  id: string
-  name: string
-  startTime: number
-  endTime?: number
-  subsegments?: SubSegment[]
-  annotations?: Record<string, string | number | boolean>
-  metadata?: Record<string, any>
-  http?: HttpData
-  aws?: AWSData
-  error?: boolean
-  fault?: boolean
-  throttle?: boolean
-}
-
-export interface SubSegment {
-  id: string
-  name: string
-  startTime: number
-  endTime?: number
-  namespace?: 'aws' | 'remote'
-  http?: HttpData
-  sql?: SqlData
-  annotations?: Record<string, string | number | boolean>
-  metadata?: Record<string, any>
-}
-
-export interface HttpData {
-  request?: {
-    method?: string
-    url?: string
-    userAgent?: string
-    clientIp?: string
-  }
-  response?: {
-    status?: number
-    contentLength?: number
-  }
-}
-
-export interface AWSData {
-  accountId?: string
-  operation?: string
-  region?: string
-  requestId?: string
-  queueUrl?: string
-  tableName?: string
-}
-
-export interface SqlData {
-  url?: string
-  preparation?: 'statement' | 'call'
-  databaseType?: string
-  databaseVersion?: string
-  driverVersion?: string
-  user?: string
-  sanitizedQuery?: string
-}
-
-export interface SamplingRule {
-  id: string
-  ruleName: string
-  priority: number
-  fixedRate: number
-  reservoirSize: number
-  serviceName: string
-  serviceType: string
-  host: string
-  httpMethod: string
-  urlPath: string
-  version: number
-}
-
-/**
- * X-Ray manager
- */
-export class XRayManager {
-  private configs: Map<string, XRayConfig> = new Map()
-  private samplingRules: Map<string, SamplingRule> = new Map()
-  private configCounter = 0
-  private ruleCounter = 0
-
-  /**
-   * Create X-Ray configuration
-   */
-  createConfig(config: Omit<XRayConfig, 'id'>): XRayConfig {
-    const id = `xray-config-${Date.now()}-${this.configCounter++}`
-
-    const xrayConfig: XRayConfig = {
-      id,
-      ...config,
-    }
-
-    this.configs.set(id, xrayConfig)
-
-    return xrayConfig
-  }
-
-  /**
-   * Create Lambda X-Ray configuration
-   */
-  createLambdaConfig(options: {
-    functionName: string
-    samplingRate?: number
-  }): XRayConfig {
-    return this.createConfig({
-      name: `${options.functionName}-xray`,
-      serviceName: options.functionName,
-      samplingRate: options.samplingRate || 0.1,
-      enableActiveTracing: true,
-    })
-  }
-
-  /**
-   * Create ECS X-Ray configuration
-   */
-  createECSConfig(options: {
-    serviceName: string
-    clusterName: string
-    samplingRate?: number
-  }): XRayConfig {
-    return this.createConfig({
-      name: `${options.serviceName}-xray`,
-      serviceName: `${options.clusterName}/${options.serviceName}`,
-      samplingRate: options.samplingRate || 0.05,
-      enableActiveTracing: true,
-    })
-  }
-
-  /**
-   * Create API Gateway X-Ray configuration
-   */
-  createAPIGatewayConfig(options: {
-    apiName: string
-    stage: string
-    samplingRate?: number
-  }): XRayConfig {
-    return this.createConfig({
-      name: `${options.apiName}-${options.stage}-xray`,
-      serviceName: `${options.apiName}/${options.stage}`,
-      samplingRate: options.samplingRate || 0.05,
-      enableActiveTracing: true,
-    })
-  }
-
-  /**
-   * Create sampling rule
-   */
-  createSamplingRule(rule: Omit<SamplingRule, 'id'>): SamplingRule {
-    const id = `sampling-rule-${Date.now()}-${this.ruleCounter++}`
-
-    const samplingRule: SamplingRule = {
-      id,
-      ...rule,
-    }
-
-    this.samplingRules.set(id, samplingRule)
-
-    return samplingRule
-  }
-
-  /**
-   * Create high-priority sampling rule (always trace)
-   */
-  createHighPrioritySamplingRule(options: {
-    ruleName: string
-    serviceName: string
-    urlPath: string
-  }): SamplingRule {
-    return this.createSamplingRule({
-      ruleName: options.ruleName,
-      priority: 100,
-      fixedRate: 1.0, // 100% sampling
-      reservoirSize: 100,
-      serviceName: options.serviceName,
-      serviceType: '*',
-      host: '*',
-      httpMethod: '*',
-      urlPath: options.urlPath,
-      version: 1,
-    })
-  }
-
-  /**
-   * Create error sampling rule (trace all errors)
-   */
-  createErrorSamplingRule(serviceName: string): SamplingRule {
-    return this.createSamplingRule({
-      ruleName: `${serviceName}-errors`,
-      priority: 200,
-      fixedRate: 1.0,
-      reservoirSize: 50,
-      serviceName,
-      serviceType: '*',
-      host: '*',
-      httpMethod: '*',
-      urlPath: '/error/*',
-      version: 1,
-    })
-  }
-
-  /**
-   * Create default sampling rule
-   */
-  createDefaultSamplingRule(serviceName: string, samplingRate: number = 0.05): SamplingRule {
-    return this.createSamplingRule({
-      ruleName: `${serviceName}-default`,
-      priority: 1000,
-      fixedRate: samplingRate,
-      reservoirSize: 10,
-      serviceName,
-      serviceType: '*',
-      host: '*',
-      httpMethod: '*',
-      urlPath: '*',
-      version: 1,
-    })
-  }
-
-  /**
-   * Get config
-   */
-  getConfig(id: string): XRayConfig | undefined {
-    return this.configs.get(id)
-  }
-
-  /**
-   * List configs
-   */
-  listConfigs(): XRayConfig[] {
-    return Array.from(this.configs.values())
-  }
-
-  /**
-   * Get sampling rule
-   */
-  getSamplingRule(id: string): SamplingRule | undefined {
-    return this.samplingRules.get(id)
-  }
-
-  /**
-   * List sampling rules
-   */
-  listSamplingRules(): SamplingRule[] {
-    return Array.from(this.samplingRules.values())
-  }
-
-  /**
-   * Generate CloudFormation for Lambda X-Ray
-   */
-  generateLambdaXRayCF(config: XRayConfig): any {
-    return {
-      TracingConfig: {
-        Mode: config.enableActiveTracing ? 'Active' : 'PassThrough',
-      },
-    }
-  }
-
-  /**
-   * Generate CloudFormation for API Gateway X-Ray
-   */
-  generateAPIGatewayXRayCF(config: XRayConfig): any {
-    return {
-      TracingEnabled: config.enableActiveTracing,
-    }
-  }
-
-  /**
-   * Generate ECS task definition with X-Ray sidecar
-   */
-  generateECSXRaySidecarCF(): any {
-    return {
-      Name: 'xray-daemon',
-      Image: 'public.ecr.aws/xray/aws-xray-daemon:latest',
-      Cpu: 32,
-      MemoryReservation: 256,
-      PortMappings: [
-        {
-          ContainerPort: 2000,
-          Protocol: 'udp',
-        },
-      ],
-    }
-  }
-
-  /**
-   * Generate sampling rules CloudFormation
-   */
-  generateSamplingRuleCF(rule: SamplingRule): any {
-    return {
-      Type: 'AWS::XRay::SamplingRule',
-      Properties: {
-        SamplingRule: {
-          RuleName: rule.ruleName,
-          Priority: rule.priority,
-          FixedRate: rule.fixedRate,
-          ReservoirSize: rule.reservoirSize,
-          ServiceName: rule.serviceName,
-          ServiceType: rule.serviceType,
-          Host: rule.host,
-          HTTPMethod: rule.httpMethod,
-          URLPath: rule.urlPath,
-          Version: rule.version,
-          ResourceARN: '*',
-        },
-      },
-    }
-  }
-
-  /**
-   * Create a distributed trace
-   */
-  createTrace(
-    traceId: string,
-    spans: Array<{ spanId: string; name: string; duration: number; tags: Record<string, any> }>
-  ): {
-    id: string
-    traceId: string
-    spans: Array<{ spanId: string; name: string; duration: number; tags: Record<string, any> }>
-  } {
-    const id = `trace-${Date.now()}-${this.configCounter++}`
-    const trace = {
-      id,
-      traceId,
-      spans,
-    }
-    return trace
-  }
-
-  /**
-   * Clear all data
-   */
-  clear(): void {
-    this.configs.clear()
-    this.samplingRules.clear()
-    this.configCounter = 0
-    this.ruleCounter = 0
-  }
-}
-
-/**
- * Global X-Ray manager instance
- */
-export const xrayManager: XRayManager = new XRayManager()

package/src/phone/advanced/analytics.ts

@@ -1,349 +0,0 @@
-/**
- * Call Analytics and Reporting
- *
- * Provides call metrics, reporting, and insights
- */
-
-export interface CallMetrics {
-  period: string
-  totalCalls: number
-  answeredCalls: number
-  missedCalls: number
-  abandonedCalls: number
-  voicemails: number
-  averageWaitTime: number
-  averageHandleTime: number
-  averageTalkTime: number
-  serviceLevel: number
-  abandonRate: number
-  answerRate: number
-}
-
-export interface AgentMetrics {
-  agentId: string
-  agentName: string
-  callsHandled: number
-  averageHandleTime: number
-  averageTalkTime: number
-  averageHoldTime: number
-  occupancy: number
-  availability: number
-}
-
-export interface QueueMetrics {
-  queueId: string
-  queueName: string
-  callsInQueue: number
-  oldestCallWaitTime: number
-  averageWaitTime: number
-  agentsAvailable: number
-  agentsOnCall: number
-}
-
-export interface CallInsight {
-  callId: string
-  sentiment: 'positive' | 'neutral' | 'negative'
-  topics: string[]
-  keywords: string[]
-  issues: string[]
-  resolution: boolean
-  customerSatisfaction?: number
-}
-
-/**
- * Call Analytics Module
- */
-export class CallAnalytics {
-  /**
-   * Lambda code for aggregating call metrics
-   */
-  static MetricsAggregatorCode = `
-const { DynamoDBClient, QueryCommand, PutItemCommand, ScanCommand } = require('@aws-sdk/client-dynamodb');
-
-const dynamodb = new DynamoDBClient({});
-const CALL_LOG_TABLE = process.env.CALL_LOG_TABLE;
-const METRICS_TABLE = process.env.METRICS_TABLE;
-
-exports.handler = async (event) => {
-  console.log('Metrics aggregator event:', JSON.stringify(event, null, 2));
-
-  const now = new Date();
-  const hourAgo = new Date(now.getTime() - 60 * 60 * 1000);
-  const dayAgo = new Date(now.getTime() - 24 * 60 * 60 * 1000);
-
-  try {
-    // Get calls from the last hour
-    const hourlyResult = await dynamodb.send(new ScanCommand({
-      TableName: CALL_LOG_TABLE,
-      FilterExpression: 'startTime >= :hourAgo',
-      ExpressionAttributeValues: {
-        ':hourAgo': { S: hourAgo.toISOString() },
-      },
-    }));
-
-    const hourlyCalls = hourlyResult.Items || [];
-    const hourlyMetrics = calculateMetrics(hourlyCalls, 'hourly');
-
-    // Save hourly metrics
-    await dynamodb.send(new PutItemCommand({
-      TableName: METRICS_TABLE,
-      Item: {
-        period: { S: \`hourly-\${now.toISOString().slice(0, 13)}\` },
-        type: { S: 'hourly' },
-        timestamp: { S: now.toISOString() },
-        metrics: { S: JSON.stringify(hourlyMetrics) },
-        ttl: { N: String(Math.floor(Date.now() / 1000) + 7 * 24 * 60 * 60) },
-      },
-    }));
-
-    // Get calls from the last day for daily metrics
-    const dailyResult = await dynamodb.send(new ScanCommand({
-      TableName: CALL_LOG_TABLE,
-      FilterExpression: 'startTime >= :dayAgo',
-      ExpressionAttributeValues: {
-        ':dayAgo': { S: dayAgo.toISOString() },
-      },
-    }));
-
-    const dailyCalls = dailyResult.Items || [];
-    const dailyMetrics = calculateMetrics(dailyCalls, 'daily');
-
-    // Save daily metrics
-    await dynamodb.send(new PutItemCommand({
-      TableName: METRICS_TABLE,
-      Item: {
-        period: { S: \`daily-\${now.toISOString().slice(0, 10)}\` },
-        type: { S: 'daily' },
-        timestamp: { S: now.toISOString() },
-        metrics: { S: JSON.stringify(dailyMetrics) },
-        ttl: { N: String(Math.floor(Date.now() / 1000) + 90 * 24 * 60 * 60) },
-      },
-    }));
-
-    console.log('Metrics aggregated successfully');
-    return { statusCode: 200 };
-  } catch (error) {
-    console.error('Error aggregating metrics:', error);
-    return { statusCode: 500, error: error.message };
-  }
-};
-
-function calculateMetrics(calls, period) {
-  const totalCalls = calls.length;
-  const answeredCalls = calls.filter(c => c.status?.S === 'answered').length;
-  const missedCalls = calls.filter(c => c.status?.S === 'missed').length;
-  const abandonedCalls = calls.filter(c => c.status?.S === 'abandoned').length;
-  const voicemails = calls.filter(c => c.hasVoicemail?.BOOL).length;
-
-  const waitTimes = calls
-    .filter(c => c.waitTime?.N)
-    .map(c => parseFloat(c.waitTime.N));
-  const handleTimes = calls
-    .filter(c => c.handleTime?.N)
-    .map(c => parseFloat(c.handleTime.N));
-  const talkTimes = calls
-    .filter(c => c.talkTime?.N)
-    .map(c => parseFloat(c.talkTime.N));
-
-  const averageWaitTime = waitTimes.length > 0
-    ? waitTimes.reduce((a, b) => a + b, 0) / waitTimes.length
-    : 0;
-  const averageHandleTime = handleTimes.length > 0
-    ? handleTimes.reduce((a, b) => a + b, 0) / handleTimes.length
-    : 0;
-  const averageTalkTime = talkTimes.length > 0
-    ? talkTimes.reduce((a, b) => a + b, 0) / talkTimes.length
-    : 0;
-
-  // Service level: % of calls answered within 20 seconds
-  const answeredWithin20s = calls.filter(c =>
-    c.status?.S === 'answered' && parseFloat(c.waitTime?.N || 999) <= 20
-  ).length;
-  const serviceLevel = totalCalls > 0 ? (answeredWithin20s / totalCalls) * 100 : 100;
-
-  return {
-    period,
-    totalCalls,
-    answeredCalls,
-    missedCalls,
-    abandonedCalls,
-    voicemails,
-    averageWaitTime: Math.round(averageWaitTime),
-    averageHandleTime: Math.round(averageHandleTime),
-    averageTalkTime: Math.round(averageTalkTime),
-    serviceLevel: Math.round(serviceLevel * 10) / 10,
-    abandonRate: totalCalls > 0 ? Math.round((abandonedCalls / totalCalls) * 1000) / 10 : 0,
-    answerRate: totalCalls > 0 ? Math.round((answeredCalls / totalCalls) * 1000) / 10 : 0,
-  };
-}
-`
-
-  /**
-   * Lambda code for real-time queue metrics
-   */
-  static QueueMetricsCode = `
-const { ConnectClient, GetCurrentMetricDataCommand, ListQueuesCommand } = require('@aws-sdk/client-connect');
-
-const connect = new ConnectClient({});
-const INSTANCE_ID = process.env.CONNECT_INSTANCE_ID;
-
-exports.handler = async (event) => {
-  console.log('Queue metrics request:', JSON.stringify(event, null, 2));
-
-  try {
-    // List queues
-    const queuesResult = await connect.send(new ListQueuesCommand({
-      InstanceId: INSTANCE_ID,
-      QueueTypes: ['STANDARD'],
-    }));
-
-    const queues = queuesResult.QueueSummaryList || [];
-    const metrics = [];
-
-    for (const queue of queues) {
-      // Get current metrics for queue
-      const metricsResult = await connect.send(new GetCurrentMetricDataCommand({
-        InstanceId: INSTANCE_ID,
-        Filters: {
-          Queues: [queue.Id],
-          Channels: ['VOICE'],
-        },
-        CurrentMetrics: [
-          { Name: 'AGENTS_AVAILABLE', Unit: 'COUNT' },
-          { Name: 'AGENTS_ON_CALL', Unit: 'COUNT' },
-          { Name: 'CONTACTS_IN_QUEUE', Unit: 'COUNT' },
-          { Name: 'OLDEST_CONTACT_AGE', Unit: 'SECONDS' },
-        ],
-      }));
-
-      const metricData = metricsResult.MetricResults?.[0]?.Collections || [];
-      const queueMetrics = {
-        queueId: queue.Id,
-        queueName: queue.Name,
-        callsInQueue: 0,
-        oldestCallWaitTime: 0,
-        agentsAvailable: 0,
-        agentsOnCall: 0,
-      };
-
-      for (const metric of metricData) {
-        switch (metric.Metric?.Name) {
-          case 'CONTACTS_IN_QUEUE':
-            queueMetrics.callsInQueue = metric.Value || 0;
-            break;
-          case 'OLDEST_CONTACT_AGE':
-            queueMetrics.oldestCallWaitTime = metric.Value || 0;
-            break;
-          case 'AGENTS_AVAILABLE':
-            queueMetrics.agentsAvailable = metric.Value || 0;
-            break;
-          case 'AGENTS_ON_CALL':
-            queueMetrics.agentsOnCall = metric.Value || 0;
-            break;
-        }
-      }
-
-      metrics.push(queueMetrics);
-    }
-
-    return {
-      statusCode: 200,
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(metrics),
-    };
-  } catch (error) {
-    console.error('Error getting queue metrics:', error);
-    return {
-      statusCode: 500,
-      body: JSON.stringify({ error: error.message }),
-    };
-  }
-};
-`
-
-  /**
-   * Create metrics DynamoDB table
-   */
-  static createMetricsTable(config: { slug: string }): Record<string, any> {
-    return {
-      [`${config.slug}CallMetricsTable`]: {
-        Type: 'AWS::DynamoDB::Table',
-        Properties: {
-          TableName: `${config.slug}-call-metrics`,
-          BillingMode: 'PAY_PER_REQUEST',
-          AttributeDefinitions: [
-            { AttributeName: 'period', AttributeType: 'S' },
-          ],
-          KeySchema: [
-            { AttributeName: 'period', KeyType: 'HASH' },
-          ],
-          TimeToLiveSpecification: {
-            AttributeName: 'ttl',
-            Enabled: true,
-          },
-        },
-      },
-    }
-  }
-
-  /**
-   * Create metrics aggregator Lambda
-   */
-  static createMetricsAggregatorLambda(config: {
-    slug: string
-    roleArn: string
-    callLogTable: string
-    metricsTable: string
-  }): Record<string, any> {
-    return {
-      [`${config.slug}CallMetricsAggregatorLambda`]: {
-        Type: 'AWS::Lambda::Function',
-        Properties: {
-          FunctionName: `${config.slug}-call-metrics-aggregator`,
-          Runtime: 'nodejs20.x',
-          Handler: 'index.handler',
-          Role: config.roleArn,
-          Timeout: 60,
-          MemorySize: 256,
-          Code: {
-            ZipFile: CallAnalytics.MetricsAggregatorCode,
-          },
-          Environment: {
-            Variables: {
-              CALL_LOG_TABLE: config.callLogTable,
-              METRICS_TABLE: config.metricsTable,
-            },
-          },
-        },
-      },
-    }
-  }
-
-  /**
-   * Create EventBridge rule for hourly metrics
-   */
-  static createMetricsSchedule(config: {
-    slug: string
-    lambdaArn: string
-  }): Record<string, any> {
-    return {
-      [`${config.slug}CallMetricsSchedule`]: {
-        Type: 'AWS::Events::Rule',
-        Properties: {
-          Name: `${config.slug}-call-metrics-schedule`,
-          Description: 'Aggregate call metrics hourly',
-          ScheduleExpression: 'rate(1 hour)',
-          State: 'ENABLED',
-          Targets: [
-            {
-              Id: 'MetricsAggregatorTarget',
-              Arn: config.lambdaArn,
-            },
-          ],
-        },
-      },
-    }
-  }
-}
-
-export default CallAnalytics