qa360 2.0.11 → 2.0.13

package/dist/core/crawler/journey-generator.js

@@ -0,0 +1,412 @@
+/**
+ * QA360 Journey Generator
+ *
+ * Automatically generates user journeys from crawled pages
+ */
+/**
+ * Journey Generator class
+ */
+export class JourneyGenerator {
+    siteMap;
+    constructor(siteMap) {
+        this.siteMap = siteMap;
+    }
+    /**
+     * Generate all user journeys from the site map
+     */
+    generateJourneys() {
+        const journeys = [];
+        // Generate authentication journeys
+        journeys.push(...this.generateAuthJourneys());
+        // Generate navigation journeys
+        journeys.push(...this.generateNavigationJourneys());
+        // Generate form submission journeys
+        journeys.push(...this.generateFormJourneys());
+        // Generate search journeys
+        journeys.push(...this.generateSearchJourneys());
+        // Generate transaction journeys (checkout, etc.)
+        journeys.push(...this.generateTransactionJourneys());
+        return journeys.filter(j => j.steps.length > 1);
+    }
+    /**
+     * Generate authentication journeys (login, signup)
+     */
+    generateAuthJourneys() {
+        const journeys = [];
+        // Find login page
+        const loginPage = this.siteMap.pages.find(p => p.pageType === 'login');
+        if (loginPage) {
+            const loginForm = loginPage.elements.forms.find(f => f.purpose === 'login');
+            if (loginForm) {
+                journeys.push({
+                    name: 'User Login',
+                    description: 'Standard user login flow with email and password',
+                    type: 'authentication',
+                    entryPoint: loginPage.url,
+                    finalUrl: this.siteMap.pages.find(p => p.pageType === 'dashboard')?.url,
+                    estimatedDuration: 5,
+                    steps: this.generateLoginSteps(loginPage, loginForm),
+                });
+            }
+        }
+        // Find signup page
+        const signupPage = this.siteMap.pages.find(p => p.pageType === 'signup');
+        if (signupPage) {
+            const signupForm = signupPage.elements.forms.find(f => f.purpose === 'signup');
+            if (signupForm) {
+                journeys.push({
+                    name: 'User Registration',
+                    description: 'New user registration flow',
+                    type: 'authentication',
+                    entryPoint: signupPage.url,
+                    estimatedDuration: 8,
+                    steps: this.generateSignupSteps(signupPage, signupForm),
+                });
+            }
+        }
+        return journeys;
+    }
+    /**
+     * Generate login flow steps
+     */
+    generateLoginSteps(page, form) {
+        const steps = [];
+        // Navigate to login page
+        steps.push({
+            order: steps.length + 1,
+            description: 'Navigate to login page',
+            action: 'navigate',
+            value: page.url,
+            expected: { url: page.url },
+        });
+        // Fill email field
+        const emailField = form.fields.find(f => f.inputType === 'email' || f.name?.includes('email') || f.name?.includes('username'));
+        if (emailField) {
+            steps.push({
+                order: steps.length + 1,
+                description: 'Enter email/username',
+                action: 'fill',
+                selector: emailField.selector,
+                value: '${TEST_USER_EMAIL}',
+            });
+        }
+        // Fill password field
+        const passwordField = form.fields.find(f => f.inputType === 'password');
+        if (passwordField) {
+            steps.push({
+                order: steps.length + 1,
+                description: 'Enter password',
+                action: 'fill',
+                selector: passwordField.selector,
+                value: '${TEST_USER_PASSWORD}',
+            });
+        }
+        // Click submit
+        if (form.submitButton) {
+            steps.push({
+                order: steps.length + 1,
+                description: 'Click login button',
+                action: 'click',
+                selector: form.submitButton.selector,
+                expected: { visible: '.user-menu, .dashboard, .welcome' },
+            });
+        }
+        return steps;
+    }
+    /**
+     * Generate signup flow steps
+     */
+    generateSignupSteps(page, form) {
+        const steps = [];
+        // Navigate to signup page
+        steps.push({
+            order: steps.length + 1,
+            description: 'Navigate to registration page',
+            action: 'navigate',
+            value: page.url,
+            expected: { url: page.url },
+        });
+        // Fill all required fields
+        for (const field of form.fields) {
+            if (!field.required)
+                continue;
+            const step = {
+                order: steps.length + 1,
+                description: `Enter ${field.name || field.inputType}`,
+                action: field.inputType === 'select-one' ? 'select' : 'fill',
+                selector: field.selector,
+            };
+            // Set test value based on field type
+            if (field.inputType === 'email') {
+                step.value = '${TEST_USER_EMAIL}';
+            }
+            else if (field.inputType === 'password') {
+                step.value = '${TEST_USER_PASSWORD}';
+            }
+            else if (field.inputType === 'select-one' && field.options && field.options.length > 0) {
+                step.value = field.options[0];
+            }
+            else {
+                step.value = 'test-value';
+            }
+            steps.push(step);
+        }
+        // Click submit
+        if (form.submitButton) {
+            steps.push({
+                order: steps.length + 1,
+                description: 'Submit registration form',
+                action: 'click',
+                selector: form.submitButton.selector,
+            });
+        }
+        return steps;
+    }
+    /**
+     * Generate navigation journeys
+     */
+    generateNavigationJourneys() {
+        const journeys = [];
+        // Homepage navigation journey
+        const homepage = this.siteMap.pages.find(p => p.pageType === 'homepage');
+        if (homepage) {
+            const steps = [];
+            // Start at homepage
+            steps.push({
+                order: steps.length + 1,
+                description: 'Navigate to homepage',
+                action: 'navigate',
+                value: homepage.url,
+                expected: { url: homepage.url },
+            });
+            // Add navigation menu clicks
+            if (homepage.navigation.main) {
+                for (const link of homepage.navigation.main.items.slice(0, 5)) {
+                    steps.push({
+                        order: steps.length + 1,
+                        description: `Navigate to "${link.text || link.selector}"`,
+                        action: 'click',
+                        selector: link.selector,
+                        expected: { url: link.url },
+                    });
+                    steps.push({
+                        order: steps.length + 1,
+                        description: 'Wait for page load',
+                        action: 'waitForNavigation',
+                    });
+                }
+            }
+            journeys.push({
+                name: 'Main Navigation Flow',
+                description: 'Navigate through main menu items',
+                type: 'navigation',
+                entryPoint: homepage.url,
+                estimatedDuration: steps.length * 3,
+                steps,
+            });
+        }
+        return journeys;
+    }
+    /**
+     * Generate form submission journeys
+     */
+    generateFormJourneys() {
+        const journeys = [];
+        for (const page of this.siteMap.pages) {
+            for (const form of page.elements.forms) {
+                if (form.purpose === 'login' || form.purpose === 'signup')
+                    continue;
+                const steps = [];
+                // Navigate to page
+                steps.push({
+                    order: steps.length + 1,
+                    description: `Navigate to ${form.purpose} form`,
+                    action: 'navigate',
+                    value: page.url,
+                });
+                // Fill form fields
+                for (const field of form.fields) {
+                    if (!field.required && Math.random() > 0.5)
+                        continue;
+                    const step = {
+                        order: steps.length + 1,
+                        description: `Fill ${field.name || field.inputType} field`,
+                        action: field.inputType === 'select-one' ? 'select' : 'fill',
+                        selector: field.selector,
+                    };
+                    // Set appropriate test value
+                    if (field.inputType === 'email') {
+                        step.value = 'test@example.com';
+                    }
+                    else if (field.inputType === 'tel') {
+                        step.value = '+1234567890';
+                    }
+                    else if (field.inputType === 'number') {
+                        const min = field.validation?.min;
+                        const max = field.validation?.max;
+                        const num = typeof min === 'number' ? min + 1 : 1;
+                        step.value = String(typeof max === 'number' ? Math.min(num, max - 1) : num);
+                    }
+                    else if (field.inputType === 'select-one' && field.options && field.options.length > 0) {
+                        step.value = field.options[0];
+                    }
+                    else if (field.inputType === 'checkbox') {
+                        step.action = 'check';
+                    }
+                    else {
+                        step.value = 'Test value';
+                    }
+                    steps.push(step);
+                }
+                // Submit form
+                if (form.submitButton) {
+                    steps.push({
+                        order: steps.length + 1,
+                        description: `Submit ${form.purpose} form`,
+                        action: 'click',
+                        selector: form.submitButton.selector,
+                    });
+                }
+                journeys.push({
+                    name: `${form.purpose.charAt(0).toUpperCase() + form.purpose.slice(1)} Form Submission`,
+                    description: `Fill and submit the ${form.purpose} form`,
+                    type: 'form-submission',
+                    entryPoint: page.url,
+                    estimatedDuration: steps.length * 2,
+                    steps,
+                });
+            }
+        }
+        return journeys;
+    }
+    /**
+     * Generate search journeys
+     */
+    generateSearchJourneys() {
+        const journeys = [];
+        for (const page of this.siteMap.pages) {
+            const searchForm = page.elements.forms.find(f => f.purpose === 'search');
+            if (!searchForm)
+                continue;
+            const steps = [];
+            // Navigate to page
+            steps.push({
+                order: steps.length + 1,
+                description: 'Navigate to search page',
+                action: 'navigate',
+                value: page.url,
+            });
+            // Fill search field
+            const searchField = searchForm.fields.find(f => f.name?.includes('q') || f.name?.includes('search'));
+            if (searchField) {
+                steps.push({
+                    order: steps.length + 1,
+                    description: 'Enter search query',
+                    action: 'fill',
+                    selector: searchField.selector,
+                    value: '${SEARCH_QUERY}',
+                });
+            }
+            // Submit search
+            if (searchForm.submitButton) {
+                steps.push({
+                    order: steps.length + 1,
+                    description: 'Click search button',
+                    action: 'click',
+                    selector: searchForm.submitButton.selector,
+                    expected: { visible: '.search-results, .results, [role="main"]' },
+                });
+            }
+            else {
+                // Press Enter
+                steps.push({
+                    order: steps.length + 1,
+                    description: 'Submit search (Enter)',
+                    action: 'press',
+                    value: 'Enter',
+                });
+            }
+            journeys.push({
+                name: 'Search Query',
+                description: 'Perform a search query and verify results',
+                type: 'search',
+                entryPoint: page.url,
+                estimatedDuration: 3,
+                steps,
+            });
+        }
+        return journeys;
+    }
+    /**
+     * Generate transaction journeys (checkout, booking, etc.)
+     */
+    generateTransactionJourneys() {
+        const journeys = [];
+        // Find checkout flow
+        const checkoutPage = this.siteMap.pages.find(p => p.elements.forms.some(f => f.purpose === 'checkout'));
+        if (checkoutPage) {
+            const checkoutForm = checkoutPage.elements.forms.find(f => f.purpose === 'checkout');
+            if (checkoutForm) {
+                const steps = [];
+                steps.push({
+                    order: steps.length + 1,
+                    description: 'Navigate to checkout',
+                    action: 'navigate',
+                    value: checkoutPage.url,
+                });
+                // Fill checkout fields
+                for (const field of checkoutForm.fields) {
+                    const step = {
+                        order: steps.length + 1,
+                        description: `Fill ${field.name || field.inputType}`,
+                        action: field.inputType === 'select-one' ? 'select' : 'fill',
+                        selector: field.selector,
+                    };
+                    // Set test payment data
+                    if (field.name?.includes('card')) {
+                        step.value = '4111111111111111'; // Test card number
+                    }
+                    else if (field.name?.includes('cvv') || field.name?.includes('cvc')) {
+                        step.value = '123';
+                    }
+                    else if (field.name?.includes('expiry') || field.name?.includes('exp')) {
+                        step.value = '12/25';
+                    }
+                    else if (field.inputType === 'select-one' && field.options && field.options.length > 0) {
+                        step.value = field.options[0];
+                    }
+                    else {
+                        step.value = 'Test value';
+                    }
+                    steps.push(step);
+                }
+                // Submit checkout
+                if (checkoutForm.submitButton) {
+                    steps.push({
+                        order: steps.length + 1,
+                        description: 'Complete purchase',
+                        action: 'click',
+                        selector: checkoutForm.submitButton.selector,
+                        expected: { visible: '.order-confirmation, .thank-you, [role="status"]' },
+                    });
+                }
+                journeys.push({
+                    name: 'Checkout Flow',
+                    description: 'Complete a purchase flow',
+                    type: 'transaction',
+                    entryPoint: checkoutPage.url,
+                    estimatedDuration: 10,
+                    steps,
+                });
+            }
+        }
+        return journeys;
+    }
+}
+/**
+ * Generate journeys from a site map
+ */
+export function generateJourneys(siteMap) {
+    const generator = new JourneyGenerator(siteMap);
+    return generator.generateJourneys();
+}

package/dist/core/crawler/page-analyzer.d.ts

@@ -0,0 +1,88 @@
+/**
+ * QA360 Page Analyzer
+ *
+ * Analyzes web pages to discover elements, forms, and patterns
+ */
+import type { CrawlOptions, PageDefinition } from './types.js';
+/**
+ * Page Analyzer class
+ */
+export declare class PageAnalyzer {
+    private browser?;
+    private context?;
+    private page?;
+    private options;
+    constructor(options: CrawlOptions);
+    /**
+     * Initialize browser
+     */
+    private initBrowser;
+    /**
+     * Perform authentication if configured
+     */
+    private performAuth;
+    /**
+     * Analyze a single page
+     */
+    analyze(url: string, depth: number): Promise<PageDefinition>;
+    /**
+     * Discover all interactive elements on the page
+     */
+    private discoverElements;
+    /**
+     * Discover buttons
+     */
+    private discoverButtons;
+    /**
+     * Discover links
+     */
+    private discoverLinks;
+    /**
+     * Discover forms
+     */
+    private discoverForms;
+    /**
+     * Discover fields within a form
+     */
+    private discoverFormFields;
+    /**
+     * Detect form purpose based on fields
+     */
+    private detectFormPurpose;
+    /**
+     * Calculate confidence for form purpose detection
+     */
+    private calculateFormPurposeConfidence;
+    /**
+     * Discover standalone input fields (not in forms)
+     */
+    private discoverInputs;
+    /**
+     * Discover select elements
+     */
+    private discoverSelects;
+    /**
+     * Discover checkboxes
+     */
+    private discoverCheckboxes;
+    /**
+     * Discover radio buttons
+     */
+    private discoverRadios;
+    /**
+     * Analyze page navigation structure
+     */
+    private analyzeNavigation;
+    /**
+     * Run accessibility scan using axe-core
+     */
+    private runAccessibilityScan;
+    /**
+     * Detect page type
+     */
+    private detectPageType;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+}