kanmi-perf-revenue 1.0.0

package/dist/empirical/data-import.js

@@ -0,0 +1,186 @@
+/**
+ * Data Import
+ *
+ * Import session data from CSV/JSON files.
+ * Bring your own data from any source.
+ *
+ * Expected format:
+ * - session_id: string
+ * - lcp_ms: number (optional)
+ * - inp_ms: number (optional)
+ * - cls: number (optional)
+ * - converted: boolean | 0 | 1
+ * - order_value: number (optional, defaults to 0)
+ * - device: 'mobile' | 'desktop' | 'tablet' (optional)
+ * - page_type: string (optional)
+ *
+ * @author Kanmi Obasa <i@kanmiobasa.com>
+ */
+import { readFileSync } from 'fs';
+// =============================================================================
+// IMPORT FUNCTIONS
+// =============================================================================
+/**
+ * Import sessions from a JSON file.
+ */
+export function importFromJson(filePath, options = {}) {
+    const content = readFileSync(filePath, 'utf-8');
+    const raw = JSON.parse(content);
+    // Handle both array and object with data property
+    const rows = Array.isArray(raw) ? raw : raw.data || raw.sessions || [];
+    return processRows(rows, options);
+}
+/**
+ * Import sessions from a CSV file.
+ */
+export function importFromCsv(filePath, options = {}) {
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.trim().split('\n');
+    if (lines.length < 2) {
+        throw new Error('CSV must have header row and at least one data row');
+    }
+    const headers = parseCsvLine(lines[0]);
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        const values = parseCsvLine(lines[i]);
+        const row = {};
+        headers.forEach((header, index) => {
+            const key = header.toLowerCase().trim().replace(/\s+/g, '_');
+            row[key] = values[index];
+        });
+        rows.push(row);
+    }
+    return processRows(rows, options);
+}
+/**
+ * Import from file (auto-detect format).
+ */
+export function importFromFile(filePath, options = {}) {
+    if (filePath.endsWith('.json')) {
+        return importFromJson(filePath, options);
+    }
+    if (filePath.endsWith('.csv')) {
+        return importFromCsv(filePath, options);
+    }
+    throw new Error('Unsupported file format. Use .json or .csv');
+}
+// =============================================================================
+// ROW PROCESSING
+// =============================================================================
+function processRows(rows, options) {
+    const startTime = Date.now();
+    const sessions = [];
+    for (const row of rows) {
+        const session = normalizeRow(row);
+        if (session) {
+            sessions.push(session);
+        }
+    }
+    // Determine period
+    const timestamps = sessions
+        .map((s) => s.timestamp)
+        .filter((t) => t)
+        .sort();
+    const start = options.startDate || timestamps[0]?.split('T')[0] || new Date().toISOString().split('T')[0];
+    const end = options.endDate || timestamps[timestamps.length - 1]?.split('T')[0] || new Date().toISOString().split('T')[0];
+    const startDate = new Date(start);
+    const endDate = new Date(end);
+    const days = Math.max(1, Math.ceil((endDate.getTime() - startDate.getTime()) / (1000 * 60 * 60 * 24)) + 1);
+    return {
+        sessions,
+        metadata: {
+            total_sessions: sessions.length,
+            sessions_with_lcp: sessions.filter((s) => s.lcp_ms !== null).length,
+            sessions_with_conversions: sessions.filter((s) => s.has_purchase).length,
+            query_time_ms: Date.now() - startTime,
+            period: { start, end, days },
+        },
+    };
+}
+function normalizeRow(row) {
+    // Get session ID
+    const sessionId = row.session_id || row.sessionId || row.id;
+    if (!sessionId)
+        return null;
+    // Parse LCP
+    const lcpRaw = row.lcp_ms ?? row.lcp;
+    const lcp = parseNumber(lcpRaw);
+    // Parse INP
+    const inpRaw = row.inp_ms ?? row.inp;
+    const inp = parseNumber(inpRaw);
+    // Parse CLS
+    const cls = parseNumber(row.cls);
+    // Parse conversion
+    const convertedRaw = row.converted ?? row.has_purchase ?? row.purchased;
+    const converted = parseBoolean(convertedRaw);
+    // Parse order value
+    const valueRaw = row.order_value ?? row.purchase_value ?? row.revenue ?? row.value;
+    const orderValue = converted ? (parseNumber(valueRaw) || 0) : 0;
+    // Parse device
+    const deviceRaw = row.device || row.device_type || 'desktop';
+    const device = normalizeDevice(deviceRaw);
+    // Parse page type
+    const pageType = row.page_type || row.page || 'unknown';
+    // Parse timestamp
+    const timestamp = row.timestamp || row.date || new Date().toISOString();
+    return {
+        session_id: String(sessionId),
+        lcp_ms: lcp,
+        inp_ms: inp,
+        cls,
+        has_purchase: converted,
+        purchase_value: orderValue,
+        device,
+        page_type: pageType,
+        timestamp,
+    };
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+function parseNumber(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const num = Number(value);
+    return isNaN(num) ? null : num;
+}
+function parseBoolean(value) {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return value !== 0;
+    if (typeof value === 'string') {
+        const lower = value.toLowerCase().trim();
+        return lower === 'true' || lower === '1' || lower === 'yes';
+    }
+    return false;
+}
+function normalizeDevice(value) {
+    const lower = value.toLowerCase();
+    if (lower.includes('mobile') || lower.includes('phone'))
+        return 'mobile';
+    if (lower.includes('tablet') || lower.includes('ipad'))
+        return 'tablet';
+    return 'desktop';
+}
+function parseCsvLine(line) {
+    const result = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        if (char === '"') {
+            inQuotes = !inQuotes;
+        }
+        else if (char === ',' && !inQuotes) {
+            result.push(current.trim());
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    result.push(current.trim());
+    return result;
+}
+//# sourceMappingURL=data-import.js.map

package/dist/empirical/data-import.js.map

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

package/dist/empirical/datadog-session-query.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Datadog Session Query
+ *
+ * Queries Datadog RUM for session-level data with Core Web Vitals AND conversion outcomes.
+ * This is the foundation for building empirical conversion curves.
+ *
+ * Prerequisites:
+ * - Datadog RUM installed with session tracking
+ * - Conversion actions tracked: datadogRum.addAction('purchase', { value: orderTotal })
+ *
+ * @author Kanmi Obasa <i@kanmiobasa.com>
+ */
+export interface SessionData {
+    session_id: string;
+    lcp_ms: number | null;
+    inp_ms: number | null;
+    cls: number | null;
+    has_purchase: boolean;
+    purchase_value: number;
+    device: 'mobile' | 'desktop' | 'tablet';
+    page_type: string;
+    timestamp: string;
+}
+export interface DatadogQueryConfig {
+    apiKey: string;
+    appKey: string;
+    site?: string;
+    startDate: string;
+    endDate: string;
+    pageTypes?: string[];
+    devices?: ('mobile' | 'desktop' | 'tablet')[];
+    purchaseActionName?: string;
+}
+export interface QueryResult {
+    sessions: SessionData[];
+    metadata: {
+        total_sessions: number;
+        sessions_with_lcp: number;
+        sessions_with_conversions: number;
+        query_time_ms: number;
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+    };
+}
+/**
+ * Query Datadog RUM for session-level data.
+ *
+ * Note: This uses the Datadog RUM Events API. In production, you'd want to
+ * use the RUM Analytics API for aggregations or export to a data warehouse.
+ */
+export declare function queryDatadogSessions(config: DatadogQueryConfig): Promise<QueryResult>;
+/**
+ * Generate mock session data for testing without Datadog credentials.
+ * Models realistic e-commerce conversion patterns.
+ */
+export declare function generateMockSessions(options: {
+    count: number;
+    startDate: string;
+    endDate: string;
+    baseConversionRate?: number;
+    lcpConversionImpact?: number;
+}): QueryResult;
+//# sourceMappingURL=datadog-session-query.d.ts.map

package/dist/empirical/datadog-session-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog-session-query.d.ts","sourceRoot":"","sources":["../../src/empirical/datadog-session-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IAEvB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,yBAAyB,EAAE,MAAM,CAAC;QAClC,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACtD,CAAC;CACH;AAMD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,WAAW,CAAC,CAuItB;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,WAAW,CAsEd"}

package/dist/empirical/datadog-session-query.js

@@ -0,0 +1,260 @@
+/**
+ * Datadog Session Query
+ *
+ * Queries Datadog RUM for session-level data with Core Web Vitals AND conversion outcomes.
+ * This is the foundation for building empirical conversion curves.
+ *
+ * Prerequisites:
+ * - Datadog RUM installed with session tracking
+ * - Conversion actions tracked: datadogRum.addAction('purchase', { value: orderTotal })
+ *
+ * @author Kanmi Obasa <i@kanmiobasa.com>
+ */
+// =============================================================================
+// DATADOG RUM API QUERY
+// =============================================================================
+/**
+ * Query Datadog RUM for session-level data.
+ *
+ * Note: This uses the Datadog RUM Events API. In production, you'd want to
+ * use the RUM Analytics API for aggregations or export to a data warehouse.
+ */
+export async function queryDatadogSessions(config) {
+    const startTime = Date.now();
+    const site = config.site || 'datadoghq.com';
+    const purchaseAction = config.purchaseActionName || 'purchase';
+    // Build the query filter
+    const filters = [
+        `@type:session`,
+        `@session.time_spent:>0`,
+    ];
+    if (config.pageTypes?.length) {
+        filters.push(`@view.url_path:(${config.pageTypes.join(' OR ')})`);
+    }
+    if (config.devices?.length) {
+        filters.push(`@device.type:(${config.devices.join(' OR ')})`);
+    }
+    // Query sessions with their LCP, INP, CLS values
+    const response = await fetch(`https://api.${site}/api/v2/rum/events/search`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'DD-API-KEY': config.apiKey,
+            'DD-APPLICATION-KEY': config.appKey,
+        },
+        body: JSON.stringify({
+            filter: {
+                query: filters.join(' '),
+                from: `${config.startDate}T00:00:00Z`,
+                to: `${config.endDate}T23:59:59Z`,
+            },
+            page: {
+                limit: 10000, // Datadog max per request
+            },
+            sort: '-timestamp',
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Datadog API error: ${response.status} - ${error}`);
+    }
+    const data = await response.json();
+    // Transform Datadog events to our session format
+    const sessions = [];
+    const sessionMap = new Map();
+    for (const event of data.data || []) {
+        const attrs = event.attributes;
+        const sessionId = attrs.session?.id;
+        if (!sessionId)
+            continue;
+        // Get or create session entry
+        let session = sessionMap.get(sessionId);
+        if (!session) {
+            session = {
+                session_id: sessionId,
+                lcp_ms: null,
+                inp_ms: null,
+                cls: null,
+                has_purchase: false,
+                purchase_value: 0,
+                device: normalizeDevice(attrs.device?.type),
+                page_type: extractPageType(attrs.view?.url_path),
+                timestamp: attrs['@timestamp'] || attrs.date,
+            };
+            sessionMap.set(sessionId, session);
+        }
+        // Update CWV if present (take worst/highest values)
+        if (attrs.view?.largest_contentful_paint != null) {
+            session.lcp_ms = Math.max(session.lcp_ms || 0, attrs.view.largest_contentful_paint);
+        }
+        if (attrs.view?.interaction_to_next_paint != null) {
+            session.inp_ms = Math.max(session.inp_ms || 0, attrs.view.interaction_to_next_paint);
+        }
+        if (attrs.view?.cumulative_layout_shift != null) {
+            session.cls = Math.max(session.cls || 0, attrs.view.cumulative_layout_shift);
+        }
+        // Check for purchase action
+        if (attrs.action?.type === 'custom' &&
+            attrs.action?.name === purchaseAction) {
+            session.has_purchase = true;
+            session.purchase_value += attrs.action?.custom?.value || 0;
+        }
+    }
+    sessions.push(...sessionMap.values());
+    // Calculate metadata
+    const sessionsWithLcp = sessions.filter((s) => s.lcp_ms !== null).length;
+    const sessionsWithConversions = sessions.filter((s) => s.has_purchase).length;
+    const startDate = new Date(config.startDate);
+    const endDate = new Date(config.endDate);
+    const days = Math.ceil((endDate.getTime() - startDate.getTime()) / (1000 * 60 * 60 * 24)) + 1;
+    return {
+        sessions,
+        metadata: {
+            total_sessions: sessions.length,
+            sessions_with_lcp: sessionsWithLcp,
+            sessions_with_conversions: sessionsWithConversions,
+            query_time_ms: Date.now() - startTime,
+            period: {
+                start: config.startDate,
+                end: config.endDate,
+                days,
+            },
+        },
+    };
+}
+// =============================================================================
+// MOCK DATA FOR TESTING
+// =============================================================================
+/**
+ * Generate mock session data for testing without Datadog credentials.
+ * Models realistic e-commerce conversion patterns.
+ */
+export function generateMockSessions(options) {
+    const startTime = Date.now();
+    const { count, startDate, endDate, baseConversionRate = 0.03, lcpConversionImpact = 0.85, } = options;
+    const sessions = [];
+    for (let i = 0; i < count; i++) {
+        // Generate realistic LCP distribution (log-normal)
+        const lcp = generateLogNormalLcp();
+        const inp = generateLogNormalInp();
+        const cls = generateCls();
+        // Calculate conversion probability based on LCP
+        // Empirical model: CVR drops as LCP increases
+        const lcpSeconds = lcp / 1000;
+        const lcpPenalty = Math.pow(lcpConversionImpact, Math.max(0, lcpSeconds - 1));
+        const conversionProbability = baseConversionRate * lcpPenalty;
+        const hasPurchase = Math.random() < conversionProbability;
+        const purchaseValue = hasPurchase ? generateOrderValue() : 0;
+        const device = weightedRandom([
+            { value: 'mobile', weight: 0.65 },
+            { value: 'desktop', weight: 0.30 },
+            { value: 'tablet', weight: 0.05 },
+        ]);
+        const pageType = weightedRandom([
+            { value: 'pdp', weight: 0.40 },
+            { value: 'plp', weight: 0.30 },
+            { value: 'checkout', weight: 0.15 },
+            { value: 'homepage', weight: 0.15 },
+        ]);
+        sessions.push({
+            session_id: `mock-${i}-${Date.now()}`,
+            lcp_ms: lcp,
+            inp_ms: inp,
+            cls,
+            has_purchase: hasPurchase,
+            purchase_value: purchaseValue,
+            device,
+            page_type: pageType,
+            timestamp: generateRandomTimestamp(startDate, endDate),
+        });
+    }
+    const sessionsWithLcp = sessions.filter((s) => s.lcp_ms !== null).length;
+    const sessionsWithConversions = sessions.filter((s) => s.has_purchase).length;
+    const start = new Date(startDate);
+    const end = new Date(endDate);
+    const days = Math.ceil((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24)) + 1;
+    return {
+        sessions,
+        metadata: {
+            total_sessions: sessions.length,
+            sessions_with_lcp: sessionsWithLcp,
+            sessions_with_conversions: sessionsWithConversions,
+            query_time_ms: Date.now() - startTime,
+            period: { start: startDate, end: endDate, days },
+        },
+    };
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+function normalizeDevice(type) {
+    if (!type)
+        return 'desktop';
+    const normalized = type.toLowerCase();
+    if (normalized.includes('mobile') || normalized.includes('phone'))
+        return 'mobile';
+    if (normalized.includes('tablet') || normalized.includes('ipad'))
+        return 'tablet';
+    return 'desktop';
+}
+function extractPageType(urlPath) {
+    if (!urlPath)
+        return 'unknown';
+    const path = urlPath.toLowerCase();
+    if (path.includes('/product/') || path.includes('/p/'))
+        return 'pdp';
+    if (path.includes('/category/') || path.includes('/c/') || path.includes('/shop/'))
+        return 'plp';
+    if (path.includes('/checkout') || path.includes('/cart'))
+        return 'checkout';
+    if (path === '/' || path.includes('/home'))
+        return 'homepage';
+    return 'other';
+}
+function generateLogNormalLcp() {
+    // Log-normal distribution centered around 2.5s with variance
+    const mu = Math.log(2500);
+    const sigma = 0.5;
+    const u1 = Math.random();
+    const u2 = Math.random();
+    const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+    return Math.round(Math.exp(mu + sigma * z));
+}
+function generateLogNormalInp() {
+    // INP centered around 150ms
+    const mu = Math.log(150);
+    const sigma = 0.6;
+    const u1 = Math.random();
+    const u2 = Math.random();
+    const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+    return Math.round(Math.exp(mu + sigma * z));
+}
+function generateCls() {
+    // CLS: most are low, some are high
+    const base = Math.random() * 0.1;
+    const spike = Math.random() < 0.1 ? Math.random() * 0.3 : 0;
+    return Math.round((base + spike) * 1000) / 1000;
+}
+function generateOrderValue() {
+    // Typical e-commerce AOV distribution
+    const base = 50 + Math.random() * 100;
+    const highValue = Math.random() < 0.1 ? Math.random() * 300 : 0;
+    return Math.round((base + highValue) * 100) / 100;
+}
+function weightedRandom(options) {
+    const total = options.reduce((sum, opt) => sum + opt.weight, 0);
+    let random = Math.random() * total;
+    for (const opt of options) {
+        random -= opt.weight;
+        if (random <= 0)
+            return opt.value;
+    }
+    return options[0].value;
+}
+function generateRandomTimestamp(start, end) {
+    const startMs = new Date(start).getTime();
+    const endMs = new Date(end).getTime();
+    const randomMs = startMs + Math.random() * (endMs - startMs);
+    return new Date(randomMs).toISOString();
+}
+//# sourceMappingURL=datadog-session-query.js.map

package/dist/empirical/datadog-session-query.js.map

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

package/dist/empirical/index.d.ts

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * Empirical Performance Revenue Engine
+ *
+ * A simpler, more transparent approach to performance-revenue analysis.
+ * Uses actual session-level data to build empirical conversion curves.
+ *
+ * Key differences from coefficient-based models:
+ * - No assumed "0.5% CVR per 100ms LCP" coefficients
+ * - Measures actual CVR at each performance bucket from YOUR data
+ * - More honest about what we know vs. assume
+ *
+ * Usage:
+ *   // With Datadog credentials
+ *   const result = await analyzeWithDatadog({
+ *     apiKey: 'xxx',
+ *     appKey: 'xxx',
+ *     startDate: '2024-01-01',
+ *     endDate: '2024-01-14',
+ *   });
+ *
+ *   // With mock data (for testing)
+ *   const result = analyzeWithMockData({
+ *     sessionCount: 50000,
+ *     startDate: '2024-01-01',
+ *     endDate: '2024-01-14',
+ *   });
+ *
+ * @author Kanmi Obasa <i@kanmiobasa.com>
+ */
+import { type DatadogQueryConfig } from './datadog-session-query.js';
+import { type ConversionCurve } from './conversion-curve.js';
+import { type OpportunityReport } from './opportunity-calculator.js';
+export interface AnalysisResult {
+    /** Empirical conversion curves */
+    curves: {
+        lcp: ConversionCurve;
+        inp: ConversionCurve;
+        cls: ConversionCurve;
+    };
+    /** Revenue opportunity analysis */
+    opportunities: {
+        lcp: OpportunityReport;
+        inp: OpportunityReport;
+        cls: OpportunityReport;
+    };
+    /** The single highest-impact opportunity */
+    topOpportunity: {
+        metric: 'lcp' | 'inp' | 'cls';
+        monthlyRevenue: number;
+        summary: string;
+    } | null;
+    /** Generated markdown report */
+    report: string;
+    /** Query metadata */
+    metadata: {
+        totalSessions: number;
+        sessionsWithLcp: number;
+        sessionsWithConversions: number;
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+    };
+}
+export interface DatadogAnalysisOptions extends DatadogQueryConfig {
+    clientName?: string;
+}
+export interface MockAnalysisOptions {
+    sessionCount: number;
+    startDate: string;
+    endDate: string;
+    clientName?: string;
+    baseConversionRate?: number;
+}
+export interface FileAnalysisOptions {
+    filePath: string;
+    clientName?: string;
+    startDate?: string;
+    endDate?: string;
+}
+/**
+ * Run full analysis using Datadog RUM data.
+ */
+export declare function analyzeWithDatadog(options: DatadogAnalysisOptions): Promise<AnalysisResult>;
+/**
+ * Run analysis with mock data (for testing/demo).
+ */
+export declare function analyzeWithMockData(options: MockAnalysisOptions): AnalysisResult;
+/**
+ * Run analysis from CSV or JSON file.
+ * Bring your own data from any source.
+ */
+export declare function analyzeFromFile(options: FileAnalysisOptions): AnalysisResult;
+/**
+ * CLI entry point.
+ */
+export declare function main(): Promise<void>;
+export type { SessionData, DatadogQueryConfig, QueryResult } from './datadog-session-query.js';
+export type { ConversionCurve, ConversionBucket, CurveBuilderConfig } from './conversion-curve.js';
+export type { OpportunityReport, OpportunityScenario, OpportunityConfig } from './opportunity-calculator.js';
+export type { ReportConfig, FullReport } from './report.js';
+export { queryDatadogSessions, generateMockSessions } from './datadog-session-query.js';
+export { buildConversionCurve, buildAllCurves, buildSegmentedCurves } from './conversion-curve.js';
+export { calculateOpportunity, calculateAllOpportunities, getTopOpportunity } from './opportunity-calculator.js';
+export { generateReport } from './report.js';
+export { importFromFile, importFromCsv, importFromJson } from './data-import.js';
+//# sourceMappingURL=index.d.ts.map

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

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