playwright-automation-core 1.0.0

package/dist/core/base.driver.js

@@ -0,0 +1,264 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseDriver = void 0;
+const utils_1 = require("../utils");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+/**
+ * Abstract base driver class that all platform drivers must extend.
+ * Provides common functionality and enforces consistent API across platforms.
+ */
+class BaseDriver {
+    /** Platform type */
+    platform;
+    /** Driver configuration */
+    config;
+    /** Logger instance */
+    logger;
+    /** Session ID */
+    sessionId;
+    /** Initialization state */
+    initialized = false;
+    /** Session start time */
+    startTime;
+    /** Implicit wait timeout */
+    implicitWaitTimeout = 0;
+    /**
+     * Create a new BaseDriver instance
+     * @param platform - The platform type (web, api, mobile)
+     * @param config - Driver configuration
+     * @param logger - Optional logger instance
+     */
+    constructor(platform, config, logger) {
+        this.platform = platform;
+        this.config = config;
+        this.logger = logger || utils_1.Logger.createLogger(platform);
+        // Set default timeout from config
+        if (config.timeout) {
+            this.implicitWaitTimeout = config.timeout;
+        }
+    }
+    /**
+     * Quit the driver and cleanup - can be overridden by subclasses
+     */
+    async quit() {
+        this.logger.info(`Quitting ${this.platform} driver`, {
+            sessionId: this.sessionId,
+        });
+        this.initialized = false;
+        this.sessionId = undefined;
+        this.startTime = undefined;
+    }
+    /**
+     * Check if driver is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get current platform
+     */
+    getPlatform() {
+        return this.platform;
+    }
+    /**
+     * Get session ID
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Get driver status
+     */
+    getStatus() {
+        return {
+            isInitialized: this.initialized,
+            sessionId: this.sessionId,
+            platform: this.platform,
+            startTime: this.startTime,
+            info: {
+                implicitWaitTimeout: this.implicitWaitTimeout,
+                config: this.getSafeConfig(),
+            },
+        };
+    }
+    /**
+     * Set implicit wait timeout
+     */
+    async setImplicitWait(timeout) {
+        this.implicitWaitTimeout = timeout;
+        this.logger.debug(`Set implicit wait to ${timeout}ms`);
+    }
+    /**
+     * Get implicit wait timeout
+     */
+    getImplicitWait() {
+        return this.implicitWaitTimeout;
+    }
+    /**
+     * Get the configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Get the logger instance
+     */
+    getLogger() {
+        return this.logger;
+    }
+    /**
+     * Ensure driver is initialized, throw error if not
+     */
+    ensureInitialized(operation) {
+        if (!this.initialized) {
+            throw new utils_1.DriverNotInitializedError(this.platform, operation);
+        }
+    }
+    /**
+     * Generate a new session ID
+     */
+    generateSessionId() {
+        this.sessionId = (0, utils_1.generateId)(`${this.platform}-session`);
+        return this.sessionId;
+    }
+    /**
+     * Mark driver as initialized
+     */
+    markInitialized() {
+        this.initialized = true;
+        this.startTime = new Date();
+        this.logger.info(`${this.platform} driver initialized`, {
+            sessionId: this.sessionId,
+            startTime: this.startTime.toISOString(),
+        });
+    }
+    /**
+     * Save screenshot to file
+     */
+    async saveScreenshot(buffer, options) {
+        const screenshotDir = this.config.screenshotDir || "./screenshots";
+        (0, utils_1.ensureDir)(screenshotDir);
+        const filename = options?.path || this.generateScreenshotFilename(options?.type || "png");
+        const fullPath = path.isAbsolute(filename)
+            ? filename
+            : path.join(screenshotDir, filename);
+        // Ensure directory exists for the full path
+        (0, utils_1.ensureDir)(path.dirname(fullPath));
+        fs.writeFileSync(fullPath, buffer);
+        this.logger.screenshot(fullPath);
+        return fullPath;
+    }
+    /**
+     * Generate a unique screenshot filename
+     */
+    generateScreenshotFilename(extension = "png") {
+        const timestamp = (0, utils_1.formatTimestamp)(new Date(), "YYYY-MM-DD_HH-mm-ss-SSS");
+        return `screenshot_${timestamp}_${(0, utils_1.generateId)()}.${extension}`;
+    }
+    /**
+     * Get safe config (without sensitive data) for logging
+     */
+    getSafeConfig() {
+        const safeConfig = { ...this.config };
+        // Remove sensitive fields
+        const sensitiveFields = [
+            "password",
+            "token",
+            "apiKey",
+            "secret",
+            "credentials",
+        ];
+        for (const field of sensitiveFields) {
+            if (field in safeConfig) {
+                safeConfig[field] = "***REDACTED***";
+            }
+        }
+        return safeConfig;
+    }
+    /**
+     * Log action start
+     */
+    logActionStart(action, details) {
+        this.logger.actionStart(action, details);
+        return Date.now();
+    }
+    /**
+     * Log action end
+     */
+    logActionEnd(action, startTime, details) {
+        const duration = Date.now() - startTime;
+        this.logger.actionEnd(action, duration, details);
+    }
+    /**
+     * Log action failure
+     */
+    logActionFailed(action, error, details) {
+        this.logger.actionFailed(action, error, details);
+    }
+    /**
+     * Execute an action with logging
+     */
+    async executeAction(actionName, action, details) {
+        const startTime = this.logActionStart(actionName, details);
+        try {
+            const result = await action();
+            this.logActionEnd(actionName, startTime, details);
+            return result;
+        }
+        catch (error) {
+            this.logActionFailed(actionName, error, details);
+            throw error;
+        }
+    }
+    /**
+     * Get session duration in milliseconds
+     */
+    getSessionDuration() {
+        if (!this.startTime) {
+            return undefined;
+        }
+        return Date.now() - this.startTime.getTime();
+    }
+    /**
+     * Get timeout value (config or default)
+     */
+    getTimeout(overrideTimeout) {
+        return overrideTimeout ?? this.config.timeout ?? 30000;
+    }
+}
+exports.BaseDriver = BaseDriver;
+//# sourceMappingURL=base.driver.js.map

package/dist/core/base.driver.js.map

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

package/dist/core/driver.factory.d.ts

@@ -0,0 +1,120 @@
+import { Platform, WebConfig, ApiConfig, MobileConfig, FrameworkConfig, IWebDriver, IApiDriver, IMobileDriver } from "../types";
+import { Logger } from "../utils";
+import { BaseDriver } from "./base.driver";
+/**
+ * Driver creation options
+ */
+export interface DriverOptions {
+    /** Override configuration */
+    config?: Partial<WebConfig | ApiConfig | MobileConfig>;
+    /** Custom logger */
+    logger?: Logger;
+    /** Auto-initialize driver */
+    autoInitialize?: boolean;
+}
+/**
+ * Registered driver class type
+ */
+export type DriverClass<T extends BaseDriver = BaseDriver> = new (config: WebConfig | ApiConfig | MobileConfig, logger?: Logger) => T;
+/**
+ * Factory class for creating platform-specific drivers.
+ * Supports registration of custom driver implementations.
+ */
+export declare class DriverFactory {
+    /** Singleton instance */
+    private static instance;
+    /** Driver registry */
+    private registry;
+    /** Active drivers */
+    private activeDrivers;
+    /** Logger */
+    private logger;
+    /** Config manager */
+    private configManager;
+    constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): DriverFactory;
+    /**
+     * Reset singleton instance (useful for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Register a driver class for a platform
+     */
+    register<T extends BaseDriver>(platform: Platform, driverClass: DriverClass<T>, defaultConfig: WebConfig | ApiConfig | MobileConfig): this;
+    /**
+     * Check if a driver is registered for a platform
+     */
+    isRegistered(platform: Platform): boolean;
+    /**
+     * Get registered platforms
+     */
+    getRegisteredPlatforms(): Platform[];
+    /**
+     * Create a driver for the specified platform
+     */
+    create<T extends BaseDriver>(platform: Platform, options?: DriverOptions): Promise<T>;
+    /**
+     * Create a web driver
+     */
+    createWebDriver(options?: DriverOptions): Promise<IWebDriver>;
+    /**
+     * Create an API driver
+     */
+    createApiDriver(options?: DriverOptions): Promise<IApiDriver>;
+    /**
+     * Create a mobile driver
+     */
+    createMobileDriver(options?: DriverOptions): Promise<IMobileDriver>;
+    /**
+     * Get configuration for a platform
+     */
+    private getConfigForPlatform;
+    /**
+     * Get an active driver by session ID
+     */
+    getDriver(sessionId: string): BaseDriver | undefined;
+    /**
+     * Get all active drivers
+     */
+    getActiveDrivers(): BaseDriver[];
+    /**
+     * Get active driver count
+     */
+    getActiveDriverCount(): number;
+    /**
+     * Quit a specific driver
+     */
+    quit(sessionId: string): Promise<void>;
+    /**
+     * Quit all active drivers
+     */
+    quitAll(): Promise<void>;
+    /**
+     * Remove a driver from tracking (without quitting)
+     */
+    untrack(sessionId: string): void;
+    /**
+     * Load configuration from environment/files
+     */
+    loadConfig(envPath?: string, configPath?: string): this;
+    /**
+     * Set framework configuration
+     */
+    setConfig(config: Partial<FrameworkConfig>): this;
+    /**
+     * Get current framework configuration
+     */
+    getConfig(): FrameworkConfig;
+    /**
+     * Validate configuration
+     */
+    validateConfig(): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+export declare const getDriverFactory: () => DriverFactory;
+//# sourceMappingURL=driver.factory.d.ts.map

package/dist/core/driver.factory.d.ts.map

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

package/dist/core/driver.factory.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDriverFactory = exports.DriverFactory = void 0;
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+/**
+ * Factory class for creating platform-specific drivers.
+ * Supports registration of custom driver implementations.
+ */
+class DriverFactory {
+    /** Singleton instance */
+    static instance = null;
+    /** Driver registry */
+    registry = new Map();
+    /** Active drivers */
+    activeDrivers = new Map();
+    /** Logger */
+    logger;
+    /** Config manager */
+    configManager;
+    constructor() {
+        this.logger = utils_1.Logger.createLogger("DriverFactory");
+        this.configManager = utils_1.ConfigManager.getInstance();
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!DriverFactory.instance) {
+            DriverFactory.instance = new DriverFactory();
+        }
+        return DriverFactory.instance;
+    }
+    /**
+     * Reset singleton instance (useful for testing)
+     */
+    static resetInstance() {
+        if (DriverFactory.instance) {
+            // Cleanup all active drivers
+            DriverFactory.instance.quitAll().catch(console.error);
+        }
+        DriverFactory.instance = null;
+    }
+    /**
+     * Register a driver class for a platform
+     */
+    register(platform, driverClass, defaultConfig) {
+        this.registry.set(platform, {
+            driverClass: driverClass,
+            defaultConfig,
+        });
+        this.logger.debug(`Registered driver for platform: ${platform}`);
+        return this;
+    }
+    /**
+     * Check if a driver is registered for a platform
+     */
+    isRegistered(platform) {
+        return this.registry.has(platform);
+    }
+    /**
+     * Get registered platforms
+     */
+    getRegisteredPlatforms() {
+        return Array.from(this.registry.keys());
+    }
+    /**
+     * Create a driver for the specified platform
+     */
+    async create(platform, options = {}) {
+        const entry = this.registry.get(platform);
+        if (!entry) {
+            throw new utils_1.ConfigurationError(`No driver registered for platform: ${platform}. ` +
+                `Available platforms: ${this.getRegisteredPlatforms().join(", ")}`);
+        }
+        // Get configuration
+        const baseConfig = this.getConfigForPlatform(platform);
+        const mergedConfig = {
+            ...entry.defaultConfig,
+            ...baseConfig,
+            ...options.config,
+        };
+        // Create logger
+        const logger = options.logger || utils_1.Logger.createLogger(platform);
+        // Create driver instance
+        this.logger.info(`Creating ${platform} driver`);
+        const driver = new entry.driverClass(mergedConfig, logger);
+        // Auto-initialize if requested
+        if (options.autoInitialize !== false) {
+            await driver.initialize();
+        }
+        // Track active driver
+        const sessionId = driver.getSessionId() || `temp-${Date.now()}`;
+        this.activeDrivers.set(sessionId, driver);
+        return driver;
+    }
+    /**
+     * Create a web driver
+     */
+    async createWebDriver(options = {}) {
+        return this.create(types_1.Platform.WEB, options);
+    }
+    /**
+     * Create an API driver
+     */
+    async createApiDriver(options = {}) {
+        return this.create(types_1.Platform.API, options);
+    }
+    /**
+     * Create a mobile driver
+     */
+    async createMobileDriver(options = {}) {
+        return this.create(types_1.Platform.MOBILE, options);
+    }
+    /**
+     * Get configuration for a platform
+     */
+    getConfigForPlatform(platform) {
+        switch (platform) {
+            case types_1.Platform.WEB:
+                return this.configManager.getWebConfig();
+            case types_1.Platform.API:
+                return this.configManager.getApiConfig();
+            case types_1.Platform.MOBILE:
+                return this.configManager.getMobileConfig();
+            default:
+                throw new utils_1.ConfigurationError(`Unknown platform: ${platform}`);
+        }
+    }
+    /**
+     * Get an active driver by session ID
+     */
+    getDriver(sessionId) {
+        return this.activeDrivers.get(sessionId);
+    }
+    /**
+     * Get all active drivers
+     */
+    getActiveDrivers() {
+        return Array.from(this.activeDrivers.values());
+    }
+    /**
+     * Get active driver count
+     */
+    getActiveDriverCount() {
+        return this.activeDrivers.size;
+    }
+    /**
+     * Quit a specific driver
+     */
+    async quit(sessionId) {
+        const driver = this.activeDrivers.get(sessionId);
+        if (driver) {
+            await driver.quit();
+            this.activeDrivers.delete(sessionId);
+            this.logger.info(`Driver quit: ${sessionId}`);
+        }
+    }
+    /**
+     * Quit all active drivers
+     */
+    async quitAll() {
+        this.logger.info(`Quitting all drivers (count: ${this.activeDrivers.size})`);
+        const quitPromises = Array.from(this.activeDrivers.entries()).map(async ([sessionId, driver]) => {
+            try {
+                await driver.quit();
+                this.logger.debug(`Driver quit: ${sessionId}`);
+            }
+            catch (error) {
+                this.logger.error(`Failed to quit driver ${sessionId}: ${error.message}`);
+            }
+        });
+        await Promise.all(quitPromises);
+        this.activeDrivers.clear();
+    }
+    /**
+     * Remove a driver from tracking (without quitting)
+     */
+    untrack(sessionId) {
+        this.activeDrivers.delete(sessionId);
+    }
+    /**
+     * Load configuration from environment/files
+     */
+    loadConfig(envPath, configPath) {
+        if (envPath) {
+            this.configManager.loadFromEnv(envPath);
+        }
+        else {
+            this.configManager.loadFromEnv();
+        }
+        if (configPath) {
+            this.configManager.loadFromFile(configPath);
+        }
+        this.configManager.applyDefaults();
+        return this;
+    }
+    /**
+     * Set framework configuration
+     */
+    setConfig(config) {
+        this.configManager.loadFromObject(config);
+        return this;
+    }
+    /**
+     * Get current framework configuration
+     */
+    getConfig() {
+        return this.configManager.getConfig();
+    }
+    /**
+     * Validate configuration
+     */
+    validateConfig() {
+        return this.configManager.validate();
+    }
+}
+exports.DriverFactory = DriverFactory;
+// Export convenience function
+const getDriverFactory = () => DriverFactory.getInstance();
+exports.getDriverFactory = getDriverFactory;
+//# sourceMappingURL=driver.factory.js.map

package/dist/core/driver.factory.js.map

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