playwright-automation-core 1.0.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,145 @@
+import winston from "winston";
+import { LogLevel } from "../types";
+/**
+ * Log metadata interface
+ */
+export interface LogMetadata {
+    [key: string]: unknown;
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerOptions {
+    /** Log level */
+    level?: LogLevel;
+    /** Include timestamps */
+    timestamp?: boolean;
+    /** Log to file */
+    logToFile?: boolean;
+    /** Log file path */
+    logFilePath?: string;
+    /** Log format: 'json' or 'simple' */
+    format?: "json" | "simple";
+    /** Logger name/label */
+    label?: string;
+    /** Colorize console output */
+    colorize?: boolean;
+}
+/**
+ * Logger class providing consistent logging across the framework
+ */
+export declare class Logger {
+    private logger;
+    private static instance;
+    private options;
+    /**
+     * Create a new Logger instance
+     */
+    constructor(options?: LoggerOptions);
+    /**
+     * Get singleton instance of Logger
+     */
+    static getInstance(options?: LoggerOptions): Logger;
+    /**
+     * Reset the singleton instance (useful for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Create a child logger with a specific label
+     */
+    static createLogger(label: string, options?: LoggerOptions): Logger;
+    /**
+     * Create winston logger instance
+     */
+    private createLogger;
+    /**
+     * Log error message
+     */
+    error(message: string, metadata?: LogMetadata): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, metadata?: LogMetadata): void;
+    /**
+     * Log info message
+     */
+    info(message: string, metadata?: LogMetadata): void;
+    /**
+     * Log debug message
+     */
+    debug(message: string, metadata?: LogMetadata): void;
+    /**
+     * Log trace message (uses silly level in winston)
+     */
+    trace(message: string, metadata?: LogMetadata): void;
+    /**
+     * Log a step in the test
+     */
+    step(stepNumber: number, description: string, metadata?: LogMetadata): void;
+    /**
+     * Log start of an action
+     */
+    actionStart(action: string, metadata?: LogMetadata): void;
+    /**
+     * Log end of an action
+     */
+    actionEnd(action: string, duration?: number, metadata?: LogMetadata): void;
+    /**
+     * Log action failure
+     */
+    actionFailed(action: string, error: Error, metadata?: LogMetadata): void;
+    /**
+     * Log API request
+     */
+    apiRequest(method: string, url: string, metadata?: LogMetadata): void;
+    /**
+     * Log API response
+     */
+    apiResponse(method: string, url: string, status: number, duration: number, metadata?: LogMetadata): void;
+    /**
+     * Log navigation
+     */
+    navigation(url: string, metadata?: LogMetadata): void;
+    /**
+     * Log element action
+     */
+    elementAction(action: string, locator: string, metadata?: LogMetadata): void;
+    /**
+     * Log screenshot taken
+     */
+    screenshot(path: string, metadata?: LogMetadata): void;
+    /**
+     * Log test start
+     */
+    testStart(testName: string, metadata?: LogMetadata): void;
+    /**
+     * Log test end
+     */
+    testEnd(testName: string, passed: boolean, duration: number, metadata?: LogMetadata): void;
+    /**
+     * Log suite start
+     */
+    suiteStart(suiteName: string, metadata?: LogMetadata): void;
+    /**
+     * Log suite end
+     */
+    suiteEnd(suiteName: string, passed: number, failed: number, duration: number, metadata?: LogMetadata): void;
+    /**
+     * Create a divider line in logs
+     */
+    divider(char?: string, length?: number): void;
+    /**
+     * Set log level dynamically
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Get the underlying winston logger
+     */
+    getWinstonLogger(): winston.Logger;
+}
+export declare const getLogger: (options?: LoggerOptions) => Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

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

package/dist/utils/logger.js

@@ -0,0 +1,235 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogger = exports.Logger = void 0;
+const winston_1 = __importDefault(require("winston"));
+const types_1 = require("../types");
+/**
+ * Default logger options
+ */
+const defaultOptions = {
+    level: types_1.LogLevel.INFO,
+    timestamp: true,
+    logToFile: false,
+    logFilePath: "./logs/automation.log",
+    format: "simple",
+    label: "playwright-core",
+    colorize: true,
+};
+/**
+ * Custom log format for simple output
+ */
+const simpleFormat = winston_1.default.format.printf(({ level, message, label, timestamp, ...metadata }) => {
+    let msg = `${timestamp} [${label}] ${level}: ${message}`;
+    if (Object.keys(metadata).length > 0) {
+        msg += ` ${JSON.stringify(metadata)}`;
+    }
+    return msg;
+});
+/**
+ * Logger class providing consistent logging across the framework
+ */
+class Logger {
+    logger;
+    static instance = null;
+    options;
+    /**
+     * Create a new Logger instance
+     */
+    constructor(options = {}) {
+        this.options = { ...defaultOptions, ...options };
+        this.logger = this.createLogger();
+    }
+    /**
+     * Get singleton instance of Logger
+     */
+    static getInstance(options) {
+        if (!Logger.instance) {
+            Logger.instance = new Logger(options);
+        }
+        return Logger.instance;
+    }
+    /**
+     * Reset the singleton instance (useful for testing)
+     */
+    static resetInstance() {
+        Logger.instance = null;
+    }
+    /**
+     * Create a child logger with a specific label
+     */
+    static createLogger(label, options) {
+        return new Logger({ ...options, label });
+    }
+    /**
+     * Create winston logger instance
+     */
+    createLogger() {
+        const transports = [];
+        // Console transport
+        const consoleFormat = winston_1.default.format.combine(winston_1.default.format.label({ label: this.options.label }), winston_1.default.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss.SSS" }), this.options.colorize
+            ? winston_1.default.format.colorize()
+            : winston_1.default.format.uncolorize(), this.options.format === "json" ? winston_1.default.format.json() : simpleFormat);
+        transports.push(new winston_1.default.transports.Console({
+            format: consoleFormat,
+        }));
+        // File transport (if enabled)
+        if (this.options.logToFile && this.options.logFilePath) {
+            const fileFormat = winston_1.default.format.combine(winston_1.default.format.label({ label: this.options.label }), winston_1.default.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss.SSS" }), winston_1.default.format.uncolorize(), winston_1.default.format.json());
+            transports.push(new winston_1.default.transports.File({
+                filename: this.options.logFilePath,
+                format: fileFormat,
+            }));
+        }
+        return winston_1.default.createLogger({
+            level: this.options.level,
+            transports,
+        });
+    }
+    /**
+     * Log error message
+     */
+    error(message, metadata) {
+        this.logger.error(message, metadata);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, metadata) {
+        this.logger.warn(message, metadata);
+    }
+    /**
+     * Log info message
+     */
+    info(message, metadata) {
+        this.logger.info(message, metadata);
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, metadata) {
+        this.logger.debug(message, metadata);
+    }
+    /**
+     * Log trace message (uses silly level in winston)
+     */
+    trace(message, metadata) {
+        this.logger.silly(message, metadata);
+    }
+    /**
+     * Log a step in the test
+     */
+    step(stepNumber, description, metadata) {
+        this.info(`Step ${stepNumber}: ${description}`, metadata);
+    }
+    /**
+     * Log start of an action
+     */
+    actionStart(action, metadata) {
+        this.debug(`▶ Starting: ${action}`, metadata);
+    }
+    /**
+     * Log end of an action
+     */
+    actionEnd(action, duration, metadata) {
+        const durationStr = duration !== undefined ? ` (${duration}ms)` : "";
+        this.debug(`✓ Completed: ${action}${durationStr}`, metadata);
+    }
+    /**
+     * Log action failure
+     */
+    actionFailed(action, error, metadata) {
+        this.error(`✗ Failed: ${action} - ${error.message}`, {
+            ...metadata,
+            stack: error.stack,
+        });
+    }
+    /**
+     * Log API request
+     */
+    apiRequest(method, url, metadata) {
+        this.debug(`→ ${method} ${url}`, metadata);
+    }
+    /**
+     * Log API response
+     */
+    apiResponse(method, url, status, duration, metadata) {
+        const statusIcon = status >= 200 && status < 300 ? "✓" : "✗";
+        this.debug(`← ${statusIcon} ${method} ${url} [${status}] (${duration}ms)`, metadata);
+    }
+    /**
+     * Log navigation
+     */
+    navigation(url, metadata) {
+        this.info(`🌐 Navigating to: ${url}`, metadata);
+    }
+    /**
+     * Log element action
+     */
+    elementAction(action, locator, metadata) {
+        this.debug(`🎯 ${action}: ${locator}`, metadata);
+    }
+    /**
+     * Log screenshot taken
+     */
+    screenshot(path, metadata) {
+        this.info(`📸 Screenshot saved: ${path}`, metadata);
+    }
+    /**
+     * Log test start
+     */
+    testStart(testName, metadata) {
+        this.info(`\n${"=".repeat(60)}\n🧪 TEST START: ${testName}\n${"=".repeat(60)}`, metadata);
+    }
+    /**
+     * Log test end
+     */
+    testEnd(testName, passed, duration, metadata) {
+        const status = passed ? "✅ PASSED" : "❌ FAILED";
+        this.info(`\n${"=".repeat(60)}\n${status}: ${testName} (${duration}ms)\n${"=".repeat(60)}\n`, metadata);
+    }
+    /**
+     * Log suite start
+     */
+    suiteStart(suiteName, metadata) {
+        this.info(`\n${"#".repeat(60)}\n📦 SUITE: ${suiteName}\n${"#".repeat(60)}`, metadata);
+    }
+    /**
+     * Log suite end
+     */
+    suiteEnd(suiteName, passed, failed, duration, metadata) {
+        this.info(`\n${"#".repeat(60)}\n📊 SUITE COMPLETE: ${suiteName}\n   Passed: ${passed}, Failed: ${failed}, Duration: ${duration}ms\n${"#".repeat(60)}\n`, metadata);
+    }
+    /**
+     * Create a divider line in logs
+     */
+    divider(char = "-", length = 60) {
+        this.info(char.repeat(length));
+    }
+    /**
+     * Set log level dynamically
+     */
+    setLevel(level) {
+        this.options.level = level;
+        this.logger.level = level;
+    }
+    /**
+     * Get current log level
+     */
+    getLevel() {
+        return this.options.level;
+    }
+    /**
+     * Get the underlying winston logger
+     */
+    getWinstonLogger() {
+        return this.logger;
+    }
+}
+exports.Logger = Logger;
+// Export singleton getter for convenience
+const getLogger = (options) => Logger.getInstance(options);
+exports.getLogger = getLogger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/wait.utils.d.ts

@@ -0,0 +1,95 @@
+import { WaitOptions, RetryOptions } from "../types";
+import { Logger } from "./logger";
+/**
+ * Condition function type
+ */
+export type ConditionFn<T> = () => Promise<T> | T;
+/**
+ * Predicate function type
+ */
+export type PredicateFn<T> = (value: T) => boolean;
+/**
+ * Wait timeout error
+ */
+export declare class WaitTimeoutError extends Error {
+    readonly timeout: number;
+    constructor(message: string, timeout: number);
+}
+/**
+ * Retry exhausted error
+ */
+export declare class RetryExhaustedError extends Error {
+    readonly attempts: number;
+    readonly lastError?: Error | undefined;
+    constructor(message: string, attempts: number, lastError?: Error | undefined);
+}
+/**
+ * Wait utilities class providing various wait mechanisms
+ */
+export declare class WaitUtils {
+    private logger;
+    constructor(logger?: Logger);
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms: number): Promise<void>;
+    /**
+     * Wait for a condition to be truthy
+     * @param condition - Function that returns a value to check
+     * @param options - Wait options
+     * @returns The truthy value returned by condition
+     */
+    waitFor<T>(condition: ConditionFn<T>, options?: WaitOptions): Promise<T>;
+    /**
+     * Wait for a condition to match a predicate
+     * @param condition - Function that returns a value
+     * @param predicate - Function to check the value
+     * @param options - Wait options
+     */
+    waitForCondition<T>(condition: ConditionFn<T>, predicate: PredicateFn<T>, options?: WaitOptions): Promise<T>;
+    /**
+     * Wait for a condition to be false/falsy
+     */
+    waitForNot<T>(condition: ConditionFn<T>, options?: WaitOptions): Promise<void>;
+    /**
+     * Wait for any of the conditions to be truthy
+     * @returns Object with index and result of the first truthy condition
+     */
+    waitForAny<T>(conditions: ConditionFn<T>[], options?: WaitOptions): Promise<{
+        index: number;
+        result: T;
+    }>;
+    /**
+     * Wait for all conditions to be truthy
+     */
+    waitForAll<T>(conditions: ConditionFn<T>[], options?: WaitOptions): Promise<T[]>;
+    /**
+     * Retry a function until it succeeds or retries are exhausted
+     */
+    retry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+    /**
+     * Retry with a condition check
+     */
+    retryUntil<T>(fn: () => Promise<T>, predicate: PredicateFn<T>, options?: Partial<RetryOptions>): Promise<T>;
+    /**
+     * Execute with timeout
+     */
+    withTimeout<T>(fn: () => Promise<T>, timeout: number, message?: string): Promise<T>;
+    /**
+     * Poll a function at regular intervals
+     */
+    poll<T>(fn: ConditionFn<T>, interval: number, timeout: number): Promise<T>;
+    /**
+     * Wait for a value to stabilize (not change for a period)
+     */
+    waitForStable<T>(getValue: ConditionFn<T>, stableTime?: number, options?: WaitOptions): Promise<T>;
+    /**
+     * Execute functions in sequence with delay between each
+     */
+    sequence<T>(fns: (() => Promise<T>)[], delayBetween?: number): Promise<T[]>;
+}
+export declare const waitUtils: WaitUtils;
+export declare const sleep: (ms: number) => Promise<void>;
+export declare const waitFor: <T>(condition: ConditionFn<T>, options?: WaitOptions) => Promise<T>;
+export declare const retry: <T>(fn: () => Promise<T>, options?: Partial<RetryOptions>) => Promise<T>;
+//# sourceMappingURL=wait.utils.d.ts.map

package/dist/utils/wait.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.utils.d.ts","sourceRoot":"","sources":["../../src/utils/wait.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAqBlC;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;AAEnD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aACI,OAAO,EAAE,MAAM;gBAAhD,OAAO,EAAE,MAAM,EAAkB,OAAO,EAAE,MAAM;CAI7D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,QAAQ,EAAE,MAAM;aAChB,SAAS,CAAC,EAAE,KAAK;gBAFjC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,KAAK,YAAA;CAKpC;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAI3B;;OAEG;IACU,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;;;;OAKG;IACU,OAAO,CAAC,CAAC,EACpB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC;IA0Bb;;;;;OAKG;IACU,gBAAgB,CAAC,CAAC,EAC7B,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC;IAyBb;;OAEG;IACU,UAAU,CAAC,CAAC,EACvB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAwBhB;;;OAGG;IACU,UAAU,CAAC,CAAC,EACvB,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAC5B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC;IAyBxC;;OAEG;IACU,UAAU,CAAC,CAAC,EACvB,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAC5B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,EAAE,CAAC;IAoCf;;OAEG;IACU,KAAK,CAAC,CAAC,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;IA0Cb;;OAEG;IACU,UAAU,CAAC,CAAC,EACvB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;IAgCb;;OAEG;IACU,WAAW,CAAC,CAAC,EACxB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC;IAgBb;;OAEG;IACU,IAAI,CAAC,CAAC,EACjB,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACU,aAAa,CAAC,CAAC,EAC1B,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EACxB,UAAU,GAAE,MAAY,EACxB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC;IA+Bb;;OAEG;IACU,QAAQ,CAAC,CAAC,EACrB,GAAG,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EACzB,YAAY,GAAE,MAAU,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC;CAYhB;AAGD,eAAO,MAAM,SAAS,WAAkB,CAAC;AAGzC,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAAwB,CAAC;AACxE,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,WAAW,WAAW,CAAC,CAAC,CAAC,EACzB,UAAU,WAAW,KACpB,OAAO,CAAC,CAAC,CAA0C,CAAC;AACvD,eAAO,MAAM,KAAK,GAAI,CAAC,EACrB,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,OAAO,CAAC,YAAY,CAAC,KAC9B,OAAO,CAAC,CAAC,CAAiC,CAAC"}