@principal-ai/principal-view-core 0.5.6

package/dist/SessionManager.d.ts

@@ -0,0 +1,194 @@
+/**
+ * SessionManager - Manages event recording sessions
+ *
+ * Sessions group events by test case or recording context.
+ * Each session contains a sequence of GraphEvents that can be
+ * replayed through the EventControllerPanel.
+ */
+import type { GraphEvent } from './types';
+/**
+ * Session status
+ */
+export type SessionStatus = 'recording' | 'completed' | 'error';
+/**
+ * Session result when completed
+ */
+export type SessionResult = 'pass' | 'fail' | 'skip';
+/**
+ * Metadata associated with a session
+ */
+export interface SessionMetadata {
+    /** Test file path */
+    testFile?: string;
+    /** Test case name */
+    testName?: string;
+    /** Test suite name */
+    testSuite?: string;
+    /** Custom tags for filtering */
+    tags?: string[];
+    /** Test result (set when session completes) */
+    result?: SessionResult;
+    /** Error message if test failed */
+    error?: string;
+    /** Duration in milliseconds */
+    duration?: number;
+}
+/**
+ * An event recording session
+ */
+export interface EventSession {
+    /** Unique session identifier */
+    id: string;
+    /** Human-readable name (e.g., test name) */
+    name: string;
+    /** When recording started */
+    startedAt: number;
+    /** When recording ended (undefined if still recording) */
+    endedAt?: number;
+    /** Status of the session */
+    status: SessionStatus;
+    /** Recorded events */
+    events: GraphEvent[];
+    /** Session metadata */
+    metadata: SessionMetadata;
+}
+/**
+ * Options for creating a session
+ */
+export interface CreateSessionOptions {
+    /** Session name */
+    name: string;
+    /** Optional metadata */
+    metadata?: SessionMetadata;
+    /** Optional custom ID (auto-generated if not provided) */
+    id?: string;
+}
+/**
+ * Options for ending a session
+ */
+export interface EndSessionOptions {
+    /** Test result */
+    result?: SessionResult;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Session change callback
+ */
+export type SessionChangeCallback = (sessions: EventSession[]) => void;
+/**
+ * SessionManager configuration
+ */
+export interface SessionManagerConfig {
+    /** Maximum events per session (default: 10000) */
+    maxEventsPerSession?: number;
+    /** Maximum number of sessions to keep (default: 100) */
+    maxSessions?: number;
+    /** Auto-cleanup sessions older than this (ms, default: 3600000 = 1 hour) */
+    sessionRetention?: number;
+    /** Whether to auto-cleanup old sessions (default: true) */
+    autoCleanup?: boolean;
+}
+/**
+ * Manages event recording sessions
+ */
+export declare class SessionManager {
+    private sessions;
+    private activeSessionId;
+    private listeners;
+    private config;
+    private cleanupInterval;
+    constructor(config?: SessionManagerConfig);
+    /**
+     * Generate a unique session ID
+     */
+    private generateId;
+    /**
+     * Notify all listeners of session changes
+     */
+    private notifyListeners;
+    /**
+     * Start auto-cleanup interval
+     */
+    private startAutoCleanup;
+    /**
+     * Stop auto-cleanup interval
+     */
+    private stopAutoCleanup;
+    /**
+     * Clean up sessions older than retention period
+     */
+    private cleanupOldSessions;
+    /**
+     * Create a new session
+     */
+    createSession(options: CreateSessionOptions): EventSession;
+    /**
+     * Get session by ID
+     */
+    getSession(id: string): EventSession | undefined;
+    /**
+     * Get the currently active (recording) session
+     */
+    getActiveSession(): EventSession | undefined;
+    /**
+     * List all sessions, sorted by start time (newest first)
+     */
+    listSessions(): EventSession[];
+    /**
+     * Add an event to a session
+     */
+    addEvent(sessionId: string, event: GraphEvent): void;
+    /**
+     * Add an event to the active session (convenience method)
+     */
+    addEventToActive(event: GraphEvent): void;
+    /**
+     * End a session
+     */
+    endSession(sessionId: string, options?: EndSessionOptions): void;
+    /**
+     * End the active session (convenience method)
+     */
+    endActiveSession(options?: EndSessionOptions): void;
+    /**
+     * Mark a session as errored
+     */
+    errorSession(sessionId: string, error: string): void;
+    /**
+     * Delete a session
+     */
+    deleteSession(id: string): boolean;
+    /**
+     * Clear all sessions
+     */
+    clearSessions(): void;
+    /**
+     * Export a session to JSON string
+     */
+    exportSession(id: string): string;
+    /**
+     * Import a session from JSON string
+     */
+    importSession(json: string): EventSession;
+    /**
+     * Subscribe to session changes
+     * Returns unsubscribe function
+     */
+    onSessionChange(callback: SessionChangeCallback): () => void;
+    /**
+     * Get session statistics
+     */
+    getStats(): {
+        totalSessions: number;
+        activeSessions: number;
+        totalEvents: number;
+        oldestSession: number | null;
+        newestSession: number | null;
+    };
+    /**
+     * Dispose of the session manager
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/SessionManager.d.ts.map

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

package/dist/SessionManager.js

@@ -0,0 +1,299 @@
+/**
+ * SessionManager - Manages event recording sessions
+ *
+ * Sessions group events by test case or recording context.
+ * Each session contains a sequence of GraphEvents that can be
+ * replayed through the EventControllerPanel.
+ */
+/**
+ * Manages event recording sessions
+ */
+export class SessionManager {
+    constructor(config = {}) {
+        this.sessions = new Map();
+        this.activeSessionId = null;
+        this.listeners = new Set();
+        this.cleanupInterval = null;
+        this.config = {
+            maxEventsPerSession: config.maxEventsPerSession ?? 10000,
+            maxSessions: config.maxSessions ?? 100,
+            sessionRetention: config.sessionRetention ?? 3600000, // 1 hour
+            autoCleanup: config.autoCleanup ?? true,
+        };
+        // Start auto-cleanup if enabled
+        if (this.config.autoCleanup) {
+            this.startAutoCleanup();
+        }
+    }
+    /**
+     * Generate a unique session ID
+     */
+    generateId() {
+        return `session-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    }
+    /**
+     * Notify all listeners of session changes
+     */
+    notifyListeners() {
+        const sessions = this.listSessions();
+        for (const listener of this.listeners) {
+            try {
+                listener(sessions);
+            }
+            catch (error) {
+                console.error('Session listener error:', error);
+            }
+        }
+    }
+    /**
+     * Start auto-cleanup interval
+     */
+    startAutoCleanup() {
+        // Clean up every minute
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupOldSessions();
+        }, 60000);
+    }
+    /**
+     * Stop auto-cleanup interval
+     */
+    stopAutoCleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+    /**
+     * Clean up sessions older than retention period
+     */
+    cleanupOldSessions() {
+        const now = Date.now();
+        const cutoff = now - this.config.sessionRetention;
+        for (const [id, session] of this.sessions) {
+            // Don't cleanup active session
+            if (id === this.activeSessionId)
+                continue;
+            // Cleanup completed/error sessions past retention
+            if (session.status !== 'recording' && session.startedAt < cutoff) {
+                this.sessions.delete(id);
+            }
+        }
+        // Enforce max sessions limit
+        if (this.sessions.size > this.config.maxSessions) {
+            const sortedSessions = Array.from(this.sessions.entries())
+                .filter(([id]) => id !== this.activeSessionId)
+                .sort((a, b) => a[1].startedAt - b[1].startedAt);
+            const toDelete = sortedSessions.slice(0, this.sessions.size - this.config.maxSessions);
+            for (const [id] of toDelete) {
+                this.sessions.delete(id);
+            }
+        }
+        this.notifyListeners();
+    }
+    /**
+     * Create a new session
+     */
+    createSession(options) {
+        const id = options.id || this.generateId();
+        // Check if session already exists
+        if (this.sessions.has(id)) {
+            throw new Error(`Session with ID "${id}" already exists`);
+        }
+        const session = {
+            id,
+            name: options.name,
+            startedAt: Date.now(),
+            status: 'recording',
+            events: [],
+            metadata: options.metadata || {},
+        };
+        this.sessions.set(id, session);
+        this.activeSessionId = id;
+        this.notifyListeners();
+        return session;
+    }
+    /**
+     * Get session by ID
+     */
+    getSession(id) {
+        return this.sessions.get(id);
+    }
+    /**
+     * Get the currently active (recording) session
+     */
+    getActiveSession() {
+        if (!this.activeSessionId)
+            return undefined;
+        return this.sessions.get(this.activeSessionId);
+    }
+    /**
+     * List all sessions, sorted by start time (newest first)
+     */
+    listSessions() {
+        return Array.from(this.sessions.values())
+            .sort((a, b) => b.startedAt - a.startedAt);
+    }
+    /**
+     * Add an event to a session
+     */
+    addEvent(sessionId, event) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session "${sessionId}" not found`);
+        }
+        if (session.status !== 'recording') {
+            throw new Error(`Session "${sessionId}" is not recording (status: ${session.status})`);
+        }
+        // Check max events limit
+        if (session.events.length >= this.config.maxEventsPerSession) {
+            console.warn(`Session "${sessionId}" reached max events limit (${this.config.maxEventsPerSession})`);
+            return;
+        }
+        session.events.push(event);
+        this.notifyListeners();
+    }
+    /**
+     * Add an event to the active session (convenience method)
+     */
+    addEventToActive(event) {
+        if (!this.activeSessionId) {
+            throw new Error('No active session');
+        }
+        this.addEvent(this.activeSessionId, event);
+    }
+    /**
+     * End a session
+     */
+    endSession(sessionId, options = {}) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session "${sessionId}" not found`);
+        }
+        if (session.status !== 'recording') {
+            throw new Error(`Session "${sessionId}" is not recording (status: ${session.status})`);
+        }
+        session.endedAt = Date.now();
+        session.status = 'completed';
+        session.metadata.result = options.result;
+        session.metadata.error = options.error;
+        session.metadata.duration = session.endedAt - session.startedAt;
+        // Clear active session if this was it
+        if (this.activeSessionId === sessionId) {
+            this.activeSessionId = null;
+        }
+        this.notifyListeners();
+    }
+    /**
+     * End the active session (convenience method)
+     */
+    endActiveSession(options = {}) {
+        if (!this.activeSessionId) {
+            throw new Error('No active session');
+        }
+        this.endSession(this.activeSessionId, options);
+    }
+    /**
+     * Mark a session as errored
+     */
+    errorSession(sessionId, error) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session "${sessionId}" not found`);
+        }
+        session.endedAt = Date.now();
+        session.status = 'error';
+        session.metadata.error = error;
+        session.metadata.duration = session.endedAt - session.startedAt;
+        if (this.activeSessionId === sessionId) {
+            this.activeSessionId = null;
+        }
+        this.notifyListeners();
+    }
+    /**
+     * Delete a session
+     */
+    deleteSession(id) {
+        if (this.activeSessionId === id) {
+            this.activeSessionId = null;
+        }
+        const deleted = this.sessions.delete(id);
+        if (deleted) {
+            this.notifyListeners();
+        }
+        return deleted;
+    }
+    /**
+     * Clear all sessions
+     */
+    clearSessions() {
+        this.sessions.clear();
+        this.activeSessionId = null;
+        this.notifyListeners();
+    }
+    /**
+     * Export a session to JSON string
+     */
+    exportSession(id) {
+        const session = this.sessions.get(id);
+        if (!session) {
+            throw new Error(`Session "${id}" not found`);
+        }
+        return JSON.stringify(session, null, 2);
+    }
+    /**
+     * Import a session from JSON string
+     */
+    importSession(json) {
+        const session = JSON.parse(json);
+        // Validate required fields
+        if (!session.id || !session.name || !session.events) {
+            throw new Error('Invalid session format: missing required fields');
+        }
+        // Generate new ID if session with same ID exists
+        if (this.sessions.has(session.id)) {
+            session.id = this.generateId();
+        }
+        // Mark as completed (imported sessions can't be recorded to)
+        session.status = 'completed';
+        this.sessions.set(session.id, session);
+        this.notifyListeners();
+        return session;
+    }
+    /**
+     * Subscribe to session changes
+     * Returns unsubscribe function
+     */
+    onSessionChange(callback) {
+        this.listeners.add(callback);
+        // Immediately call with current sessions
+        callback(this.listSessions());
+        return () => {
+            this.listeners.delete(callback);
+        };
+    }
+    /**
+     * Get session statistics
+     */
+    getStats() {
+        const sessions = this.listSessions();
+        const activeSessions = sessions.filter(s => s.status === 'recording').length;
+        const totalEvents = sessions.reduce((sum, s) => sum + s.events.length, 0);
+        return {
+            totalSessions: sessions.length,
+            activeSessions,
+            totalEvents,
+            oldestSession: sessions.length > 0 ? sessions[sessions.length - 1].startedAt : null,
+            newestSession: sessions.length > 0 ? sessions[0].startedAt : null,
+        };
+    }
+    /**
+     * Dispose of the session manager
+     */
+    dispose() {
+        this.stopAutoCleanup();
+        this.listeners.clear();
+        this.sessions.clear();
+        this.activeSessionId = null;
+    }
+}
+//# sourceMappingURL=SessionManager.js.map

package/dist/SessionManager.js.map

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

package/dist/ValidationEngine.d.ts

@@ -0,0 +1,31 @@
+import type { GraphEvent, GraphState, ValidationResult, ValidationRules, Violation } from './types';
+/**
+ * ValidationEngine checks events against defined rules
+ */
+export declare class ValidationEngine {
+    private rules;
+    private violationCount;
+    private warningCount;
+    constructor(rules: ValidationRules);
+    /**
+     * Validate an event against all rules
+     */
+    validate(event: GraphEvent, state: GraphState): ValidationResult;
+    /**
+     * Check constraints across the entire graph state
+     */
+    checkConstraints(state: GraphState): Violation[];
+    /**
+     * Validate connection rules
+     */
+    private validateConnection;
+    /**
+     * Validate state transitions
+     */
+    private validateStateTransition;
+    /**
+     * Create violation for unexpected event
+     */
+    private createUnexpectedEventViolation;
+}
+//# sourceMappingURL=ValidationEngine.d.ts.map

package/dist/ValidationEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationEngine.d.ts","sourceRoot":"","sources":["../src/ValidationEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EAEV,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAK;gBAEb,KAAK,EAAE,eAAe;IAIlC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,gBAAgB;IAsChE;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE;IA+BhD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6C1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoC/B;;OAEG;IACH,OAAO,CAAC,8BAA8B;CASvC"}