@dallask/a11y-mcp-srv 1.0.0

package/dist/core/session-manager.js

@@ -0,0 +1,243 @@
+/**
+ * Session Manager - Handles authenticated session storage and management
+ * Manages session creation, validation, and cleanup for authenticated audits
+ */
+/**
+ * SessionManager class - Manages authenticated browser sessions
+ */
+export class SessionManager {
+    constructor() {
+        this.sessions = new Map();
+        this.contexts = new Map();
+        this.cleanupInterval = null;
+        this.defaultSessionDuration = 60 * 60 * 1000; // 1 hour in milliseconds
+        // Start cleanup interval to remove expired sessions
+        this.startCleanupInterval();
+    }
+    /**
+     * Start periodic cleanup of expired sessions
+     */
+    startCleanupInterval() {
+        // Run cleanup every 5 minutes
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupExpiredSessions();
+        }, 5 * 60 * 1000);
+    }
+    /**
+     * Stop cleanup interval (useful for testing or shutdown)
+     */
+    stopCleanupInterval() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+    /**
+     * Generate a unique session ID
+     */
+    generateSessionId(domain, customId) {
+        if (customId) {
+            return `${domain}::${customId}`;
+        }
+        return `${domain}::${Date.now()}::${Math.random().toString(36).substring(7)}`;
+    }
+    /**
+     * Get default login selectors
+     */
+    getDefaultLoginSelectors() {
+        return {
+            usernameSelector: 'input[type="email"], input[name="username"], input[name="email"], input[id*="username"], input[id*="email"]',
+            passwordSelector: 'input[type="password"]',
+            submitSelector: 'button[type="submit"], input[type="submit"], button:has-text("Log in"), button:has-text("Sign in"), button:has-text("Login")',
+            successIndicator: 'body' // Default: any page load after submit indicates success
+        };
+    }
+    /**
+     * Perform login on a page
+     */
+    async performLogin(page, username, password, loginSelectors) {
+        const selectors = { ...this.getDefaultLoginSelectors(), ...loginSelectors };
+        try {
+            // Wait for login form to be ready
+            await page.waitForSelector(selectors.usernameSelector, { timeout: 10000 });
+            await page.waitForSelector(selectors.passwordSelector, { timeout: 10000 });
+            // Fill in credentials
+            await page.fill(selectors.usernameSelector, username);
+            await page.fill(selectors.passwordSelector, password);
+            // Submit form
+            await page.click(selectors.submitSelector);
+            // Wait for login to complete (either navigation or success indicator)
+            if (selectors.successIndicator) {
+                try {
+                    await page.waitForSelector(selectors.successIndicator, { timeout: 10000 });
+                }
+                catch {
+                    // If success indicator not found, wait for navigation
+                    await page.waitForLoadState('networkidle', { timeout: 10000 });
+                }
+            }
+            else {
+                await page.waitForLoadState('networkidle', { timeout: 10000 });
+            }
+            console.log('Login successful');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Provide more helpful error messages
+            if (errorMessage.includes('timeout')) {
+                throw new Error(`Login failed: Timeout waiting for login form. Please check the login selectors or increase timeout.`);
+            }
+            else if (errorMessage.includes('not found') || errorMessage.includes('selector')) {
+                throw new Error(`Login failed: Could not find login form elements. Please verify the login selectors are correct.`);
+            }
+            throw new Error(`Login failed: ${errorMessage}`);
+        }
+    }
+    /**
+     * Create a new authenticated session
+     */
+    async createSession(context, config) {
+        const { domain, loginUrl, username, password, loginSelectors, sessionId: customSessionId } = config;
+        // Generate session ID
+        const sessionId = this.generateSessionId(domain, customSessionId);
+        // Check if session already exists
+        if (this.sessions.has(sessionId)) {
+            const existingSession = this.sessions.get(sessionId);
+            if (existingSession.isActive && new Date(existingSession.expiresAt) > new Date()) {
+                return {
+                    sessionId,
+                    expiresAt: existingSession.expiresAt,
+                    testUrl: existingSession.testUrl || domain,
+                };
+            }
+        }
+        try {
+            // Create a new page for login
+            const page = await context.newPage();
+            // Determine login URL
+            const loginPageUrl = loginUrl || `${domain}/login`;
+            // Navigate to login page
+            console.log(`Navigating to login page: ${loginPageUrl}`);
+            await page.goto(loginPageUrl, {
+                waitUntil: 'networkidle',
+                timeout: 30000,
+            });
+            // Perform login
+            await this.performLogin(page, username, password, loginSelectors);
+            // Get test URL (current page after login)
+            const testUrl = page.url();
+            // Store browser context (contains cookies/auth state)
+            this.contexts.set(sessionId, context);
+            // Create session record
+            const expiresAt = new Date(Date.now() + this.defaultSessionDuration).toISOString();
+            const session = {
+                sessionId,
+                domain,
+                createdAt: new Date().toISOString(),
+                expiresAt,
+                testUrl,
+                isActive: true,
+            };
+            this.sessions.set(sessionId, session);
+            console.log(`Session created: ${sessionId} (expires: ${expiresAt})`);
+            return {
+                sessionId,
+                expiresAt,
+                testUrl,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Provide more context for session creation failures
+            if (errorMessage.includes('Login failed')) {
+                throw error; // Re-throw login errors as-is (they already have context)
+            }
+            throw new Error(`Failed to create session: ${errorMessage}. Please check your credentials and login URL.`);
+        }
+    }
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return null;
+        }
+        // Check if session is expired
+        if (new Date(session.expiresAt) < new Date()) {
+            this.invalidateSession(sessionId);
+            return null;
+        }
+        return session;
+    }
+    /**
+     * Get browser context for a session
+     */
+    getContext(sessionId) {
+        const session = this.getSession(sessionId);
+        if (!session) {
+            return null;
+        }
+        return this.contexts.get(sessionId) || null;
+    }
+    /**
+     * Validate that a session is active and valid
+     */
+    validateSession(sessionId) {
+        const session = this.getSession(sessionId);
+        return session !== null && session.isActive;
+    }
+    /**
+     * Invalidate a session
+     */
+    invalidateSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.isActive = false;
+            this.sessions.delete(sessionId);
+        }
+        this.contexts.delete(sessionId);
+        console.log(`Session invalidated: ${sessionId}`);
+    }
+    /**
+     * Clean up expired sessions
+     */
+    cleanupExpiredSessions() {
+        const now = new Date();
+        const expiredSessions = [];
+        this.sessions.forEach((session, sessionId) => {
+            if (new Date(session.expiresAt) < now || !session.isActive) {
+                expiredSessions.push(sessionId);
+            }
+        });
+        expiredSessions.forEach((sessionId) => {
+            this.invalidateSession(sessionId);
+        });
+        if (expiredSessions.length > 0) {
+            console.log(`Cleaned up ${expiredSessions.length} expired session(s)`);
+        }
+    }
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions() {
+        this.cleanupExpiredSessions();
+        return Array.from(this.sessions.values()).filter((s) => s.isActive);
+    }
+    /**
+     * Get session count
+     */
+    getSessionCount() {
+        this.cleanupExpiredSessions();
+        return this.sessions.size;
+    }
+    /**
+     * Clear all sessions (useful for testing or shutdown)
+     */
+    clearAllSessions() {
+        this.sessions.clear();
+        this.contexts.clear();
+        console.log('All sessions cleared');
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/core/session-manager.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Main MCP server entry point
+ * Accessibility MCP Server
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): Promise<Server>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AA4ClE;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAkjDpD"}