flowgrid-sdk 1.2.1 → 1.4.1

package/dist/lib/features/enterprise/forecasting.d.ts

@@ -290,10 +290,6 @@ export declare class Forecasting extends FlowGridTransport {
      * Forecast signups.
      */
     forecastSignups(config: ForecastConfig): Promise<ForecastResult>;
-    /**
-     * Get capacity planning forecast.
-     */
-    getCapacityPlanning(config: CapacityPlanningConfig): Promise<CapacityPlanningResult>;
     /**
      * Compare forecast scenarios.
      */
@@ -302,50 +298,4 @@ export declare class Forecasting extends FlowGridTransport {
      * Forecast custom metric.
      */
     forecastCustomMetric(metricName: string, config: Omit<ForecastConfig, 'metric' | 'customMetricName'>): Promise<ForecastResult>;
-    /**
-     * Get forecast accuracy report.
-     */
-    getForecastAccuracy(metric: ForecastMetric, lookbackPeriods: number): Promise<{
-        metric: ForecastMetric;
-        periods: Array<{
-            period: string;
-            predicted: number;
-            actual: number;
-            error: number;
-            errorPercent: number;
-        }>;
-        overallAccuracy: {
-            mape: number;
-            rmse: number;
-            r2: number;
-        };
-    }>;
-    /**
-     * Get growth projections.
-     */
-    getGrowthProjections(periods: number, granularity: TimeGranularity): Promise<{
-        users: ForecastResult;
-        revenue: ForecastResult;
-        engagement: ForecastResult;
-        summary: {
-            projectedUsersEnd: number;
-            projectedRevenueEnd: MoneyValue;
-            avgMonthlyGrowth: number;
-        };
-    }>;
-    /**
-     * Get what-if analysis.
-     */
-    getWhatIfAnalysis(baseMetric: ForecastMetric, adjustments: Array<{
-        factor: string;
-        change: number;
-    }>, periods: number): Promise<{
-        baseline: ForecastResult;
-        adjusted: ForecastResult;
-        impact: {
-            absoluteDiff: number;
-            percentDiff: number;
-            sensitivityScore: number;
-        };
-    }>;
 }

package/dist/lib/features/enterprise/forecasting.js

@@ -0,0 +1,232 @@
+/**
+ * @fileoverview Enterprise - Product Usage Forecasting
+ * @module features/enterprise/forecasting
+ *
+ * @description
+ * Predict usage, adoption, and revenue trends using historical data
+ * and machine learning models.
+ *
+ * @useCases
+ * - Project active user growth
+ * - Forecast feature adoption
+ * - Predict churn and revenue
+ * - Capacity planning
+ * - Trend analysis
+ *
+ * @metrics
+ * - Predicted DAU/MAU
+ * - Feature adoption forecast
+ * - Revenue projection
+ * - Churn prediction
+ * - Forecast accuracy
+ *
+ * @chartData
+ * - Line chart: Forecast with confidence
+ * - Area chart: Prediction range
+ * - Comparison: Predicted vs actual
+ * - Table: Forecast metrics
+ *
+ * @example
+ * ```typescript
+ * const forecasting = new Forecasting(webId, endpoint, apiKey);
+ *
+ * // Get user growth forecast
+ * const forecast = await forecasting.forecastActiveUsers({
+ *   metric: 'dau',
+ *   periods: 30,
+ *   granularity: 'day'
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Calculate MAPE (Mean Absolute Percentage Error).
+ */
+export function calculateMAPE(actual, predicted) {
+    if (actual.length !== predicted.length || actual.length === 0)
+        return 0;
+    let sum = 0;
+    let count = 0;
+    for (let i = 0; i < actual.length; i++) {
+        if (actual[i] !== 0) {
+            sum += Math.abs((actual[i] - predicted[i]) / actual[i]);
+            count++;
+        }
+    }
+    return count > 0 ? Math.round((sum / count) * 10000) / 100 : 0;
+}
+/**
+ * Calculate RMSE (Root Mean Square Error).
+ */
+export function calculateRMSE(actual, predicted) {
+    if (actual.length !== predicted.length || actual.length === 0)
+        return 0;
+    let sumSquaredError = 0;
+    for (let i = 0; i < actual.length; i++) {
+        sumSquaredError += Math.pow(actual[i] - predicted[i], 2);
+    }
+    return Math.round(Math.sqrt(sumSquaredError / actual.length) * 100) / 100;
+}
+/**
+ * Calculate R-squared.
+ */
+export function calculateR2(actual, predicted) {
+    if (actual.length !== predicted.length || actual.length === 0)
+        return 0;
+    const mean = actual.reduce((a, b) => a + b, 0) / actual.length;
+    let ssRes = 0;
+    let ssTot = 0;
+    for (let i = 0; i < actual.length; i++) {
+        ssRes += Math.pow(actual[i] - predicted[i], 2);
+        ssTot += Math.pow(actual[i] - mean, 2);
+    }
+    return ssTot !== 0 ? Math.round((1 - ssRes / ssTot) * 10000) / 10000 : 0;
+}
+/**
+ * Classify trend direction.
+ */
+export function classifyTrend(startValue, endValue, threshold = 5) {
+    if (startValue === 0)
+        return endValue > 0 ? 'growing' : 'stable';
+    const changePercent = ((endValue - startValue) / startValue) * 100;
+    if (changePercent > threshold)
+        return 'growing';
+    if (changePercent < -threshold)
+        return 'declining';
+    return 'stable';
+}
+/**
+ * Calculate average growth rate.
+ */
+export function calculateAvgGrowthRate(values) {
+    if (values.length < 2)
+        return 0;
+    let totalGrowth = 0;
+    let count = 0;
+    for (let i = 1; i < values.length; i++) {
+        if (values[i - 1] !== 0) {
+            totalGrowth += (values[i] - values[i - 1]) / values[i - 1];
+            count++;
+        }
+    }
+    return count > 0 ? Math.round((totalGrowth / count) * 10000) / 100 : 0;
+}
+/**
+ * Apply confidence interval.
+ */
+export function applyConfidenceInterval(predicted, stdError, confidenceLevel = 0.95) {
+    // Z-score for common confidence levels
+    const zScores = {
+        0.90: 1.645,
+        0.95: 1.96,
+        0.99: 2.576
+    };
+    const z = zScores[confidenceLevel] ?? 1.96;
+    const margin = z * stdError;
+    return {
+        lower: Math.max(0, predicted - margin),
+        upper: predicted + margin
+    };
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * Product usage forecasting class.
+ */
+export class Forecasting extends FlowGridTransport {
+    /**
+     * Forecast active users.
+     */
+    async forecastActiveUsers(config) {
+        return await this.initFeature("forecasting.active_users", {
+            type: "forecasting",
+            ...config,
+            model: config.model ?? 'ensemble',
+            includeConfidence: config.includeConfidence ?? true,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Forecast revenue.
+     */
+    async forecastRevenue(config) {
+        return await this.initFeature("forecasting.revenue", {
+            type: "forecasting",
+            ...config,
+            metric: 'revenue',
+            currency: config.currency ?? 'USD',
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Forecast MRR.
+     */
+    async forecastMRR(config) {
+        return await this.initFeature("forecasting.mrr", {
+            type: "forecasting",
+            ...config,
+            metric: 'mrr',
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Forecast feature adoption.
+     */
+    async forecastFeatureAdoption(config) {
+        return await this.initFeature("forecasting.feature_adoption", {
+            type: "forecasting",
+            ...config,
+            metric: 'feature_usage',
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Forecast churn.
+     */
+    async forecastChurn(config) {
+        return await this.initFeature("forecasting.churn", {
+            type: "forecasting",
+            ...config,
+            metric: 'churn_rate',
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Forecast signups.
+     */
+    async forecastSignups(config) {
+        return await this.initFeature("forecasting.signups", {
+            type: "forecasting",
+            ...config,
+            metric: 'signups',
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Compare forecast scenarios.
+     */
+    async compareScenarios(config) {
+        return await this.initFeature("forecasting.scenarios", {
+            type: "forecasting",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Forecast custom metric.
+     */
+    async forecastCustomMetric(metricName, config) {
+        return await this.initFeature("forecasting.custom", {
+            type: "forecasting",
+            ...config,
+            metric: 'custom',
+            customMetricName: metricName,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+//# sourceMappingURL=forecasting.js.map

package/dist/lib/features/enterprise/forecasting.js.map

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

package/dist/lib/features/enterprise/index.d.ts

@@ -16,5 +16,5 @@ export { SupportAnalytics, type TicketPriority, type TicketStatus, type SupportC
 export { AcquisitionAnalytics, type AcquisitionSource, type LifecycleStage, type AcquisitionConfig, type CampaignDefinition, type CampaignSpendConfig, type LifecycleTransitionConfig, type CACConfig, type CACResult, type TrialFunnelConfig, type TrialFunnelResult, type CampaignPerformance, type AttributionModel, type AttributionAnalysisConfig, type AttributionResult, type AcquisitionAnalytics as AcquisitionAnalyticsType, calculateCAC, calculateROAS, calculateLTVCACRatio, parseUTMParams, classifySource } from './acquisition';
 export { PathAnalytics, type TransitionConfig, type FeatureSequenceConfig, type PathDefinition, type PathAnalysisConfig, type PathResult, type DeadEndScreen, type TransitionMatrix, type UserJourneyConfig as PathUserJourneyConfig, type UserJourney as PathUserJourney, type FrictionPoint, type PathComparison, pathToString, stringToPath, calculateExitRate, isDeadEnd, calculatePathSimilarity, findCommonSubPaths } from './paths';
 export { AlertsAnalytics, type AlertCondition, type AlertSeverity, type AlertStatus, type NotificationChannel, type AlertRuleDefinition, type AlertInstance, type AnomalyDetectionConfig, type Anomaly, type NotificationConfig, type AlertAnalyticsFilter, type AlertAnalytics, calculateStdDev, calculateZScore, isAnomaly, calculateAnomalyScore, classifySeverity, checkAlertCondition } from './alerts';
-export { SecurityAnalytics, type SecurityEventType, type ComplianceEventType, type LoginAttemptConfig, type RoleChangeConfig, type PermissionChangeConfig, type DataAccessConfig, type ComplianceEventConfig, type AuditLogEntry, type SecurityAnalyticsFilter, type SecurityRiskAssessment, type SecurityAnalytics as SecurityAnalyticsType, type ComplianceReport, classifyRiskLevel as classifySecurityRiskLevel, calculateFailedLoginRate, isSuspiciousLoginPattern, determineEventSeverity } from './security';
+export { SecurityAnalytics, type SecurityEventType, type ComplianceEventType, type LoginAttemptConfig, type RoleChangeConfig, type PermissionChangeConfig, type DataAccessConfig, type ComplianceEventConfig, type AuditLogEntry, type SecurityAnalyticsFilter, type SecurityRiskAssessment, type SecurityAnalyticsResult as SecurityAnalyticsType, type ComplianceReport, classifyRiskLevel as classifySecurityRiskLevel, calculateFailedLoginRate, isSuspiciousLoginPattern, determineEventSeverity } from './security';
 export { Forecasting, type ForecastModel, type ForecastMetric, type ForecastConfig, type ForecastDataPoint, type ForecastResult, type RevenueForecastConfig as ForecastingRevenueForecastConfig, type RevenueForecastResult, type FeatureAdoptionForecastConfig, type ChurnForecastConfig, type ChurnForecastResult, type CapacityPlanningConfig, type CapacityPlanningResult, type ScenarioConfig, type ScenarioComparison, calculateMAPE, calculateRMSE, calculateR2, classifyTrend, calculateAvgGrowthRate, applyConfidenceInterval } from './forecasting';

package/dist/lib/features/enterprise/index.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Enterprise Features Module
+ * @module features/enterprise
+ *
+ * @description
+ * Advanced analytics features for enterprise-tier users.
+ * Includes engagement, cohorts, churn, monetization, funnels,
+ * support, acquisition, path analysis, alerts, security, and forecasting.
+ */
+// ============================================================================
+// ENGAGEMENT
+// ============================================================================
+export { Engagement, 
+// Helper functions
+calculateEngagementScore, classifyEngagementLevel, calculateSessionDepthScore } from './engagement';
+// ============================================================================
+// COHORTS & SEGMENTATION
+// ============================================================================
+export { Cohorts, 
+// Helper functions
+evaluateCohortRules, generateCohortId } from './cohorts';
+// ============================================================================
+// CHURN & PREDICTIVE ANALYTICS
+// ============================================================================
+export { ChurnAnalytics, 
+// Helper functions
+calculateChurnRiskScore, classifyRiskLevel, generateRecommendations } from './churn';
+// ============================================================================
+// MONETIZATION
+// ============================================================================
+export { Monetization, 
+// Helper functions
+calculateARPU, calculateNRR, calculateGRR, monthlyToAnnual, calculateLTV } from './monetization';
+// ============================================================================
+// MULTI-PATH FUNNELS & MICRO-CONVERSIONS
+// ============================================================================
+export { MultiPathFunnels, 
+// Helper functions
+calculateConversionRate, calculateDropOffRate, findBestPath, calculateMicroConversionScore, generatePathId } from './multi-path-funnels';
+// ============================================================================
+// SUPPORT & EXPERIENCE
+// ============================================================================
+export { SupportAnalytics, 
+// Helper functions
+calculateFCRRate, calculateAvgResponseTime, classifyCSAT, formatDuration } from './support';
+// ============================================================================
+// ACQUISITION & MARKETING
+// ============================================================================
+export { AcquisitionAnalytics, 
+// Helper functions
+calculateCAC, calculateROAS, calculateLTVCACRatio, parseUTMParams, classifySource } from './acquisition';
+// ============================================================================
+// PATH & BEHAVIORAL ANALYSIS
+// ============================================================================
+export { PathAnalytics, 
+// Helper functions
+pathToString, stringToPath, calculateExitRate, isDeadEnd, calculatePathSimilarity, findCommonSubPaths } from './paths';
+// ============================================================================
+// ALERTS & ANOMALY DETECTION
+// ============================================================================
+export { AlertsAnalytics, 
+// Helper functions
+calculateStdDev, calculateZScore, isAnomaly, calculateAnomalyScore, classifySeverity, checkAlertCondition } from './alerts';
+// ============================================================================
+// SECURITY & COMPLIANCE
+// ============================================================================
+export { SecurityAnalytics, 
+// Helper functions
+classifyRiskLevel as classifySecurityRiskLevel, calculateFailedLoginRate, isSuspiciousLoginPattern, determineEventSeverity } from './security';
+// ============================================================================
+// FORECASTING
+// ============================================================================
+export { Forecasting, 
+// Helper functions
+calculateMAPE, calculateRMSE, calculateR2, classifyTrend, calculateAvgGrowthRate, applyConfidenceInterval } from './forecasting';
+//# sourceMappingURL=index.js.map

package/dist/lib/features/enterprise/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/features/enterprise/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAC/E,OAAO,EACL,UAAU;AAWV,mBAAmB;AACnB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,cAAc,CAAC;AAEtB,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAC/E,OAAO,EACL,OAAO;AAcP,mBAAmB;AACnB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAEnB,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAC/E,OAAO,EACL,cAAc;AAWd,mBAAmB;AACnB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAC/E,OAAO,EACL,YAAY;AAiBZ,mBAAmB;AACnB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAC/E,OAAO,EACL,gBAAgB;AAchB,mBAAmB;AACnB,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAC/E,OAAO,EACL,gBAAgB;AAchB,mBAAmB;AACnB,gBAAgB,EAChB,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACf,MAAM,WAAW,CAAC;AAEnB,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAC/E,OAAO,EACL,oBAAoB;AAiBpB,mBAAmB;AACnB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,cAAc,EACf,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAC/E,OAAO,EACL,aAAa;AAab,mBAAmB;AACnB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAC/E,OAAO,EACL,eAAe;AAaf,mBAAmB;AACnB,eAAe,EACf,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAC/E,OAAO,EACL,iBAAiB;AAcjB,mBAAmB;AACnB,iBAAiB,IAAI,yBAAyB,EAC9C,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAC/E,OAAO,EACL,WAAW;AAgBX,mBAAmB;AACnB,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,eAAe,CAAC"}

package/dist/lib/features/enterprise/monetization.d.ts

@@ -44,7 +44,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity, MoneyValue, CurrencyCode } from "../../types";
+import { DateRangeFilter, TimeSeriesData, MoneyValue, CurrencyCode } from "../../types";
 /**
  * Revenue event types.
  */
@@ -294,63 +294,4 @@ export declare class Monetization extends FlowGridTransport {
     trackContraction(userId: string, fromPlan: string, toPlan: string, reducedRevenue: MoneyValue): Promise<{
         tracked: boolean;
     }>;
-    /**
-     * Get ARPU.
-     */
-    getARPU(config?: ARPUConfig): Promise<ARPUResult>;
-    /**
-     * Get ARPU by segment.
-     */
-    getARPUBySegment(segmentAttribute: string, filter?: DateRangeFilter): Promise<Array<{
-        segment: string;
-        arpu: MoneyValue;
-        userCount: number;
-    }>>;
-    /**
-     * Get cohort revenue analysis.
-     */
-    getCohortRevenue(config: CohortRevenueConfig): Promise<CohortRevenueResult>;
-    /**
-     * Get plan analysis.
-     */
-    getPlanAnalysis(config?: PlanAnalysisConfig): Promise<PlanAnalysis[]>;
-    /**
-     * Get revenue breakdown.
-     */
-    getRevenueBreakdown(config: RevenueBreakdownConfig): Promise<RevenueBreakdown>;
-    /**
-     * Get Net Revenue Retention.
-     */
-    getNRR(config?: NRRConfig): Promise<NRRResult>;
-    /**
-     * Get MRR.
-     */
-    getMRR(filter?: DateRangeFilter): Promise<MoneyValue>;
-    /**
-     * Get ARR.
-     */
-    getARR(filter?: DateRangeFilter): Promise<MoneyValue>;
-    /**
-     * Get revenue forecast.
-     */
-    getRevenueForecast(config: RevenueForecastConfig): Promise<RevenueForecast>;
-    /**
-     * Get monetization analytics.
-     */
-    getAnalytics(filter?: DateRangeFilter): Promise<MonetizationAnalytics>;
-    /**
-     * Get revenue trend.
-     */
-    getRevenueTrend(filter?: DateRangeFilter, granularity?: TimeGranularity): Promise<TimeSeriesData>;
-    /**
-     * Get MRR movement (waterfall).
-     */
-    getMRRMovement(filter?: DateRangeFilter): Promise<{
-        starting: MoneyValue;
-        newBusiness: MoneyValue;
-        expansion: MoneyValue;
-        contraction: MoneyValue;
-        churn: MoneyValue;
-        ending: MoneyValue;
-    }>;
 }

package/dist/lib/features/enterprise/monetization.js

@@ -0,0 +1,146 @@
+/**
+ * @fileoverview Enterprise - Revenue & Monetization Analytics
+ * @module features/enterprise/monetization
+ *
+ * @description
+ * Track detailed revenue and monetization KPIs including ARPU,
+ * cohort-based revenue, and pricing plan impact analysis.
+ *
+ * @useCases
+ * - Calculate ARPU/ARPA per segment
+ * - Track cohort-based revenue
+ * - Analyze pricing plan impact
+ * - Revenue forecasting
+ * - Expansion revenue tracking
+ *
+ * @metrics
+ * - ARPU (Average Revenue Per User)
+ * - ARPA (Average Revenue Per Account)
+ * - Revenue by cohort
+ * - Revenue by plan
+ * - Expansion revenue
+ * - Net Revenue Retention
+ *
+ * @chartData
+ * - Line chart: Revenue over time
+ * - Bar chart: Revenue by segment
+ * - Waterfall: Revenue movement
+ * - Cohort: Revenue retention
+ *
+ * @example
+ * ```typescript
+ * const monetization = new Monetization(webId, endpoint, apiKey);
+ *
+ * // Get ARPU by segment
+ * const arpu = await monetization.getARPU({ segment: 'enterprise' });
+ *
+ * // Track revenue event
+ * await monetization.trackRevenue({
+ *   userId: 'user_123',
+ *   amount: 99.00,
+ *   currency: 'USD',
+ *   type: 'subscription'
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Calculate ARPU from total revenue and user count.
+ */
+export function calculateARPU(totalRevenue, userCount, currency) {
+    const arpu = userCount > 0 ? totalRevenue / userCount : 0;
+    return {
+        amount: Math.round(arpu * 100) / 100,
+        currency
+    };
+}
+/**
+ * Calculate Net Revenue Retention.
+ */
+export function calculateNRR(startingMRR, expansion, contraction, churned) {
+    if (startingMRR === 0)
+        return 0;
+    return Math.round(((startingMRR + expansion - contraction - churned) / startingMRR) * 10000) / 100;
+}
+/**
+ * Calculate Gross Revenue Retention.
+ */
+export function calculateGRR(startingMRR, contraction, churned) {
+    if (startingMRR === 0)
+        return 0;
+    return Math.round(((startingMRR - contraction - churned) / startingMRR) * 10000) / 100;
+}
+/**
+ * Convert monthly to annual revenue.
+ */
+export function monthlyToAnnual(mrr) {
+    return {
+        amount: mrr.amount * 12,
+        currency: mrr.currency
+    };
+}
+/**
+ * Calculate LTV from ARPU and churn rate.
+ */
+export function calculateLTV(arpu, monthlyChurnRate, currency) {
+    if (monthlyChurnRate <= 0) {
+        return { amount: arpu * 60, currency }; // Cap at 5 years
+    }
+    const ltv = arpu / monthlyChurnRate;
+    return {
+        amount: Math.round(ltv * 100) / 100,
+        currency
+    };
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * Revenue and monetization analytics class.
+ */
+export class Monetization extends FlowGridTransport {
+    /**
+     * Track revenue event.
+     */
+    async trackRevenue(config) {
+        const { type: revenueType, ...restConfig } = config;
+        return await this.initFeature("monetization.revenue", {
+            type: "monetization",
+            revenueType,
+            ...restConfig,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track expansion revenue.
+     */
+    async trackExpansion(userId, fromPlan, toPlan, additionalRevenue) {
+        return await this.initFeature("monetization.expansion", {
+            type: "monetization",
+            userId,
+            fromPlan,
+            toPlan,
+            additionalRevenue,
+            revenueType: 'expansion',
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track contraction/downgrade.
+     */
+    async trackContraction(userId, fromPlan, toPlan, reducedRevenue) {
+        return await this.initFeature("monetization.contraction", {
+            type: "monetization",
+            userId,
+            fromPlan,
+            toPlan,
+            reducedRevenue,
+            revenueType: 'downgrade',
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+//# sourceMappingURL=monetization.js.map

package/dist/lib/features/enterprise/monetization.js.map

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

package/dist/lib/features/enterprise/multi-path-funnels.d.ts

@@ -41,7 +41,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
+import { DateRangeFilter } from "../../types";
 /**
  * Funnel path definition.
  */
@@ -299,22 +299,6 @@ export declare class MultiPathFunnels extends FlowGridTransport {
      * Get path comparison.
      */
     comparePaths(funnelId: string, filter?: DateRangeFilter): Promise<PathAnalysis[]>;
-    /**
-     * Get segment drop-off analysis.
-     */
-    getSegmentDropOff(funnelId: string, segmentAttribute: string, filter?: DateRangeFilter): Promise<SegmentDropOffAnalysis>;
-    /**
-     * Get user journey.
-     */
-    getUserJourney(config: UserJourneyConfig): Promise<UserJourney>;
-    /**
-     * Get micro-conversion analysis.
-     */
-    getMicroConversionAnalysis(funnelId: string, filter?: DateRangeFilter): Promise<MicroConversionAnalysis[]>;
-    /**
-     * Get funnel trend.
-     */
-    getFunnelTrend(funnelId: string, filter?: DateRangeFilter, granularity?: TimeGranularity): Promise<TimeSeriesData>;
     /**
      * List all funnels.
      */