kanmi-perf-revenue 1.0.0 → 1.2.0

package/dist/empirical/export.js

@@ -0,0 +1,392 @@
+/**
+ * Export Formats
+ *
+ * Export analysis results to various formats:
+ * - JSON (machine-readable)
+ * - CSV (spreadsheet-compatible)
+ * - Slack (formatted message blocks)
+ * - Email (HTML email template)
+ *
+ * @author Kanmi Obasa <i@kanmiobasa.com>
+ */
+// =============================================================================
+// JSON EXPORT
+// =============================================================================
+/**
+ * Export analysis to JSON.
+ */
+export function exportToJson(result, options = {}) {
+    const data = {
+        metadata: {
+            clientName: options.clientName,
+            generatedAt: new Date().toISOString(),
+            period: result.metadata.period,
+            totalSessions: result.metadata.totalSessions,
+        },
+        summary: {
+            sessionsWithLcp: result.metadata.sessionsWithLcp,
+            conversions: result.metadata.sessionsWithConversions,
+            topOpportunity: result.topOpportunity,
+        },
+        opportunities: Object.entries(result.opportunities).map(([metric, opp]) => ({
+            metric,
+            priority: opp.recommendation.priority,
+            targetMs: opp.recommendation.target_ms,
+            monthlyOpportunity: opp.recommendation.monthly_opportunity,
+            summary: opp.recommendation.summary,
+        })),
+        curves: options.includeRawData
+            ? Object.entries(result.curves).map(([metric, curve]) => ({
+                metric,
+                buckets: curve.buckets,
+                overallCvr: curve.summary.overall_cvr,
+            }))
+            : undefined,
+    };
+    return options.format === 'pretty'
+        ? JSON.stringify(data, null, 2)
+        : JSON.stringify(data);
+}
+// =============================================================================
+// CSV EXPORT
+// =============================================================================
+/**
+ * Export opportunities to CSV.
+ */
+export function exportOpportunitiesToCsv(result) {
+    const headers = [
+        'Metric',
+        'Priority',
+        'Target (ms)',
+        'Monthly Opportunity ($)',
+        'Sessions to Improve',
+        'Current CVR',
+        'Target CVR',
+        'Summary',
+    ];
+    const rows = [headers];
+    for (const [metric, opp] of Object.entries(result.opportunities)) {
+        const scenario = opp.scenarios[0];
+        rows.push([
+            metric.toUpperCase(),
+            opp.recommendation.priority,
+            opp.recommendation.target_ms.toString(),
+            opp.recommendation.monthly_opportunity.toLocaleString(),
+            scenario?.slow_sessions?.toString() || '',
+            ((scenario?.slow_cvr || 0) * 100).toFixed(2) + '%',
+            ((scenario?.fast_cvr || 0) * 100).toFixed(2) + '%',
+            `"${opp.recommendation.summary}"`,
+        ]);
+    }
+    return rows.map(row => row.join(',')).join('\n');
+}
+/**
+ * Export curve data to CSV.
+ */
+export function exportCurvesToCsv(result) {
+    const headers = [
+        'Metric',
+        'Bucket',
+        'Min',
+        'Max',
+        'Sessions',
+        'Conversions',
+        'CVR',
+        'AOV',
+    ];
+    const rows = [headers];
+    for (const [metric, curve] of Object.entries(result.curves)) {
+        for (const bucket of curve.buckets) {
+            rows.push([
+                metric.toUpperCase(),
+                bucket.range,
+                bucket.lower_ms.toString(),
+                bucket.upper_ms.toString(),
+                bucket.sessions.toString(),
+                bucket.conversions.toString(),
+                (bucket.conversion_rate * 100).toFixed(4) + '%',
+                '$' + bucket.aov.toFixed(2),
+            ]);
+        }
+    }
+    return rows.map(row => row.join(',')).join('\n');
+}
+// =============================================================================
+// SLACK EXPORT
+// =============================================================================
+/**
+ * Format analysis result for Slack.
+ */
+export function exportToSlack(result, options = {}) {
+    const blocks = [];
+    // Header
+    blocks.push({
+        type: 'header',
+        text: {
+            type: 'plain_text',
+            text: `📊 Performance Revenue Analysis${options.clientName ? ` - ${options.clientName}` : ''}`,
+        },
+    });
+    // Divider
+    blocks.push({ type: 'divider' });
+    // Summary
+    blocks.push({
+        type: 'section',
+        fields: [
+            {
+                type: 'mrkdwn',
+                text: `*Sessions Analyzed*\n${result.metadata.totalSessions.toLocaleString()}`,
+            },
+            {
+                type: 'mrkdwn',
+                text: `*Conversions*\n${result.metadata.sessionsWithConversions.toLocaleString()}`,
+            },
+        ],
+    });
+    // Top Opportunity
+    if (result.topOpportunity) {
+        blocks.push({
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text: `*🎯 Top Opportunity*\n${result.topOpportunity.summary}\n\n*Potential Monthly Revenue:* $${result.topOpportunity.monthlyRevenue.toLocaleString()}`,
+            },
+        });
+    }
+    // Divider
+    blocks.push({ type: 'divider' });
+    // All opportunities
+    blocks.push({
+        type: 'section',
+        text: {
+            type: 'mrkdwn',
+            text: '*All Opportunities*',
+        },
+    });
+    for (const [metric, opp] of Object.entries(result.opportunities)) {
+        const priority = opp.recommendation.priority;
+        const emoji = priority === 'high' ? '🔴' : priority === 'medium' ? '🟡' : '🟢';
+        blocks.push({
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text: `${emoji} *${metric.toUpperCase()}*: $${opp.recommendation.monthly_opportunity.toLocaleString()}/month (${priority} priority)`,
+            },
+        });
+    }
+    // Context
+    blocks.push({
+        type: 'context',
+        text: {
+            type: 'mrkdwn',
+            text: `Analysis period: ${result.metadata.period.start} to ${result.metadata.period.end}`,
+        },
+    });
+    return {
+        blocks,
+        text: `Performance Revenue Analysis: $${result.topOpportunity?.monthlyRevenue.toLocaleString() || 0} monthly opportunity`,
+    };
+}
+/**
+ * Format alerts for Slack.
+ */
+export function exportAlertsToSlack(report) {
+    const blocks = [];
+    // Header
+    const emoji = report.summary.critical > 0 ? '🚨' :
+        report.summary.warning > 0 ? '⚠️' : '✅';
+    blocks.push({
+        type: 'header',
+        text: {
+            type: 'plain_text',
+            text: `${emoji} Performance Alert Report`,
+        },
+    });
+    // Summary
+    blocks.push({
+        type: 'section',
+        fields: [
+            { type: 'mrkdwn', text: `*Critical*\n${report.summary.critical}` },
+            { type: 'mrkdwn', text: `*Warning*\n${report.summary.warning}` },
+            { type: 'mrkdwn', text: `*Info*\n${report.summary.info}` },
+            { type: 'mrkdwn', text: `*Total*\n${report.summary.total}` },
+        ],
+    });
+    if (report.alerts.length > 0) {
+        blocks.push({ type: 'divider' });
+        blocks.push({
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text: '*Active Alerts*',
+            },
+        });
+        for (const alert of report.alerts.slice(0, 10)) {
+            const alertEmoji = alert.severity === 'critical' ? '🚨' :
+                alert.severity === 'warning' ? '⚠️' : 'ℹ️';
+            blocks.push({
+                type: 'section',
+                text: {
+                    type: 'mrkdwn',
+                    text: `${alertEmoji} ${alert.message}`,
+                },
+            });
+        }
+    }
+    return {
+        blocks,
+        text: `${emoji} Performance Alert: ${report.summary.critical} critical, ${report.summary.warning} warning`,
+    };
+}
+// =============================================================================
+// EMAIL EXPORT
+// =============================================================================
+/**
+ * Generate email template from analysis.
+ */
+export function exportToEmail(result, options = {}) {
+    const subject = `Performance Revenue Report${options.clientName ? ` - ${options.clientName}` : ''} | ${result.metadata.period.start} to ${result.metadata.period.end}`;
+    const topOpp = result.topOpportunity;
+    const html = `
+<!DOCTYPE html>
+<html>
+<head>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; max-width: 600px; margin: 0 auto; padding: 20px; }
+    h1 { color: #1a1a2e; border-bottom: 2px solid #4a47a3; padding-bottom: 10px; }
+    h2 { color: #4a47a3; }
+    .highlight { background: #f0f0ff; padding: 15px; border-radius: 8px; margin: 15px 0; }
+    .opportunity { background: #e8f5e9; padding: 15px; border-radius: 8px; margin: 10px 0; border-left: 4px solid #4caf50; }
+    .metric { display: inline-block; margin: 10px 20px 10px 0; }
+    .metric-value { font-size: 24px; font-weight: bold; color: #1a1a2e; }
+    .metric-label { color: #666; font-size: 14px; }
+    table { width: 100%; border-collapse: collapse; margin: 15px 0; }
+    th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
+    th { background: #f5f5f5; }
+    .priority-high { color: #d32f2f; }
+    .priority-medium { color: #f57c00; }
+    .priority-low { color: #388e3c; }
+    .footer { margin-top: 30px; padding-top: 20px; border-top: 1px solid #ddd; color: #666; font-size: 12px; }
+  </style>
+</head>
+<body>
+  <h1>📊 Performance Revenue Report</h1>
+  ${options.clientName ? `<p><strong>Client:</strong> ${options.clientName}</p>` : ''}
+  <p><strong>Period:</strong> ${result.metadata.period.start} to ${result.metadata.period.end}</p>
+
+  <div class="highlight">
+    <div class="metric">
+      <div class="metric-value">${result.metadata.totalSessions.toLocaleString()}</div>
+      <div class="metric-label">Sessions Analyzed</div>
+    </div>
+    <div class="metric">
+      <div class="metric-value">${result.metadata.sessionsWithConversions.toLocaleString()}</div>
+      <div class="metric-label">Conversions</div>
+    </div>
+    <div class="metric">
+      <div class="metric-value">${((result.metadata.sessionsWithConversions / result.metadata.totalSessions) * 100).toFixed(2)}%</div>
+      <div class="metric-label">Conversion Rate</div>
+    </div>
+  </div>
+
+  ${topOpp ? `
+  <div class="opportunity">
+    <h2>🎯 Top Opportunity</h2>
+    <p><strong>${topOpp.summary}</strong></p>
+    <p style="font-size: 24px; margin: 10px 0;"><strong>$${topOpp.monthlyRevenue.toLocaleString()}</strong> potential monthly revenue</p>
+  </div>
+  ` : ''}
+
+  <h2>All Opportunities</h2>
+  <table>
+    <tr>
+      <th>Metric</th>
+      <th>Priority</th>
+      <th>Monthly Opportunity</th>
+    </tr>
+    ${Object.entries(result.opportunities).map(([metric, opp]) => `
+    <tr>
+      <td>${metric.toUpperCase()}</td>
+      <td class="priority-${opp.recommendation.priority}">${opp.recommendation.priority.toUpperCase()}</td>
+      <td><strong>$${opp.recommendation.monthly_opportunity.toLocaleString()}</strong></td>
+    </tr>
+    `).join('')}
+  </table>
+
+  <div class="footer">
+    <p>Generated by Empirical Performance Revenue Engine</p>
+    <p>${new Date().toISOString()}</p>
+  </div>
+</body>
+</html>
+  `.trim();
+    const text = `
+Performance Revenue Report
+${options.clientName ? `Client: ${options.clientName}` : ''}
+Period: ${result.metadata.period.start} to ${result.metadata.period.end}
+
+Summary:
+- Sessions Analyzed: ${result.metadata.totalSessions.toLocaleString()}
+- Conversions: ${result.metadata.sessionsWithConversions.toLocaleString()}
+- CVR: ${((result.metadata.sessionsWithConversions / result.metadata.totalSessions) * 100).toFixed(2)}%
+
+${topOpp ? `
+Top Opportunity:
+${topOpp.summary}
+Potential Monthly Revenue: $${topOpp.monthlyRevenue.toLocaleString()}
+` : ''}
+
+All Opportunities:
+${Object.entries(result.opportunities).map(([metric, opp]) => `- ${metric.toUpperCase()}: $${opp.recommendation.monthly_opportunity.toLocaleString()}/month (${opp.recommendation.priority} priority)`).join('\n')}
+
+Generated by Empirical Performance Revenue Engine
+  `.trim();
+    return {
+        subject,
+        html,
+        text,
+    };
+}
+// =============================================================================
+// WEBHOOK EXPORT
+// =============================================================================
+/**
+ * Generate webhook payload.
+ */
+export function exportToWebhook(result, options = {}) {
+    return {
+        event: 'performance_analysis_complete',
+        timestamp: new Date().toISOString(),
+        client: options.clientName,
+        period: result.metadata.period,
+        summary: {
+            totalSessions: result.metadata.totalSessions,
+            conversions: result.metadata.sessionsWithConversions,
+            cvr: result.metadata.sessionsWithConversions / result.metadata.totalSessions,
+        },
+        topOpportunity: result.topOpportunity,
+        opportunities: Object.entries(result.opportunities).map(([metric, opp]) => ({
+            metric,
+            priority: opp.recommendation.priority,
+            monthlyOpportunity: opp.recommendation.monthly_opportunity,
+        })),
+    };
+}
+/**
+ * Generate webhook payload for alerts.
+ */
+export function exportAlertWebhook(report) {
+    return {
+        event: 'performance_alert',
+        timestamp: new Date().toISOString(),
+        summary: report.summary,
+        alerts: report.alerts.map(a => ({
+            id: a.id,
+            type: a.type,
+            severity: a.severity,
+            metric: a.metric,
+            message: a.message,
+        })),
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/empirical/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/empirical/export.ts"],"names":[],"mappings":"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"}

package/dist/empirical/forecasting.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Prediction & Forecasting
+ *
+ * Project future revenue based on planned performance improvements.
+ * Uses empirical data and improvement scenarios.
+ *
+ * @author Kanmi Obasa <i@kanmiobasa.com>
+ */
+import type { SessionData } from './datadog-session-query.js';
+import type { ConversionCurve } from './conversion-curve.js';
+export interface ImprovementScenario {
+    /** Descriptive name */
+    name: string;
+    /** Metric to improve */
+    metric: 'lcp' | 'inp' | 'cls' | 'fcp' | 'ttfb';
+    /** Target p75 value */
+    targetP75: number;
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Expected implementation date */
+    implementationDate?: string;
+}
+export interface ForecastPeriod {
+    month: number;
+    monthName: string;
+    /** Baseline revenue (no improvement) */
+    baselineRevenue: number;
+    /** Forecasted revenue with improvement */
+    forecastedRevenue: number;
+    /** Additional revenue from improvement */
+    additionalRevenue: number;
+    /** Cumulative additional revenue */
+    cumulativeAdditional: number;
+}
+export interface RevenueForecast {
+    scenario: ImprovementScenario;
+    periods: ForecastPeriod[];
+    summary: {
+        /** 12-month total additional revenue */
+        totalAdditionalRevenue: number;
+        /** Average monthly lift */
+        avgMonthlyLift: number;
+        /** Revenue growth percentage */
+        revenueGrowthPercent: number;
+    };
+    assumptions: string[];
+}
+export interface MultiForecast {
+    forecasts: RevenueForecast[];
+    combined: {
+        periods: ForecastPeriod[];
+        totalAdditionalRevenue: number;
+        netImpact: number;
+    };
+    recommendations: string[];
+}
+/**
+ * Generate revenue forecast for a single improvement scenario.
+ */
+export declare function forecastRevenue(scenario: ImprovementScenario, sessions: SessionData[], curve: ConversionCurve | null, config?: {
+    forecastMonths?: number;
+    seasonalityFactors?: number[];
+    growthRate?: number;
+}): RevenueForecast;
+/**
+ * Generate combined forecast for multiple improvements.
+ */
+export declare function forecastMultipleImprovements(scenarios: ImprovementScenario[], sessions: SessionData[], curves: Record<string, ConversionCurve>, config?: {
+    forecastMonths?: number;
+    synergisticBonus?: number;
+}): MultiForecast;
+/**
+ * Generate markdown report for forecast.
+ */
+export declare function generateForecastMarkdown(forecast: RevenueForecast): string;
+/**
+ * Generate multi-scenario comparison markdown.
+ */
+export declare function generateMultiForecastMarkdown(multiForecast: MultiForecast): string;
+//# sourceMappingURL=forecasting.d.ts.map

package/dist/empirical/forecasting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecasting.d.ts","sourceRoot":"","sources":["../../src/empirical/forecasting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC/C,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,wCAAwC;QACxC,sBAAsB,EAAE,MAAM,CAAC;QAC/B,2BAA2B;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,gCAAgC;QAChC,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE;QACR,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAmHD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,eAAe,GAAG,IAAI,EAC7B,MAAM,GAAE;IACN,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GACL,eAAe,CA8DjB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,mBAAmB,EAAE,EAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,MAAM,GAAE;IACN,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACtB,GACL,aAAa,CAqEf;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA0C1E;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAiDlF"}