@varity-labs/sdk 2.0.0-alpha.1

package/dist/modules/analytics/AnalyticsModule.d.ts

@@ -0,0 +1,349 @@
+import type { VaritySDK } from '../../core/VaritySDK';
+/**
+ * Analytics Module
+ *
+ * Universal analytics, reporting, KPIs, and metrics across all templates.
+ * Works identically for ISO, Healthcare, Finance, Retail, etc.
+ * Template configuration determines data sources and entities.
+ */
+export interface KPIOptions {
+    period?: 'current_month' | 'current_quarter' | 'current_year' | 'custom';
+    startDate?: string;
+    endDate?: string;
+    granularity?: 'day' | 'week' | 'month' | 'quarter' | 'year';
+    entities?: string[];
+}
+export interface KPIResult {
+    name: string;
+    value: number;
+    change?: number;
+    changeDirection?: 'up' | 'down' | 'stable';
+    unit?: string;
+    metadata?: Record<string, any>;
+}
+export interface KPISummary {
+    period: {
+        start: string;
+        end: string;
+        type: string;
+    };
+    kpis: KPIResult[];
+    summary: {
+        totalEntities: number;
+        totalVolume: number;
+        totalRevenue?: number;
+        growthRate?: number;
+    };
+    timestamp: string;
+}
+export interface TrendOptions {
+    metric: string;
+    period: string;
+    granularity?: 'hour' | 'day' | 'week' | 'month';
+    comparison?: 'mom' | 'yoy' | 'qoq';
+    entity?: string;
+}
+export interface TrendDataPoint {
+    timestamp: string;
+    value: number;
+    label?: string;
+    metadata?: Record<string, any>;
+}
+export interface TrendResult {
+    metric: string;
+    period: string;
+    data: TrendDataPoint[];
+    statistics: {
+        min: number;
+        max: number;
+        avg: number;
+        median: number;
+        total: number;
+    };
+    trend: 'increasing' | 'decreasing' | 'stable';
+    growthRate?: number;
+    comparison?: {
+        current: number;
+        previous: number;
+        change: number;
+        changePercent: number;
+    };
+}
+export interface LeaderboardOptions {
+    metric: string;
+    limit?: number;
+    period?: string;
+    entity?: string;
+    startDate?: string;
+    endDate?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface LeaderboardEntry {
+    rank: number;
+    entityId: string;
+    entityName?: string;
+    value: number;
+    change?: number;
+    changePercent?: number;
+    metadata?: Record<string, any>;
+}
+export interface LeaderboardResult {
+    metric: string;
+    period: string;
+    entity: string;
+    entries: LeaderboardEntry[];
+    totalEntries: number;
+    timestamp: string;
+}
+export interface GrowthMetricsOptions {
+    metrics?: string[];
+    period?: string;
+    comparison?: 'mom' | 'yoy' | 'qoq' | 'wow';
+    entities?: string[];
+}
+export interface GrowthMetric {
+    metric: string;
+    current: number;
+    previous: number;
+    change: number;
+    changePercent: number;
+    trend: 'increasing' | 'decreasing' | 'stable';
+    cagr?: number;
+}
+export interface GrowthMetricsResult {
+    period: {
+        current: {
+            start: string;
+            end: string;
+        };
+        previous: {
+            start: string;
+            end: string;
+        };
+    };
+    metrics: GrowthMetric[];
+    overallGrowth: number;
+    timestamp: string;
+}
+export interface TimeSeriesOptions {
+    metric: string;
+    startDate: string;
+    endDate: string;
+    granularity: 'hour' | 'day' | 'week' | 'month';
+    aggregation?: 'sum' | 'avg' | 'count' | 'min' | 'max';
+    filters?: Record<string, any>;
+    entity?: string;
+}
+export interface TimeSeriesResult {
+    metric: string;
+    granularity: string;
+    aggregation: string;
+    data: TrendDataPoint[];
+    statistics: {
+        min: number;
+        max: number;
+        avg: number;
+        median: number;
+        total: number;
+        stdDev?: number;
+    };
+}
+export interface ComparativeAnalysisOptions {
+    metrics: string[];
+    periods: Array<{
+        start: string;
+        end: string;
+        label?: string;
+    }>;
+    entities?: string[];
+    breakdownBy?: string;
+}
+export interface ComparativeResult {
+    metric: string;
+    periods: Array<{
+        label: string;
+        value: number;
+        breakdown?: Record<string, number>;
+    }>;
+    comparison: {
+        maxPeriod: string;
+        minPeriod: string;
+        maxValue: number;
+        minValue: number;
+        variance: number;
+    };
+}
+/**
+ * AnalyticsModule - Universal analytics and reporting
+ *
+ * Provides KPIs, trends, leaderboards, growth metrics, and time-series analysis.
+ * Works across all templates (ISO, Healthcare, Finance, Retail, etc.)
+ * by reading template configuration to determine data sources.
+ */
+export declare class AnalyticsModule {
+    private sdk;
+    constructor(sdk: VaritySDK);
+    /**
+     * Get KPI summary for a given period
+     *
+     * Universal method - works for any template.
+     * Template configuration determines which KPIs to calculate.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const kpis = await sdk.analytics.getKPIs({ period: 'current_month' })
+     * // Returns: total_volume, active_merchants, gross_residuals, etc.
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const kpis = await sdk.analytics.getKPIs({ period: 'current_month' })
+     * // Returns: total_patients, active_appointments, provider_utilization, etc.
+     * ```
+     */
+    getKPIs(options?: KPIOptions): Promise<KPISummary>;
+    /**
+     * Get trend data for a specific metric
+     *
+     * Universal method - analyzes trends for any metric across any template.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const trends = await sdk.analytics.getTrends({
+     *   metric: 'residuals',
+     *   period: '30d',
+     *   comparison: 'mom'
+     * })
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const trends = await sdk.analytics.getTrends({
+     *   metric: 'appointments',
+     *   period: '90d',
+     *   granularity: 'week'
+     * })
+     * ```
+     */
+    getTrends(options: TrendOptions): Promise<TrendResult>;
+    /**
+     * Get leaderboard for a specific metric
+     *
+     * Universal method - ranks entities by any performance metric.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const leaderboard = await sdk.analytics.getLeaderboard({
+     *   metric: 'residuals',
+     *   entity: 'reps',
+     *   limit: 10,
+     *   period: 'month'
+     * })
+     * // Returns: top 10 reps by residuals
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const leaderboard = await sdk.analytics.getLeaderboard({
+     *   metric: 'patient_satisfaction',
+     *   entity: 'providers',
+     *   limit: 20
+     * })
+     * // Returns: top 20 providers by patient satisfaction
+     * ```
+     */
+    getLeaderboard(options: LeaderboardOptions): Promise<LeaderboardResult>;
+    /**
+     * Get growth metrics comparing current vs previous periods
+     *
+     * Universal method - calculates growth across any metrics and periods.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const growth = await sdk.analytics.getGrowthMetrics({
+     *   metrics: ['volume', 'residuals', 'active_merchants'],
+     *   comparison: 'mom'
+     * })
+     * ```
+     *
+     * @example Finance Dashboard
+     * ```typescript
+     * const growth = await sdk.analytics.getGrowthMetrics({
+     *   metrics: ['aum', 'trades', 'revenue'],
+     *   comparison: 'qoq',
+     *   period: 'quarter'
+     * })
+     * ```
+     */
+    getGrowthMetrics(options?: GrowthMetricsOptions): Promise<GrowthMetricsResult>;
+    /**
+     * Query time-series data for a metric
+     *
+     * Universal method - retrieves granular time-series data for any metric.
+     * Supports flexible aggregation and filtering.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const timeSeries = await sdk.analytics.queryTimeSeries({
+     *   metric: 'daily_volume',
+     *   startDate: '2025-01-01',
+     *   endDate: '2025-01-31',
+     *   granularity: 'day',
+     *   aggregation: 'sum'
+     * })
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const timeSeries = await sdk.analytics.queryTimeSeries({
+     *   metric: 'patient_visits',
+     *   startDate: '2025-01-01',
+     *   endDate: '2025-03-31',
+     *   granularity: 'week',
+     *   aggregation: 'count',
+     *   filters: { department: 'cardiology' }
+     * })
+     * ```
+     */
+    queryTimeSeries(options: TimeSeriesOptions): Promise<TimeSeriesResult>;
+    /**
+     * Perform comparative analysis across multiple metrics and periods
+     *
+     * Universal method - compares any metrics across any time periods.
+     * Useful for period-over-period analysis and identifying patterns.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const comparison = await sdk.analytics.compareMetrics({
+     *   metrics: ['volume', 'residuals'],
+     *   periods: [
+     *     { start: '2024-01-01', end: '2024-03-31', label: 'Q1 2024' },
+     *     { start: '2024-04-01', end: '2024-06-30', label: 'Q2 2024' },
+     *     { start: '2024-07-01', end: '2024-09-30', label: 'Q3 2024' }
+     *   ],
+     *   breakdownBy: 'merchant_status'
+     * })
+     * ```
+     */
+    compareMetrics(options: ComparativeAnalysisOptions): Promise<ComparativeResult[]>;
+    /**
+     * Get real-time analytics snapshot
+     *
+     * Universal method - provides current real-time metrics.
+     * Useful for live dashboards and monitoring.
+     *
+     * @example
+     * ```typescript
+     * const snapshot = await sdk.analytics.getRealTimeSnapshot({
+     *   metrics: ['active_users', 'pending_transactions', 'system_load']
+     * })
+     * ```
+     */
+    getRealTimeSnapshot(options?: {
+        metrics?: string[];
+    }): Promise<{
+        metrics: KPIResult[];
+        timestamp: string;
+    }>;
+}
+//# sourceMappingURL=AnalyticsModule.d.ts.map

package/dist/modules/analytics/AnalyticsModule.d.ts.map

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

package/dist/modules/analytics/AnalyticsModule.js

@@ -0,0 +1,274 @@
+/**
+ * AnalyticsModule - Universal analytics and reporting
+ *
+ * Provides KPIs, trends, leaderboards, growth metrics, and time-series analysis.
+ * Works across all templates (ISO, Healthcare, Finance, Retail, etc.)
+ * by reading template configuration to determine data sources.
+ */
+export class AnalyticsModule {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Get KPI summary for a given period
+     *
+     * Universal method - works for any template.
+     * Template configuration determines which KPIs to calculate.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const kpis = await sdk.analytics.getKPIs({ period: 'current_month' })
+     * // Returns: total_volume, active_merchants, gross_residuals, etc.
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const kpis = await sdk.analytics.getKPIs({ period: 'current_month' })
+     * // Returns: total_patients, active_appointments, provider_utilization, etc.
+     * ```
+     */
+    async getKPIs(options = {}) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/analytics/kpis`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch KPIs: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Get trend data for a specific metric
+     *
+     * Universal method - analyzes trends for any metric across any template.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const trends = await sdk.analytics.getTrends({
+     *   metric: 'residuals',
+     *   period: '30d',
+     *   comparison: 'mom'
+     * })
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const trends = await sdk.analytics.getTrends({
+     *   metric: 'appointments',
+     *   period: '90d',
+     *   granularity: 'week'
+     * })
+     * ```
+     */
+    async getTrends(options) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/analytics/trends`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch trends: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Get leaderboard for a specific metric
+     *
+     * Universal method - ranks entities by any performance metric.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const leaderboard = await sdk.analytics.getLeaderboard({
+     *   metric: 'residuals',
+     *   entity: 'reps',
+     *   limit: 10,
+     *   period: 'month'
+     * })
+     * // Returns: top 10 reps by residuals
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const leaderboard = await sdk.analytics.getLeaderboard({
+     *   metric: 'patient_satisfaction',
+     *   entity: 'providers',
+     *   limit: 20
+     * })
+     * // Returns: top 20 providers by patient satisfaction
+     * ```
+     */
+    async getLeaderboard(options) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/analytics/leaderboard`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch leaderboard: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Get growth metrics comparing current vs previous periods
+     *
+     * Universal method - calculates growth across any metrics and periods.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const growth = await sdk.analytics.getGrowthMetrics({
+     *   metrics: ['volume', 'residuals', 'active_merchants'],
+     *   comparison: 'mom'
+     * })
+     * ```
+     *
+     * @example Finance Dashboard
+     * ```typescript
+     * const growth = await sdk.analytics.getGrowthMetrics({
+     *   metrics: ['aum', 'trades', 'revenue'],
+     *   comparison: 'qoq',
+     *   period: 'quarter'
+     * })
+     * ```
+     */
+    async getGrowthMetrics(options = {}) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/analytics/growth-metrics`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch growth metrics: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Query time-series data for a metric
+     *
+     * Universal method - retrieves granular time-series data for any metric.
+     * Supports flexible aggregation and filtering.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const timeSeries = await sdk.analytics.queryTimeSeries({
+     *   metric: 'daily_volume',
+     *   startDate: '2025-01-01',
+     *   endDate: '2025-01-31',
+     *   granularity: 'day',
+     *   aggregation: 'sum'
+     * })
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * const timeSeries = await sdk.analytics.queryTimeSeries({
+     *   metric: 'patient_visits',
+     *   startDate: '2025-01-01',
+     *   endDate: '2025-03-31',
+     *   granularity: 'week',
+     *   aggregation: 'count',
+     *   filters: { department: 'cardiology' }
+     * })
+     * ```
+     */
+    async queryTimeSeries(options) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/analytics/time-series`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to query time-series: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Perform comparative analysis across multiple metrics and periods
+     *
+     * Universal method - compares any metrics across any time periods.
+     * Useful for period-over-period analysis and identifying patterns.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * const comparison = await sdk.analytics.compareMetrics({
+     *   metrics: ['volume', 'residuals'],
+     *   periods: [
+     *     { start: '2024-01-01', end: '2024-03-31', label: 'Q1 2024' },
+     *     { start: '2024-04-01', end: '2024-06-30', label: 'Q2 2024' },
+     *     { start: '2024-07-01', end: '2024-09-30', label: 'Q3 2024' }
+     *   ],
+     *   breakdownBy: 'merchant_status'
+     * })
+     * ```
+     */
+    async compareMetrics(options) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/analytics/comparative`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to perform comparative analysis: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Get real-time analytics snapshot
+     *
+     * Universal method - provides current real-time metrics.
+     * Useful for live dashboards and monitoring.
+     *
+     * @example
+     * ```typescript
+     * const snapshot = await sdk.analytics.getRealTimeSnapshot({
+     *   metrics: ['active_users', 'pending_transactions', 'system_load']
+     * })
+     * ```
+     */
+    async getRealTimeSnapshot(options = {}) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/analytics/realtime`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch real-time snapshot: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+}

package/dist/modules/analytics/index.d.ts

@@ -0,0 +1,3 @@
+export { AnalyticsModule } from './AnalyticsModule';
+export type { KPIOptions, KPIResult, KPISummary, TrendOptions, TrendDataPoint, TrendResult, LeaderboardOptions, LeaderboardEntry, LeaderboardResult, GrowthMetricsOptions, GrowthMetric, GrowthMetricsResult, TimeSeriesOptions, TimeSeriesResult, ComparativeAnalysisOptions, ComparativeResult } from './AnalyticsModule';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,mBAAmB,CAAA"}

package/dist/modules/analytics/index.js

@@ -0,0 +1 @@
+export { AnalyticsModule } from './AnalyticsModule';