flowgrid-sdk 1.2.0 → 1.3.0

package/dist/lib/features/enterprise/multi-path-funnels.js

@@ -0,0 +1,205 @@
+/**
+ * @fileoverview Enterprise - Multi-Path Funnels & Micro-Conversions
+ * @module features/enterprise/multi-path-funnels
+ *
+ * @description
+ * Track complex user journeys and micro-conversions with support
+ * for non-linear funnel analysis and segment-based drop-off.
+ *
+ * @useCases
+ * - Define multi-path funnels
+ * - Track micro-conversions
+ * - Analyze drop-off by segment
+ * - Non-linear journey tracking
+ * - Onboarding step analysis
+ *
+ * @metrics
+ * - Path completion rates
+ * - Micro-conversion rates
+ * - Drop-off by segment
+ * - Time between steps
+ * - Alternative path analysis
+ *
+ * @chartData
+ * - Sankey diagram: User flow paths
+ * - Funnel chart: Multi-path visualization
+ * - Heatmap: Drop-off by segment
+ * - Timeline: Step progression
+ *
+ * @example
+ * ```typescript
+ * const funnels = new MultiPathFunnels(webId, endpoint, apiKey);
+ *
+ * // Define a multi-path funnel
+ * await funnels.defineFunnel({
+ *   name: 'Onboarding',
+ *   paths: [
+ *     { steps: ['signup', 'profile', 'first_action'] },
+ *     { steps: ['signup', 'skip_profile', 'first_action'] }
+ *   ]
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Calculate funnel conversion rate.
+ */
+export function calculateConversionRate(entered, completed) {
+    if (entered === 0)
+        return 0;
+    return Math.round((completed / entered) * 10000) / 100;
+}
+/**
+ * Calculate drop-off rate between steps.
+ */
+export function calculateDropOffRate(previousStep, currentStep) {
+    if (previousStep === 0)
+        return 0;
+    return Math.round(((previousStep - currentStep) / previousStep) * 10000) / 100;
+}
+/**
+ * Find the best performing path.
+ */
+export function findBestPath(paths) {
+    if (paths.length === 0)
+        return null;
+    return paths.reduce((best, current) => current.completionRate > best.completionRate ? current : best);
+}
+/**
+ * Calculate weighted micro-conversion score.
+ */
+export function calculateMicroConversionScore(completedConversions, definitions) {
+    let totalWeight = 0;
+    let weightedScore = 0;
+    for (const def of definitions) {
+        const weight = def.weight ?? 1;
+        totalWeight += weight;
+        const completed = completedConversions.find(c => c.id === def.id);
+        if (completed) {
+            weightedScore += weight * completed.completionRate;
+        }
+    }
+    return totalWeight > 0 ? Math.round((weightedScore / totalWeight) * 100) / 100 : 0;
+}
+/**
+ * Generate path ID from steps.
+ */
+export function generatePathId(steps) {
+    return steps.join('_').toLowerCase().replace(/[^a-z0-9_]/g, '');
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * Multi-path funnels and micro-conversions class.
+ */
+export class MultiPathFunnels extends FlowGridTransport {
+    /**
+     * Define a multi-path funnel.
+     */
+    async defineFunnel(definition) {
+        const funnelId = definition.funnelId ??
+            definition.name.toLowerCase().replace(/[^a-z0-9]+/g, '_');
+        const pathsWithIds = definition.paths.map(path => ({
+            ...path,
+            pathId: path.pathId ?? generatePathId(path.steps)
+        }));
+        return await this.initFeature("multi_path_funnels.define", {
+            type: "multi_path_funnels",
+            funnelId,
+            name: definition.name,
+            description: definition.description,
+            paths: pathsWithIds,
+            microConversions: definition.microConversions,
+            goalEvent: definition.goalEvent,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Update funnel definition.
+     */
+    async updateFunnel(funnelId, updates) {
+        return await this.initFeature("multi_path_funnels.update", {
+            type: "multi_path_funnels",
+            funnelId,
+            ...updates,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Delete funnel.
+     */
+    async deleteFunnel(funnelId) {
+        return await this.initFeature("multi_path_funnels.delete", {
+            type: "multi_path_funnels",
+            funnelId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track funnel step.
+     */
+    async trackStep(config) {
+        return await this.initFeature("multi_path_funnels.track_step", {
+            type: "multi_path_funnels",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track micro-conversion.
+     */
+    async trackMicroConversion(config) {
+        return await this.initFeature("multi_path_funnels.track_micro_conversion", {
+            type: "multi_path_funnels",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track goal completion.
+     */
+    async trackGoal(funnelId, userId, properties) {
+        return await this.initFeature("multi_path_funnels.track_goal", {
+            type: "multi_path_funnels",
+            funnelId,
+            userId,
+            ...properties,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Get funnel analysis.
+     */
+    async analyzeFunnel(config) {
+        return await this.initFeature("multi_path_funnels.analyze", {
+            type: "multi_path_funnels",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Get path comparison.
+     */
+    async comparePaths(funnelId, filter) {
+        return await this.initFeature("multi_path_funnels.compare_paths", {
+            type: "multi_path_funnels",
+            funnelId,
+            filter,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * List all funnels.
+     */
+    async listFunnels() {
+        return await this.initFeature("multi_path_funnels.list", {
+            type: "multi_path_funnels",
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+//# sourceMappingURL=multi-path-funnels.js.map

package/dist/lib/features/enterprise/multi-path-funnels.js.map

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

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

@@ -39,7 +39,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
+import { DateRangeFilter } from "../../types";
 /**
  * Screen/page transition configuration.
  */
@@ -270,63 +270,8 @@ export declare class PathAnalytics extends FlowGridTransport {
     definePath(definition: PathDefinition): Promise<{
         pathId: string;
     }>;
-    /**
-     * Get top paths.
-     */
-    getTopPaths(config?: PathAnalysisConfig): Promise<PathResult[]>;
-    /**
-     * Get paths between screens.
-     */
-    getPathsBetween(startScreen: string, endScreen: string, filter?: DateRangeFilter, limit?: number): Promise<PathResult[]>;
-    /**
-     * Get dead-end screens.
-     */
-    getDeadEnds(filter?: DateRangeFilter, intendedEndPoints?: string[]): Promise<DeadEndScreen[]>;
-    /**
-     * Get transition matrix.
-     */
-    getTransitionMatrix(filter?: DateRangeFilter): Promise<TransitionMatrix>;
-    /**
-     * Get user journey.
-     */
-    getUserJourney(config: UserJourneyConfig): Promise<UserJourney>;
-    /**
-     * Get friction points.
-     */
-    getFrictionPoints(filter?: DateRangeFilter): Promise<FrictionPoint[]>;
     /**
      * Compare paths.
      */
     comparePaths(paths: string[][], filter?: DateRangeFilter): Promise<PathComparison>;
-    /**
-     * Get screen analytics.
-     */
-    getScreenAnalytics(screen: string, filter?: DateRangeFilter): Promise<{
-        screen: string;
-        visits: number;
-        uniqueUsers: number;
-        avgTimeSpentMs: number;
-        exitRate: number;
-        entryRate: number;
-        topNextScreens: Array<{
-            screen: string;
-            count: number;
-        }>;
-        topPreviousScreens: Array<{
-            screen: string;
-            count: number;
-        }>;
-    }>;
-    /**
-     * Get path trend.
-     */
-    getPathTrend(path: string[], filter?: DateRangeFilter, granularity?: TimeGranularity): Promise<TimeSeriesData>;
-    /**
-     * Get feature usage sequences.
-     */
-    getFeatureSequences(filter?: DateRangeFilter, limit?: number): Promise<Array<{
-        sequence: string[];
-        userCount: number;
-        avgTimeMs: number;
-    }>>;
 }

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

@@ -0,0 +1,149 @@
+/**
+ * @fileoverview Enterprise - Behavioral Analytics & Path Analysis
+ * @module features/enterprise/paths
+ *
+ * @description
+ * Track full user navigation and feature usage sequences.
+ * Identify common paths, dead-ends, and UX friction points.
+ *
+ * @useCases
+ * - Sequence analysis of feature usage
+ * - Dead-end screen detection
+ * - Most common path identification
+ * - User journey mapping
+ * - UX friction detection
+ *
+ * @metrics
+ * - Path frequency
+ * - Path completion rate
+ * - Dead-end rate
+ * - Average path length
+ * - Time per path
+ *
+ * @chartData
+ * - Sankey diagram: User flow
+ * - Tree map: Path distribution
+ * - Heatmap: Screen transitions
+ * - Timeline: User journeys
+ *
+ * @example
+ * ```typescript
+ * const paths = new PathAnalytics(webId, endpoint, apiKey);
+ *
+ * // Track screen/page transition
+ * await paths.trackTransition({
+ *   userId: 'user_123',
+ *   fromScreen: 'dashboard',
+ *   toScreen: 'settings'
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Convert path array to string identifier.
+ */
+export function pathToString(path) {
+    return path.join(' → ');
+}
+/**
+ * Convert string identifier to path array.
+ */
+export function stringToPath(pathString) {
+    return pathString.split(' → ').map(s => s.trim());
+}
+/**
+ * Calculate exit rate.
+ */
+export function calculateExitRate(exits, entries) {
+    if (entries === 0)
+        return 0;
+    return Math.round((exits / entries) * 10000) / 100;
+}
+/**
+ * Identify if a screen is a dead-end.
+ */
+export function isDeadEnd(exitRate, isIntendedEndPoint, threshold = 50) {
+    return exitRate > threshold && !isIntendedEndPoint;
+}
+/**
+ * Calculate path similarity (Jaccard index).
+ */
+export function calculatePathSimilarity(path1, path2) {
+    const set1 = new Set(path1);
+    const set2 = new Set(path2);
+    const intersection = new Set([...set1].filter(x => set2.has(x)));
+    const union = new Set([...set1, ...set2]);
+    return intersection.size / union.size;
+}
+/**
+ * Find common sub-paths.
+ */
+export function findCommonSubPaths(paths, minLength = 2) {
+    const subPathCounts = new Map();
+    for (const path of paths) {
+        for (let i = 0; i <= path.length - minLength; i++) {
+            for (let j = i + minLength; j <= path.length; j++) {
+                const subPath = path.slice(i, j);
+                const key = pathToString(subPath);
+                subPathCounts.set(key, (subPathCounts.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    return Array.from(subPathCounts.entries())
+        .filter(([, count]) => count > 1)
+        .map(([key, count]) => ({ subPath: stringToPath(key), count }))
+        .sort((a, b) => b.count - a.count);
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * Behavioral analytics and path analysis class.
+ */
+export class PathAnalytics extends FlowGridTransport {
+    /**
+     * Track screen/page transition.
+     */
+    async trackTransition(config) {
+        return await this.initFeature("paths.transition", {
+            type: "paths",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Track feature sequence.
+     */
+    async trackFeatureSequence(config) {
+        return await this.initFeature("paths.feature_sequence", {
+            type: "paths",
+            ...config,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Define a path for tracking.
+     */
+    async definePath(definition) {
+        return await this.initFeature("paths.define_path", {
+            type: "paths",
+            ...definition,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Compare paths.
+     */
+    async comparePaths(paths, filter) {
+        return await this.initFeature("paths.compare_paths", {
+            type: "paths",
+            paths,
+            filter,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+//# sourceMappingURL=paths.js.map

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

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

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

@@ -39,7 +39,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
+import { DateRangeFilter, TimeSeriesData } from "../../types";
 /**
  * Security event types.
  */
@@ -71,6 +71,8 @@ export interface LoginAttemptConfig {
     };
     /** MFA used */
     mfaUsed?: boolean;
+    /** Custom properties */
+    properties?: Record<string, unknown>;
 }
 /**
  * Role change configuration.
@@ -118,6 +120,8 @@ export interface DataAccessConfig {
     ipAddress?: string;
     /** Query/filter used */
     query?: Record<string, unknown>;
+    /** Custom properties */
+    properties?: Record<string, unknown>;
 }
 /**
  * Compliance event configuration.
@@ -135,6 +139,8 @@ export interface ComplianceEventConfig {
     consentScope?: string[];
     /** Request ID (for data requests) */
     requestId?: string;
+    /** Custom properties */
+    properties?: Record<string, unknown>;
 }
 /**
  * Audit log entry.
@@ -202,7 +208,7 @@ export interface SecurityRiskAssessment {
 /**
  * Security analytics result.
  */
-export interface SecurityAnalytics {
+export interface SecurityAnalyticsResult {
     /** Total security events */
     totalEvents: number;
     /** Failed login count */
@@ -329,59 +335,4 @@ export declare class SecurityAnalytics extends FlowGridTransport {
     trackComplianceEvent(config: ComplianceEventConfig): Promise<{
         tracked: boolean;
     }>;
-    /**
-     * Get audit log.
-     */
-    getAuditLog(filter?: SecurityAnalyticsFilter, limit?: number): Promise<{
-        entries: AuditLogEntry[];
-        total: number;
-    }>;
-    /**
-     * Get user risk assessment.
-     */
-    getUserRiskAssessment(userId: string): Promise<SecurityRiskAssessment>;
-    /**
-     * Get high risk users.
-     */
-    getHighRiskUsers(minScore?: number, limit?: number): Promise<SecurityRiskAssessment[]>;
-    /**
-     * Get security analytics.
-     */
-    getAnalytics(filter?: SecurityAnalyticsFilter): Promise<SecurityAnalytics>;
-    /**
-     * Get compliance report.
-     */
-    getComplianceReport(regulation: 'GDPR' | 'CCPA' | 'HIPAA' | 'SOC2', filter?: DateRangeFilter): Promise<ComplianceReport>;
-    /**
-     * Get login analytics.
-     */
-    getLoginAnalytics(filter?: DateRangeFilter): Promise<{
-        totalAttempts: number;
-        successful: number;
-        failed: number;
-        failedRate: number;
-        uniqueUsers: number;
-        byLocation: Array<{
-            location: string;
-            count: number;
-        }>;
-        byDevice: Array<{
-            device: string;
-            count: number;
-        }>;
-        trend: TimeSeriesData;
-    }>;
-    /**
-     * Get security trend.
-     */
-    getSecurityTrend(filter?: SecurityAnalyticsFilter, granularity?: TimeGranularity): Promise<TimeSeriesData>;
-    /**
-     * Get data access patterns.
-     */
-    getDataAccessPatterns(userId?: string, filter?: DateRangeFilter): Promise<Array<{
-        resourceType: string;
-        accessCount: number;
-        uniqueUsers: number;
-        lastAccess: string;
-    }>>;
 }