flowgrid-sdk 1.2.1 → 1.4.1

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

@@ -41,7 +41,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
+import { DateRangeFilter, TimeSeriesData } from "../../types";
 /**
  * Alert condition types.
  */
@@ -269,22 +269,12 @@ export declare class AlertsAnalytics extends FlowGridTransport {
     toggleAlert(alertId: string, enabled: boolean): Promise<{
         updated: boolean;
     }>;
-    /**
-     * Get alert rule.
-     */
-    getAlert(alertId: string): Promise<AlertRuleDefinition & {
-        alertId: string;
-    }>;
     /**
      * List all alert rules.
      */
     listAlerts(enabled?: boolean): Promise<Array<AlertRuleDefinition & {
         alertId: string;
     }>>;
-    /**
-     * Get triggered alerts.
-     */
-    getTriggeredAlerts(filter?: AlertAnalyticsFilter): Promise<AlertInstance[]>;
     /**
      * Acknowledge an alert.
      */
@@ -307,10 +297,6 @@ export declare class AlertsAnalytics extends FlowGridTransport {
      * Run anomaly detection.
      */
     detectAnomalies(config: AnomalyDetectionConfig): Promise<Anomaly[]>;
-    /**
-     * Get historical anomalies.
-     */
-    getAnomalies(filter?: AlertAnalyticsFilter): Promise<Anomaly[]>;
     /**
      * Configure notification channel.
      */
@@ -323,26 +309,4 @@ export declare class AlertsAnalytics extends FlowGridTransport {
     testNotification(channel: NotificationChannel): Promise<{
         success: boolean;
     }>;
-    /**
-     * Get alert analytics.
-     */
-    getAnalytics(filter?: AlertAnalyticsFilter): Promise<AlertAnalytics>;
-    /**
-     * Get metric with anomaly overlay.
-     */
-    getMetricWithAnomalies(metric: string, filter?: DateRangeFilter, granularity?: TimeGranularity): Promise<{
-        data: TimeSeriesData;
-        anomalies: Array<{
-            timestamp: string;
-            score: number;
-        }>;
-    }>;
-    /**
-     * Get alert correlation analysis.
-     */
-    getAlertCorrelation(filter?: DateRangeFilter): Promise<Array<{
-        alertPair: [string, string];
-        correlation: number;
-        coOccurrences: number;
-    }>>;
 }

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

@@ -0,0 +1,246 @@
+/**
+ * @fileoverview Enterprise - Alerts & Anomaly Detection
+ * @module features/enterprise/alerts
+ *
+ * @description
+ * Proactively monitor anomalies in key metrics and trigger alerts.
+ * Detect activation drops, error spikes, and custom threshold breaches.
+ *
+ * @useCases
+ * - Monitor for activation drops
+ * - Detect error/churn spikes
+ * - Set custom alert rules
+ * - Threshold monitoring
+ * - Real-time anomaly detection
+ *
+ * @metrics
+ * - Alert frequency
+ * - Time to detection
+ * - False positive rate
+ * - Alert resolution time
+ * - Metric anomaly score
+ *
+ * @chartData
+ * - Line chart: Metric with anomaly markers
+ * - Timeline: Alert history
+ * - Bar chart: Alerts by type
+ * - Dashboard: Alert status
+ *
+ * @example
+ * ```typescript
+ * const alerts = new AlertsAnalytics(webId, endpoint, apiKey);
+ *
+ * // Create an alert rule
+ * await alerts.createAlert({
+ *   name: 'Activation Drop',
+ *   metric: 'activation_rate',
+ *   condition: 'drops_below',
+ *   threshold: 50,
+ *   severity: 'high'
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Calculate standard deviation.
+ */
+export function calculateStdDev(values) {
+    if (values.length === 0)
+        return 0;
+    const mean = values.reduce((a, b) => a + b, 0) / values.length;
+    const squareDiffs = values.map(value => Math.pow(value - mean, 2));
+    const avgSquareDiff = squareDiffs.reduce((a, b) => a + b, 0) / squareDiffs.length;
+    return Math.sqrt(avgSquareDiff);
+}
+/**
+ * Calculate Z-score for anomaly detection.
+ */
+export function calculateZScore(value, mean, stdDev) {
+    if (stdDev === 0)
+        return 0;
+    return (value - mean) / stdDev;
+}
+/**
+ * Determine if value is anomalous based on Z-score.
+ */
+export function isAnomaly(zScore, sensitivity = 0.5) {
+    // Higher sensitivity = lower threshold for anomaly detection
+    const threshold = 4 - (sensitivity * 2); // Ranges from 2 to 4
+    return Math.abs(zScore) > threshold;
+}
+/**
+ * Calculate anomaly score (0-1).
+ */
+export function calculateAnomalyScore(zScore) {
+    // Normalize Z-score to 0-1 range
+    const absZ = Math.abs(zScore);
+    if (absZ <= 2)
+        return absZ / 10;
+    if (absZ <= 3)
+        return 0.2 + (absZ - 2) * 0.3;
+    if (absZ <= 4)
+        return 0.5 + (absZ - 3) * 0.3;
+    return Math.min(0.8 + (absZ - 4) * 0.1, 1);
+}
+/**
+ * Classify severity from anomaly score.
+ */
+export function classifySeverity(anomalyScore) {
+    if (anomalyScore < 0.25)
+        return 'info';
+    if (anomalyScore < 0.5)
+        return 'warning';
+    if (anomalyScore < 0.75)
+        return 'high';
+    return 'critical';
+}
+/**
+ * Check if alert condition is met.
+ */
+export function checkAlertCondition(currentValue, condition, threshold, previousValue, changePercent) {
+    switch (condition) {
+        case 'exceeds':
+            return currentValue > threshold;
+        case 'drops_below':
+            return currentValue < threshold;
+        case 'changes_by':
+            if (previousValue === undefined || changePercent === undefined)
+                return false;
+            const change = Math.abs((currentValue - previousValue) / previousValue) * 100;
+            return change >= changePercent;
+        case 'no_data':
+            return currentValue === 0 || currentValue === null;
+        default:
+            return false;
+    }
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * Alerts and anomaly detection class.
+ */
+export class AlertsAnalytics extends FlowGridTransport {
+    /**
+     * Create an alert rule.
+     */
+    async createAlert(definition) {
+        return await this.initFeature("alerts.create", {
+            type: "alerts",
+            ...definition,
+            alertId: definition.alertId ??
+                definition.name.toLowerCase().replace(/[^a-z0-9]+/g, '_'),
+            enabled: definition.enabled ?? true,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Update an alert rule.
+     */
+    async updateAlert(alertId, updates) {
+        return await this.initFeature("alerts.update", {
+            type: "alerts",
+            alertId,
+            ...updates,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Delete an alert rule.
+     */
+    async deleteAlert(alertId) {
+        return await this.initFeature("alerts.delete", {
+            type: "alerts",
+            alertId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Enable/disable an alert.
+     */
+    async toggleAlert(alertId, enabled) {
+        return await this.initFeature("alerts.toggle", {
+            type: "alerts",
+            alertId,
+            enabled,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * List all alert rules.
+     */
+    async listAlerts(enabled) {
+        return await this.initFeature("alerts.list", {
+            type: "alerts",
+            enabled,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Acknowledge an alert.
+     */
+    async acknowledgeAlert(instanceId, acknowledgedBy) {
+        return await this.initFeature("alerts.acknowledge", {
+            type: "alerts",
+            instanceId,
+            acknowledgedBy,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Resolve an alert.
+     */
+    async resolveAlert(instanceId, notes) {
+        return await this.initFeature("alerts.resolve", {
+            type: "alerts",
+            instanceId,
+            notes,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Mute an alert temporarily.
+     */
+    async muteAlert(alertId, durationMinutes) {
+        return await this.initFeature("alerts.mute", {
+            type: "alerts",
+            alertId,
+            durationMinutes,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Run anomaly detection.
+     */
+    async detectAnomalies(config) {
+        return await this.initFeature("alerts.detect_anomalies", {
+            type: "alerts",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Configure notification channel.
+     */
+    async configureNotification(config) {
+        return await this.initFeature("alerts.configure_notification", {
+            type: "alerts",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Test notification channel.
+     */
+    async testNotification(channel) {
+        return await this.initFeature("alerts.test_notification", {
+            type: "alerts",
+            channel,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+//# sourceMappingURL=alerts.js.map

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

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

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

@@ -38,7 +38,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
+import { DateRangeFilter, TimeSeriesData } from "../../types";
 /**
  * Churn risk factors.
  */
@@ -215,18 +215,6 @@ export declare function generateRecommendations(riskFactors: Array<{
  * Churn and predictive analytics class.
  */
 export declare class ChurnAnalytics extends FlowGridTransport {
-    /**
-     * Get user churn risk score.
-     */
-    getUserRiskScore(userId: string): Promise<ChurnRiskScore>;
-    /**
-     * Get multiple users' risk scores.
-     */
-    getBulkRiskScores(userIds: string[]): Promise<ChurnRiskScore[]>;
-    /**
-     * Get at-risk users.
-     */
-    getAtRiskUsers(filter?: AtRiskUsersFilter): Promise<ChurnRiskScore[]>;
     /**
      * Track usage decay.
      */
@@ -256,33 +244,4 @@ export declare class ChurnAnalytics extends FlowGridTransport {
     updatePreventionOutcome(userId: string, actionType: string, outcome: 'success' | 'failed'): Promise<{
         updated: boolean;
     }>;
-    /**
-     * Get churn analytics.
-     */
-    getAnalytics(filter?: DateRangeFilter): Promise<ChurnAnalyticsResult>;
-    /**
-     * Get churn rate trend.
-     */
-    getChurnTrend(filter?: DateRangeFilter, granularity?: TimeGranularity): Promise<TimeSeriesData>;
-    /**
-     * Get churn by segment.
-     */
-    getChurnBySegment(segmentAttribute: string, filter?: DateRangeFilter): Promise<Array<{
-        segment: string;
-        churnRate: number;
-        count: number;
-    }>>;
-    /**
-     * Get NPS trend.
-     */
-    getNPSTrend(filter?: DateRangeFilter, granularity?: TimeGranularity): Promise<TimeSeriesData>;
-    /**
-     * Get prevention effectiveness.
-     */
-    getPreventionEffectiveness(filter?: DateRangeFilter): Promise<Array<{
-        actionType: string;
-        attempts: number;
-        successes: number;
-        rate: number;
-    }>>;
 }

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

@@ -0,0 +1,175 @@
+/**
+ * @fileoverview Enterprise - Churn & Predictive Analytics
+ * @module features/enterprise/churn
+ *
+ * @description
+ * Predict and measure churn proactively using usage patterns,
+ * engagement signals, and predictive scoring models.
+ *
+ * @useCases
+ * - Detect usage decay patterns
+ * - Identify at-risk users
+ * - Predict churn probability
+ * - Correlate NPS with churn
+ * - Track churn prevention success
+ *
+ * @metrics
+ * - Churn rate
+ * - Churn risk score
+ * - Days to churn prediction
+ * - At-risk user count
+ * - Prevention success rate
+ *
+ * @chartData
+ * - Line chart: Churn rate over time
+ * - Distribution: Risk score distribution
+ * - Bar chart: Churn by segment
+ * - Funnel: Churn prevention funnel
+ *
+ * @example
+ * ```typescript
+ * const churn = new ChurnAnalytics(webId, endpoint, apiKey);
+ *
+ * // Get user churn risk
+ * const risk = await churn.getUserRiskScore('user_123');
+ *
+ * // Get at-risk users
+ * const atRisk = await churn.getAtRiskUsers({ minScore: 70 });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Calculate churn risk score from factors.
+ */
+export function calculateChurnRiskScore(factors) {
+    const weights = {
+        daysSinceLastActivity: 0.25,
+        usageTrend: 0.20,
+        sessionFrequencyChange: 0.15,
+        featureUsageChange: 0.10,
+        supportTickets: 0.10,
+        npsScore: 0.10,
+        paymentFailures: 0.05,
+        daysUntilRenewal: 0.05
+    };
+    let score = 0;
+    // Days since last activity (0-30 days mapped to 0-100)
+    score += Math.min(factors.daysSinceLastActivity / 30, 1) * 100 * weights.daysSinceLastActivity;
+    // Usage trend (negative trend increases risk)
+    score += Math.max(0, -factors.usageTrend) * weights.usageTrend;
+    // Session frequency change (negative increases risk)
+    score += Math.max(0, -factors.sessionFrequencyChange) * weights.sessionFrequencyChange;
+    // Feature usage change (negative increases risk)
+    score += Math.max(0, -factors.featureUsageChange) * weights.featureUsageChange;
+    // Support tickets (more tickets = higher risk)
+    score += Math.min(factors.supportTickets * 10, 100) * weights.supportTickets;
+    // NPS score (lower NPS = higher risk)
+    if (factors.npsScore !== undefined) {
+        score += (100 - factors.npsScore * 10) * weights.npsScore;
+    }
+    // Payment failures
+    score += Math.min(factors.paymentFailures * 25, 100) * weights.paymentFailures;
+    // Days until renewal (closer = higher urgency)
+    if (factors.daysUntilRenewal !== undefined) {
+        score += Math.max(0, 100 - factors.daysUntilRenewal) * weights.daysUntilRenewal;
+    }
+    return Math.round(Math.min(score, 100));
+}
+/**
+ * Classify risk level from score.
+ */
+export function classifyRiskLevel(score) {
+    if (score < 25)
+        return 'low';
+    if (score < 50)
+        return 'medium';
+    if (score < 75)
+        return 'high';
+    return 'critical';
+}
+/**
+ * Generate churn prevention recommendations.
+ */
+export function generateRecommendations(riskFactors) {
+    const recommendations = [];
+    const factorActions = {
+        daysSinceLastActivity: 'Send a re-engagement email or push notification',
+        usageTrend: 'Schedule a product walkthrough or training session',
+        sessionFrequencyChange: 'Offer incentives to increase usage frequency',
+        featureUsageChange: 'Highlight underutilized features via in-app messaging',
+        supportTickets: 'Escalate to customer success for personalized support',
+        npsScore: 'Conduct a follow-up call to address concerns',
+        paymentFailures: 'Reach out to resolve payment issues proactively',
+        daysUntilRenewal: 'Start renewal conversation early with value recap'
+    };
+    for (const factor of riskFactors.slice(0, 3)) {
+        if (factorActions[factor.factor]) {
+            recommendations.push(factorActions[factor.factor]);
+        }
+    }
+    return recommendations;
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * Churn and predictive analytics class.
+ */
+export class ChurnAnalytics extends FlowGridTransport {
+    /**
+     * Track usage decay.
+     */
+    async trackUsageDecay(config) {
+        return await this.initFeature("churn.usage_decay", {
+            type: "churn",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track NPS score.
+     */
+    async trackNPS(config) {
+        return await this.initFeature("churn.nps", {
+            type: "churn",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track churn event.
+     */
+    async trackChurn(config) {
+        return await this.initFeature("churn.churn_event", {
+            type: "churn",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track churn prevention action.
+     */
+    async trackPreventionAction(config) {
+        return await this.initFeature("churn.prevention_action", {
+            type: "churn",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Update prevention action outcome.
+     */
+    async updatePreventionOutcome(userId, actionType, outcome) {
+        return await this.initFeature("churn.update_prevention_outcome", {
+            type: "churn",
+            userId,
+            actionType,
+            outcome,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+//# sourceMappingURL=churn.js.map

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

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

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

@@ -39,7 +39,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
+import { DateRangeFilter } from "../../types";
 /**
  * Cohort rule operators.
  */
@@ -211,60 +211,24 @@ export declare class Cohorts extends FlowGridTransport {
     deleteCohort(cohortId: string): Promise<{
         deleted: boolean;
     }>;
-    /**
-     * Get cohort by ID.
-     */
-    getCohort(cohortId: string): Promise<CohortResponse & {
-        rules: CohortRule[];
-    }>;
     /**
      * List all cohorts.
      */
     listCohorts(filter?: CohortAnalyticsFilter): Promise<CohortResponse[]>;
-    /**
-     * Get cohort members.
-     */
-    getCohortMembers(cohortId: string, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<{
-        members: CohortMember[];
-        total: number;
-    }>;
     /**
      * Check if user belongs to cohort.
      */
     isUserInCohort(userId: string, cohortId: string): Promise<{
         isMember: boolean;
     }>;
-    /**
-     * Get user's cohorts.
-     */
-    getUserCohorts(userId: string): Promise<CohortAssignment[]>;
     /**
      * Create a segment.
      */
     createSegment(definition: SegmentDefinition): Promise<{
         segmentId: string;
     }>;
-    /**
-     * Get segment distribution.
-     */
-    getSegmentDistribution(segmentId: string, filter?: DateRangeFilter): Promise<Array<{
-        bucket: string;
-        count: number;
-        percentage: number;
-    }>>;
     /**
      * Compare two cohorts.
      */
     compareCohorts(config: CohortComparisonConfig): Promise<CohortComparison>;
-    /**
-     * Get cohort analytics.
-     */
-    getCohortAnalytics(cohortId: string, filter?: DateRangeFilter): Promise<CohortAnalytics>;
-    /**
-     * Get cohort growth trend.
-     */
-    getCohortGrowth(cohortId: string, filter?: DateRangeFilter, granularity?: TimeGranularity): Promise<TimeSeriesData>;
 }