slapify 0.0.0

package/dist/index.js

@@ -0,0 +1,260 @@
+// Main exports for programmatic usage
+export { loadConfig, loadCredentials, initConfig, getConfigDir, findSystemBrowsers, checkBrowserPath, } from "./config/loader.js";
+export { parseFlowFile, parseFlowContent, findFlowFiles, validateFlowFile, getFlowSummary, } from "./parser/flow.js";
+export { BrowserAgent } from "./browser/agent.js";
+export { AIInterpreter } from "./ai/interpreter.js";
+export { TestRunner } from "./runner/index.js";
+export { ReportGenerator } from "./report/generator.js";
+// Convenience class for programmatic usage
+import { loadConfig, loadCredentials } from "./config/loader.js";
+import { parseFlowFile, parseFlowContent, findFlowFiles, } from "./parser/flow.js";
+import { TestRunner } from "./runner/index.js";
+import { ReportGenerator } from "./report/generator.js";
+/**
+ * Main Slapify class for programmatic usage
+ *
+ * @example
+ * ```typescript
+ * import { Slapify } from 'testpilot';
+ *
+ * // Using config file
+ * const pilot = new Slapify({ configDir: '.testpilot' });
+ *
+ * // Or with inline config
+ * const pilot = new Slapify({
+ *   config: {
+ *     llm: { provider: 'anthropic', model: 'claude-sonnet-4-20250514', api_key: process.env.ANTHROPIC_API_KEY },
+ *     browser: { headless: true }
+ *   }
+ * });
+ *
+ * // Run inline steps
+ * const result = await pilot.run([
+ *   'Go to https://example.com',
+ *   'Click on "More information" link',
+ *   'Verify URL contains "iana.org"'
+ * ]);
+ *
+ * console.log(result.status); // 'passed' or 'failed'
+ * ```
+ */
+export class Slapify {
+    config;
+    credentials;
+    reporter;
+    constructor(options = {}) {
+        // Load config from directory or use provided
+        if (options.configDir) {
+            this.config = { ...loadConfig(options.configDir), ...options.config };
+            this.credentials =
+                options.credentials || loadCredentials(options.configDir);
+        }
+        else if (options.config?.llm) {
+            this.config = {
+                llm: options.config.llm,
+                browser: options.config.browser || { headless: true, timeout: 30000 },
+                report: options.config.report || {
+                    format: "html",
+                    screenshots: true,
+                },
+            };
+            this.credentials = options.credentials || { profiles: {} };
+        }
+        else {
+            // Try to load from cwd
+            this.config = loadConfig();
+            this.credentials = loadCredentials();
+        }
+        this.reporter = new ReportGenerator(this.config.report);
+    }
+    /**
+     * Create a new runner instance (each test needs its own runner for parallel execution)
+     */
+    createRunner() {
+        return new TestRunner(this.config, this.credentials);
+    }
+    /**
+     * Run a flow file
+     *
+     * @example
+     * ```typescript
+     * const result = await pilot.runFile('tests/login.flow');
+     * ```
+     */
+    async runFile(filePath, options = {}) {
+        const flow = parseFlowFile(filePath);
+        return this.runFlow(flow, options);
+    }
+    /**
+     * Run steps from an array of strings
+     *
+     * @example
+     * ```typescript
+     * const result = await pilot.run([
+     *   'Go to https://google.com',
+     *   'Fill search box with "testpilot"',
+     *   'Press Enter',
+     *   'Verify results contain "testpilot"'
+     * ], 'google-search');
+     * ```
+     */
+    async run(steps, name = "inline", options = {}) {
+        const content = steps.join("\n");
+        const flow = parseFlowContent(content, name);
+        return this.runFlow(flow, options);
+    }
+    /**
+     * Run a flow from string content
+     *
+     * @example
+     * ```typescript
+     * const flowContent = `
+     *   Go to https://example.com
+     *   Click on "More information"
+     *   Verify page loads
+     * `;
+     * const result = await pilot.runContent(flowContent, 'example-test');
+     * ```
+     */
+    async runContent(content, name = "inline", options = {}) {
+        const flow = parseFlowContent(content, name);
+        return this.runFlow(flow, options);
+    }
+    /**
+     * Run a parsed flow
+     */
+    async runFlow(flow, options = {}) {
+        const runner = this.createRunner();
+        if (options.onTestStart) {
+            options.onTestStart(flow.name, flow.steps.length);
+        }
+        const result = await runner.runFlow(flow, (stepResult) => {
+            if (options.onStep) {
+                options.onStep(stepResult, flow.name);
+            }
+        });
+        if (options.onTestComplete) {
+            options.onTestComplete(result);
+        }
+        return result;
+    }
+    /**
+     * Run multiple flow files
+     *
+     * @example
+     * ```typescript
+     * // Sequential
+     * const results = await pilot.runMultiple(['tests/login.flow', 'tests/checkout.flow']);
+     *
+     * // Parallel with 4 workers
+     * const results = await pilot.runMultiple(['tests/*.flow'], { parallel: true, workers: 4 });
+     * ```
+     */
+    async runMultiple(patterns, options = {}) {
+        // Expand patterns to file paths
+        const files = [];
+        for (const pattern of patterns) {
+            if (pattern.includes("*")) {
+                // It's a glob pattern - find matching files
+                const found = await findFlowFiles(pattern.replace(/\/\*.*$/, ""));
+                files.push(...found);
+            }
+            else {
+                const fs = await import("fs");
+                if (fs.statSync(pattern).isDirectory()) {
+                    const found = await findFlowFiles(pattern);
+                    files.push(...found);
+                }
+                else {
+                    files.push(pattern);
+                }
+            }
+        }
+        if (files.length === 0) {
+            return [];
+        }
+        const results = [];
+        if (options.parallel && files.length > 1) {
+            // Parallel execution
+            const workers = options.workers || 4;
+            const pending = [...files];
+            const running = new Map();
+            while (pending.length > 0 || running.size > 0) {
+                // Start new tasks up to worker limit
+                while (pending.length > 0 && running.size < workers) {
+                    const file = pending.shift();
+                    const promise = this.runFile(file, options)
+                        .then((result) => {
+                        results.push(result);
+                        running.delete(file);
+                    })
+                        .catch(() => {
+                        running.delete(file);
+                    });
+                    running.set(file, promise);
+                }
+                // Wait for at least one to complete
+                if (running.size > 0) {
+                    await Promise.race(running.values());
+                }
+            }
+        }
+        else {
+            // Sequential execution
+            for (const file of files) {
+                const result = await this.runFile(file, options);
+                results.push(result);
+            }
+        }
+        return results;
+    }
+    /**
+     * Run all flow files in a directory
+     *
+     * @example
+     * ```typescript
+     * const results = await pilot.runAll('tests/', { parallel: true });
+     * ```
+     */
+    async runAll(directory = "tests", options = {}) {
+        return this.runMultiple([directory], options);
+    }
+    /**
+     * Generate a report from results
+     */
+    generateReport(result) {
+        return this.reporter.generate(result);
+    }
+    /**
+     * Generate a suite report from multiple results
+     */
+    generateSuiteReport(results) {
+        return this.reporter.generateSuiteReport(results);
+    }
+    /**
+     * Save a report to file/folder
+     */
+    saveReport(result, filename) {
+        return this.reporter.saveAsFolder(result);
+    }
+    /**
+     * Save a suite report to folder
+     */
+    saveSuiteReport(results) {
+        return this.reporter.saveSuiteAsFolder(results);
+    }
+    /**
+     * Print summary to console
+     */
+    printSummary(result) {
+        this.reporter.printSummary(result);
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+}
+export default Slapify;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parser/flow.d.ts

@@ -0,0 +1,27 @@
+import { FlowFile } from "../types.js";
+/**
+ * Parse a .flow file into a FlowFile object
+ */
+export declare function parseFlowFile(filePath: string): FlowFile;
+/**
+ * Parse flow content from a string (for inline tests)
+ */
+export declare function parseFlowContent(content: string, name?: string): FlowFile;
+/**
+ * Find all .flow files in a directory
+ */
+export declare function findFlowFiles(dir: string): Promise<string[]>;
+/**
+ * Validate a flow file for common issues
+ */
+export declare function validateFlowFile(flow: FlowFile): string[];
+/**
+ * Get a summary of a flow file
+ */
+export declare function getFlowSummary(flow: FlowFile): {
+    totalSteps: number;
+    requiredSteps: number;
+    optionalSteps: number;
+    conditionalSteps: number;
+};
+//# sourceMappingURL=flow.d.ts.map

package/dist/parser/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/parser/flow.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAY,MAAM,aAAa,CAAC;AA0CjD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAuBxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAiB,GACtB,QAAQ,CAiBV;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAmBzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAOA"}

package/dist/parser/flow.js

@@ -0,0 +1,117 @@
+import fs from "fs";
+import path from "path";
+import { glob } from "glob";
+/**
+ * Parse a single line into a FlowStep
+ */
+function parseLine(line, lineNumber) {
+    const trimmed = line.trim();
+    // Skip empty lines and comments
+    if (!trimmed || trimmed.startsWith("#")) {
+        return null;
+    }
+    // Check for [Optional] prefix
+    const optionalMatch = trimmed.match(/^\[Optional\]\s*(.+)$/i);
+    const isOptional = !!optionalMatch;
+    const stepText = optionalMatch ? optionalMatch[1] : trimmed;
+    // Check for conditional (If ... appears, ...)
+    const conditionalMatch = stepText.match(/^If\s+(.+?)\s*,\s*(.+)$/i);
+    const isConditional = !!conditionalMatch;
+    return {
+        line: lineNumber,
+        text: stepText,
+        optional: isOptional,
+        conditional: isConditional,
+        condition: conditionalMatch ? conditionalMatch[1] : undefined,
+        action: conditionalMatch ? conditionalMatch[2] : undefined,
+    };
+}
+/**
+ * Extract comments from a flow file
+ */
+function extractComments(content) {
+    return content
+        .split("\n")
+        .filter((line) => line.trim().startsWith("#"))
+        .map((line) => line.trim().substring(1).trim());
+}
+/**
+ * Parse a .flow file into a FlowFile object
+ */
+export function parseFlowFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Flow file not found: ${filePath}`);
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const steps = [];
+    for (let i = 0; i < lines.length; i++) {
+        const step = parseLine(lines[i], i + 1);
+        if (step) {
+            steps.push(step);
+        }
+    }
+    return {
+        path: filePath,
+        name: path.basename(filePath, ".flow"),
+        steps,
+        comments: extractComments(content),
+    };
+}
+/**
+ * Parse flow content from a string (for inline tests)
+ */
+export function parseFlowContent(content, name = "inline") {
+    const lines = content.split("\n");
+    const steps = [];
+    for (let i = 0; i < lines.length; i++) {
+        const step = parseLine(lines[i], i + 1);
+        if (step) {
+            steps.push(step);
+        }
+    }
+    return {
+        path: "",
+        name,
+        steps,
+        comments: extractComments(content),
+    };
+}
+/**
+ * Find all .flow files in a directory
+ */
+export async function findFlowFiles(dir) {
+    const pattern = path.join(dir, "**/*.flow");
+    return glob(pattern, { nodir: true });
+}
+/**
+ * Validate a flow file for common issues
+ */
+export function validateFlowFile(flow) {
+    const warnings = [];
+    if (flow.steps.length === 0) {
+        warnings.push("Flow file has no steps");
+    }
+    // Check for steps that might be incomplete
+    for (const step of flow.steps) {
+        if (step.text.length < 3) {
+            warnings.push(`Line ${step.line}: Step seems too short: "${step.text}"`);
+        }
+        if (step.conditional && !step.action) {
+            warnings.push(`Line ${step.line}: Conditional step missing action`);
+        }
+    }
+    return warnings;
+}
+/**
+ * Get a summary of a flow file
+ */
+export function getFlowSummary(flow) {
+    return {
+        totalSteps: flow.steps.length,
+        requiredSteps: flow.steps.filter((s) => !s.optional).length,
+        optionalSteps: flow.steps.filter((s) => s.optional).length,
+        conditionalSteps: flow.steps.filter((s) => s.conditional).length,
+    };
+}
+//# sourceMappingURL=flow.js.map

package/dist/parser/flow.js.map

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

package/dist/report/generator.d.ts

@@ -0,0 +1,61 @@
+import { TestResult, ReportConfig } from "../types.js";
+/**
+ * Generate test reports in various formats
+ */
+export declare class ReportGenerator {
+    private config;
+    constructor(config?: ReportConfig);
+    /**
+     * Generate a report from test results
+     */
+    generate(result: TestResult): string;
+    /**
+     * Generate a suite report from multiple test results
+     */
+    generateSuiteReport(results: TestResult[]): string;
+    /**
+     * Save report to file
+     */
+    save(result: TestResult, filename?: string): string;
+    /**
+     * Save report as a folder with embedded images
+     */
+    saveAsFolder(result: TestResult): string;
+    /**
+     * Save suite report as a folder
+     */
+    saveSuiteAsFolder(results: TestResult[]): string;
+    /**
+     * Generate Markdown report
+     */
+    private generateMarkdown;
+    /**
+     * Generate HTML report with Tailwind CSS
+     */
+    private generateHTML;
+    /**
+     * Format a single step for HTML with Tailwind
+     */
+    private formatStepHTML;
+    /**
+     * Generate suite report HTML with Tailwind
+     */
+    private generateSuiteHTML;
+    /**
+     * Format a test item for suite report with Tailwind
+     */
+    private formatTestItemHTML;
+    /**
+     * Format duration in human-readable form
+     */
+    private formatDuration;
+    /**
+     * Get icon for action type
+     */
+    private getActionIcon;
+    /**
+     * Print summary to console
+     */
+    printSummary(result: TestResult): void;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/report/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/report/generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAc,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,YAAiB;IASrC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAapC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IAIlD;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IA0BnD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAgDxC;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IA6ChD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmExB;;OAEG;IACH,OAAO,CAAC,YAAY;IAyHpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiGtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsFzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkE1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;CAgBvC"}