@intentsolutions/blueprint 2.6.0 → 2.8.0

package/dist/analytics/collector.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Analytics Collector
+ * Collects and stores usage metrics
+ */
+import type { AnalyticsEvent, EventType, AnalyticsConfig, SessionStats } from './types.js';
+/**
+ * Analytics Collector
+ */
+export declare class AnalyticsCollector {
+    private config;
+    private sessionId;
+    private sessionStart;
+    private events;
+    private metadata;
+    private userId?;
+    constructor(config?: Partial<AnalyticsConfig>);
+    /**
+     * Create event metadata
+     */
+    private createMetadata;
+    /**
+     * Set user ID for tracking
+     */
+    setUserId(userId: string): void;
+    /**
+     * Anonymize an ID
+     */
+    private anonymizeId;
+    /**
+     * Track an event
+     */
+    track(type: EventType, data?: Record<string, unknown>): void;
+    /**
+     * Sanitize data to remove sensitive information
+     */
+    private sanitizeData;
+    /**
+     * Convenience methods for common events
+     */
+    trackTemplateGenerated(templateId: string, variables: string[], format: string, duration: number): void;
+    trackPackInstalled(packId: string, version: string): void;
+    trackPackUninstalled(packId: string): void;
+    trackExportCompleted(destination: string, format: string, success: boolean): void;
+    trackValidationRun(validators: string[], errorsFound: number, warningsFound: number): void;
+    trackInterviewStarted(templateId: string): void;
+    trackInterviewCompleted(templateId: string, questionsAnswered: number, duration: number): void;
+    trackError(errorType: string, errorMessage: string, context?: Record<string, unknown>): void;
+    /**
+     * Flush events to storage
+     */
+    flush(): void;
+    /**
+     * End the session
+     */
+    endSession(): SessionStats;
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Load events from storage
+     */
+    loadEvents(days?: number): AnalyticsEvent[];
+    /**
+     * Clean up old events
+     */
+    cleanup(): number;
+}
+/**
+ * Create an analytics collector instance
+ */
+export declare function createAnalyticsCollector(config?: Partial<AnalyticsConfig>): AnalyticsCollector;
+//# sourceMappingURL=collector.d.ts.map

package/dist/analytics/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/analytics/collector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EAET,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAOjD;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAuBhE;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IASvG,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzD,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1C,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAIjF,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAI1F,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI/C,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9F,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ5F;;OAEG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,UAAU,IAAI,YAAY;IAkB1B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,UAAU,CAAC,IAAI,GAAE,MAAW,GAAG,cAAc,EAAE;IA+B/C;;OAEG;IACH,OAAO,IAAI,MAAM;CA4BlB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,kBAAkB,CAE9F"}

package/dist/analytics/collector.js

@@ -0,0 +1,239 @@
+/**
+ * Analytics Collector
+ * Collects and stores usage metrics
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+import { DEFAULT_ANALYTICS_CONFIG } from './types.js';
+/**
+ * Analytics Collector
+ */
+export class AnalyticsCollector {
+    config;
+    sessionId;
+    sessionStart;
+    events = [];
+    metadata;
+    userId;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_ANALYTICS_CONFIG, ...config };
+        this.sessionId = randomUUID();
+        this.sessionStart = new Date();
+        this.metadata = this.createMetadata();
+    }
+    /**
+     * Create event metadata
+     */
+    createMetadata() {
+        return {
+            version: '1.0.0',
+            platform: process.platform,
+            nodeVersion: process.version,
+            cliVersion: '2.8.0', // Should be read from package.json
+            environment: process.env.NODE_ENV,
+        };
+    }
+    /**
+     * Set user ID for tracking
+     */
+    setUserId(userId) {
+        this.userId = this.config.anonymize ? this.anonymizeId(userId) : userId;
+    }
+    /**
+     * Anonymize an ID
+     */
+    anonymizeId(id) {
+        // Simple hash for anonymization
+        let hash = 0;
+        for (let i = 0; i < id.length; i++) {
+            const char = id.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return `user_${Math.abs(hash).toString(16)}`;
+    }
+    /**
+     * Track an event
+     */
+    track(type, data = {}) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.trackUsage && !type.includes('error'))
+            return;
+        if (!this.config.trackErrors && type === 'error_occurred')
+            return;
+        const event = {
+            id: randomUUID(),
+            type,
+            timestamp: new Date().toISOString(),
+            sessionId: this.sessionId,
+            userId: this.userId,
+            data: this.sanitizeData(data),
+            metadata: this.metadata,
+        };
+        this.events.push(event);
+        // Auto-flush after a certain number of events
+        if (this.events.length >= 100) {
+            this.flush();
+        }
+    }
+    /**
+     * Sanitize data to remove sensitive information
+     */
+    sanitizeData(data) {
+        const sanitized = {};
+        const sensitiveKeys = ['password', 'token', 'key', 'secret', 'auth', 'credential'];
+        for (const [key, value] of Object.entries(data)) {
+            const lowerKey = key.toLowerCase();
+            if (sensitiveKeys.some(sk => lowerKey.includes(sk))) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (typeof value === 'object' && value !== null) {
+                sanitized[key] = this.sanitizeData(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Convenience methods for common events
+     */
+    trackTemplateGenerated(templateId, variables, format, duration) {
+        this.track('template_generated', {
+            templateId,
+            variableCount: variables.length,
+            format,
+            duration,
+        });
+    }
+    trackPackInstalled(packId, version) {
+        this.track('pack_installed', { packId, version });
+    }
+    trackPackUninstalled(packId) {
+        this.track('pack_uninstalled', { packId });
+    }
+    trackExportCompleted(destination, format, success) {
+        this.track('export_completed', { destination, format, success });
+    }
+    trackValidationRun(validators, errorsFound, warningsFound) {
+        this.track('validation_run', { validators, errorsFound, warningsFound });
+    }
+    trackInterviewStarted(templateId) {
+        this.track('interview_started', { templateId });
+    }
+    trackInterviewCompleted(templateId, questionsAnswered, duration) {
+        this.track('interview_completed', { templateId, questionsAnswered, duration });
+    }
+    trackError(errorType, errorMessage, context) {
+        this.track('error_occurred', {
+            errorType,
+            errorMessage: errorMessage.substring(0, 500), // Limit message length
+            context,
+        });
+    }
+    /**
+     * Flush events to storage
+     */
+    flush() {
+        if (this.events.length === 0)
+            return;
+        const storageDir = this.config.storageDir;
+        if (!existsSync(storageDir)) {
+            mkdirSync(storageDir, { recursive: true });
+        }
+        const filename = `events_${this.sessionId}_${Date.now()}.json`;
+        const filepath = join(storageDir, filename);
+        writeFileSync(filepath, JSON.stringify(this.events, null, 2));
+        this.events = [];
+    }
+    /**
+     * End the session
+     */
+    endSession() {
+        this.track('session_ended', {});
+        this.flush();
+        const endTime = new Date();
+        const duration = endTime.getTime() - this.sessionStart.getTime();
+        return {
+            sessionId: this.sessionId,
+            startTime: this.sessionStart.toISOString(),
+            endTime: endTime.toISOString(),
+            duration,
+            eventsCount: this.events.length,
+            templatesGenerated: 0, // Would be calculated from events
+            errors: 0, // Would be calculated from events
+        };
+    }
+    /**
+     * Get current session ID
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Load events from storage
+     */
+    loadEvents(days = 30) {
+        const storageDir = this.config.storageDir;
+        if (!existsSync(storageDir))
+            return [];
+        const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+        const allEvents = [];
+        const files = readdirSync(storageDir).filter(f => f.startsWith('events_') && f.endsWith('.json'));
+        for (const file of files) {
+            const filepath = join(storageDir, file);
+            try {
+                const content = readFileSync(filepath, 'utf-8');
+                const events = JSON.parse(content);
+                for (const event of events) {
+                    const eventTime = new Date(event.timestamp).getTime();
+                    if (eventTime >= cutoff) {
+                        allEvents.push(event);
+                    }
+                }
+            }
+            catch {
+                // Skip corrupted files
+            }
+        }
+        return allEvents.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    }
+    /**
+     * Clean up old events
+     */
+    cleanup() {
+        const storageDir = this.config.storageDir;
+        if (!existsSync(storageDir))
+            return 0;
+        const cutoff = Date.now() - this.config.retentionDays * 24 * 60 * 60 * 1000;
+        let removed = 0;
+        const files = readdirSync(storageDir).filter(f => f.startsWith('events_') && f.endsWith('.json'));
+        for (const file of files) {
+            const filepath = join(storageDir, file);
+            try {
+                const content = readFileSync(filepath, 'utf-8');
+                const events = JSON.parse(content);
+                // If all events are old, delete the file
+                const allOld = events.every(e => new Date(e.timestamp).getTime() < cutoff);
+                if (allOld) {
+                    unlinkSync(filepath);
+                    removed++;
+                }
+            }
+            catch {
+                // Skip corrupted files
+            }
+        }
+        return removed;
+    }
+}
+/**
+ * Create an analytics collector instance
+ */
+export function createAnalyticsCollector(config) {
+    return new AnalyticsCollector(config);
+}
+//# sourceMappingURL=collector.js.map

package/dist/analytics/collector.js.map

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

package/dist/analytics/dashboard.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Analytics Dashboard
+ * Generates usage reports and visualizations
+ */
+import type { DashboardOptions, DashboardData } from './types.js';
+import { AnalyticsCollector } from './collector.js';
+/**
+ * Analytics Dashboard
+ */
+export declare class AnalyticsDashboard {
+    private collector;
+    constructor(collector: AnalyticsCollector);
+    /**
+     * Get dashboard data
+     */
+    getData(options?: DashboardOptions): Promise<DashboardData>;
+    /**
+     * Convert period to days
+     */
+    private periodToDays;
+    /**
+     * Calculate usage summary
+     */
+    private calculateSummary;
+    /**
+     * Calculate template statistics
+     */
+    private calculateTemplateStats;
+    /**
+     * Calculate pack statistics
+     */
+    private calculatePackStats;
+    /**
+     * Calculate session statistics
+     */
+    private calculateSessionStats;
+    /**
+     * Calculate error statistics
+     */
+    private calculateErrorStats;
+    /**
+     * Format dashboard data as table
+     */
+    formatAsTable(data: DashboardData): string;
+    /**
+     * Format dashboard data as JSON
+     */
+    formatAsJson(data: DashboardData): string;
+    /**
+     * Format dashboard data as CSV
+     */
+    formatAsCsv(data: DashboardData): string;
+    /**
+     * Render dashboard
+     */
+    render(options?: DashboardOptions): Promise<string>;
+}
+/**
+ * Create an analytics dashboard instance
+ */
+export declare function createAnalyticsDashboard(collector: AnalyticsCollector): AnalyticsDashboard;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/analytics/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/analytics/dashboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAMV,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAqB;gBAE1B,SAAS,EAAE,kBAAkB;IAIzC;;OAEG;IACG,OAAO,CAAC,OAAO,GAAE,gBAAuD,GAAG,OAAO,CAAC,aAAa,CAAC;IAavG;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8DxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwD9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0C7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAkE1C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAIzC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IA2BxC;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,gBAAuD,GAAG,OAAO,CAAC,MAAM,CAAC;CAYhG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,kBAAkB,GAAG,kBAAkB,CAE1F"}