@seontechnologies/playwright-utils 3.10.0

package/dist/cjs/auth-session/internal/cache-manager.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Advanced cache manager for auth session tokens
+ * Provides LRU eviction, memory pressure monitoring, and performance metrics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalTokenCache = exports.TokenCacheManager = void 0;
+const log_1 = require("../../log");
+/** Default cache configuration */
+const DEFAULT_CONFIG = {
+    maxSize: 50,
+    defaultTtlMs: 15 * 60 * 1000, // 15 minutes
+    enableMemoryPressureCleanup: true,
+    cleanupIntervalMs: 5 * 60 * 1000, // 5 minutes
+    enableMetrics: false
+};
+/**
+ * Advanced token cache manager with LRU eviction and memory management
+ */
+class TokenCacheManager {
+    constructor(config = {}) {
+        this.cache = new Map();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.metrics = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+            cleanups: 0,
+            totalEntries: 0,
+            hitRate: 0
+        };
+        // Start periodic cleanup if enabled
+        if (this.config.enableMemoryPressureCleanup) {
+            this.startPeriodicCleanup();
+        }
+    }
+    /**
+     * Get a token from cache if it exists and is not expired
+     * @param key Cache key (typically file path)
+     * @returns Token string or null if not found/expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        const now = Date.now();
+        if (!entry) {
+            this.recordMiss();
+            return null;
+        }
+        // Check if expired
+        if (entry.expires <= now) {
+            this.cache.delete(key);
+            this.recordMiss();
+            return null;
+        }
+        // Update access metadata for LRU
+        entry.lastAccessed = now;
+        entry.accessCount++;
+        this.recordHit();
+        return entry.token;
+    }
+    /**
+     * Store a token in cache with optional TTL
+     * @param key Cache key (typically file path)
+     * @param token Token string to cache
+     * @param ttlMs Optional time-to-live in milliseconds
+     */
+    set(key, token, ttlMs) {
+        if (!token) {
+            log_1.log.warningSync('Attempted to cache empty token');
+            return;
+        }
+        const now = Date.now();
+        const expires = now + (ttlMs || this.config.defaultTtlMs);
+        // Check if we need to evict entries due to size limit
+        if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {
+            this.evictLeastRecentlyUsed();
+        }
+        const entry = {
+            token,
+            expires,
+            lastAccessed: now,
+            accessCount: 1
+        };
+        this.cache.set(key, entry);
+        this.updateMetrics();
+    }
+    /**
+     * Remove a specific entry from cache
+     * @param key Cache key to remove
+     * @returns Whether the key was found and removed
+     */
+    delete(key) {
+        const deleted = this.cache.delete(key);
+        if (deleted) {
+            this.updateMetrics();
+        }
+        return deleted;
+    }
+    /**
+     * Clear all entries from cache
+     */
+    clear() {
+        this.cache.clear();
+        this.resetMetrics();
+    }
+    /**
+     * Get current cache metrics
+     * @returns Cache performance metrics
+     */
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    /**
+     * Get cache status information
+     */
+    getStatus() {
+        const entries = Array.from(this.cache.values());
+        const now = Date.now();
+        const oldestEntryAge = entries.length > 0
+            ? Math.max(...entries.map((e) => now - e.lastAccessed))
+            : 0;
+        const averageAccessCount = entries.length > 0
+            ? entries.reduce((sum, e) => sum + e.accessCount, 0) / entries.length
+            : 0;
+        return {
+            size: this.cache.size,
+            maxSize: this.config.maxSize,
+            utilizationPercent: (this.cache.size / this.config.maxSize) * 100,
+            oldestEntryAge,
+            averageAccessCount
+        };
+    }
+    /**
+     * Manually trigger cache cleanup
+     * Removes expired entries and optionally enforces size limits
+     * @param forceEviction Whether to force LRU eviction even if under size limit
+     * @returns Number of entries removed
+     */
+    cleanup(forceEviction = false) {
+        const initialSize = this.cache.size;
+        const now = Date.now();
+        // Remove expired entries
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.expires <= now) {
+                this.cache.delete(key);
+            }
+        }
+        // Force eviction if requested or if still over size limit
+        while ((forceEviction && this.cache.size > 0) ||
+            this.cache.size > this.config.maxSize) {
+            if (!this.evictLeastRecentlyUsed()) {
+                break; // No more entries to evict
+            }
+        }
+        const removed = initialSize - this.cache.size;
+        this.metrics.cleanups++;
+        this.updateMetrics();
+        return removed;
+    }
+    /**
+     * Destroy cache manager and cleanup resources
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        this.clear();
+    }
+    /**
+     * Evict the least recently used entry
+     * @returns Whether an entry was evicted
+     */
+    evictLeastRecentlyUsed() {
+        if (this.cache.size === 0)
+            return false;
+        let lruKey = null;
+        let lruLastAccessed = Infinity;
+        // Find the least recently used entry
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.lastAccessed < lruLastAccessed) {
+                lruLastAccessed = entry.lastAccessed;
+                lruKey = key;
+            }
+        }
+        if (lruKey) {
+            this.cache.delete(lruKey);
+            this.metrics.evictions++;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Start periodic cleanup timer
+     */
+    startPeriodicCleanup() {
+        this.cleanupTimer = setInterval(() => {
+            const removed = this.cleanup();
+            if (this.config.enableMetrics && removed > 0) {
+                log_1.log.infoSync(`Cache cleanup removed ${removed} entries`);
+            }
+        }, this.config.cleanupIntervalMs);
+        // Don't keep process alive for cleanup timer
+        this.cleanupTimer.unref();
+    }
+    /**
+     * Record a cache hit and update metrics
+     */
+    recordHit() {
+        if (this.config.enableMetrics) {
+            this.metrics.hits++;
+            this.updateHitRate();
+        }
+    }
+    /**
+     * Record a cache miss and update metrics
+     */
+    recordMiss() {
+        if (this.config.enableMetrics) {
+            this.metrics.misses++;
+            this.updateHitRate();
+        }
+    }
+    /**
+     * Update cache metrics
+     */
+    updateMetrics() {
+        if (this.config.enableMetrics) {
+            this.metrics.totalEntries = this.cache.size;
+            this.updateHitRate();
+        }
+    }
+    /**
+     * Calculate and update hit rate
+     */
+    updateHitRate() {
+        const total = this.metrics.hits + this.metrics.misses;
+        this.metrics.hitRate = total > 0 ? this.metrics.hits / total : 0;
+    }
+    /**
+     * Reset all metrics to zero
+     */
+    resetMetrics() {
+        this.metrics.hits = 0;
+        this.metrics.misses = 0;
+        this.metrics.evictions = 0;
+        this.metrics.cleanups = 0;
+        this.metrics.totalEntries = 0;
+        this.metrics.hitRate = 0;
+    }
+}
+exports.TokenCacheManager = TokenCacheManager;
+// Global cache instance with sensible defaults
+exports.globalTokenCache = new TokenCacheManager({
+    maxSize: 50,
+    defaultTtlMs: 15 * 60 * 1000, // 15 minutes
+    enableMemoryPressureCleanup: true,
+    cleanupIntervalMs: 5 * 60 * 1000, // 5 minutes
+    enableMetrics: process.env.NODE_ENV === 'development'
+});
+// Cleanup on process exit
+if (typeof process !== 'undefined') {
+    process.on('exit', () => {
+        exports.globalTokenCache.destroy();
+    });
+}
+//# sourceMappingURL=cache-manager.js.map

package/dist/cjs/auth-session/internal/cache-manager.js.map

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

package/dist/cjs/auth-session/internal/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Authentication storage configuration options for flexibility across different project structures
+ */
+export type AuthStorageConfig = {
+    /** Root directory for auth session storage (fixed at process.cwd()/.auth) */
+    storageDir?: string;
+    /** Debug mode to enable additional logging */
+    debug?: boolean;
+};
+/** Function type for customizing how token data is formatted before storage
+ * This allows for complete customization of the token storage format with type safety
+ *
+ * Token data can be any format that the auth provider supports:
+ * - Simple Bearer tokens (string)
+ * - Playwright storage state (object with cookies and origins)
+ * - Custom token formats from auth providers
+ *
+ * NOTE: For UI testing with Playwright's built-in storage state, this formatter is often
+ * unnecessary and can be omitted entirely. The default implementation simply passes
+ * the token through without modification.
+ *
+ * @template TInput The type of the input token data
+ * @template TOutput The type of the formatted output data
+ * @param token The raw token data
+ * @param options Optional auth session options to customize formatting
+ * @returns Formatted token data ready for storage
+ */
+export type TokenDataFormatter<TInput = unknown, TOutput = unknown> = (token: TInput, options?: Partial<AuthSessionOptions>) => TOutput;
+/**
+ * Standard Playwright storage state format for type safety
+ * This represents the expected structure for browser context storage state
+ */
+export type PlaywrightStorageState = {
+    cookies: Array<{
+        name: string;
+        value: string;
+        domain?: string;
+        path?: string;
+        expires?: number;
+        httpOnly?: boolean;
+        secure?: boolean;
+        sameSite?: 'Strict' | 'Lax' | 'None';
+    }>;
+    origins: Array<{
+        origin: string;
+        localStorage: Array<{
+            name: string;
+            value: string;
+        }>;
+    }>;
+};
+/** Default token data formatter type that converts unknown input to Playwright storage state */
+export type DefaultTokenDataFormatter = TokenDataFormatter<unknown, PlaywrightStorageState>;
+/** Retry configuration for error recovery */
+export type RetryConfig = {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial delay between retries in milliseconds (default: 100ms) */
+    initialDelayMs?: number;
+    /** Exponential backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Maximum delay between retries in milliseconds (default: 5000ms) */
+    maxDelayMs?: number;
+    /** Whether to add random jitter to delays (default: true) */
+    enableJitter?: boolean;
+};
+/** Options for the auth session */
+export type AuthSessionOptions = AuthIdentifiers & {
+    /** Root directory for auth session storage (default: process.cwd()/.auth)
+     * Note: The environment and user identifier will be appended to this path by the provider */
+    storageDir?: string;
+    /** Token filename (default: storage-state.json) */
+    tokenFileName?: string;
+    /** Cookie name to use for authentication (default: auth-token) */
+    cookieName?: string;
+    /** Custom token data formatter to control how tokens are saved */
+    tokenDataFormatter?: TokenDataFormatter<unknown, PlaywrightStorageState>;
+    /** Debug mode (default: false) */
+    debug?: boolean;
+    /** Retry configuration for error recovery (default: { maxRetries: 3, initialDelayMs: 100 }) */
+    retryConfig?: RetryConfig;
+};
+/**
+ * Full auth configuration that extends the base identifiers
+ * Includes URLs and additional configuration beyond just identifiers
+ */
+export type AuthOptions = AuthIdentifiers & {
+    /** Base URL to use for the browser context (the application URL)
+     * If not provided, will be determined based on environment
+     * @default process.env.BASE_URL || environment-specific URL */
+    baseUrl?: string;
+    /** Base URL to use for authentication requests (the auth service URL)
+     * This is often different from the application baseUrl
+     * @default process.env.AUTH_BASE_URL || environment-specific auth URL */
+    authBaseUrl?: string;
+};
+/** For usage in test fixtures */
+export type AuthFixtures = {
+    /** Configuration options for authentication */
+    authOptions: AuthOptions;
+    /** Authentication token for API requests */
+    authToken: string;
+    /** Toggle to enable/disable authentication session
+     * When false, auth token acquisition and applying to browser context is skipped
+     * Set to false to completely disable auth for specific tests
+     * @default true */
+    authSessionEnabled: boolean;
+};
+/**
+ * Base identification options used across the auth system
+ * These identifiers determine which environment and user identifier to use
+ */
+export type AuthIdentifiers = {
+    /** Environment to use for authentication
+     * @default process.env.TEST_ENV || 'local' */
+    environment?: string;
+    /** User identifier; email or username */
+    userIdentifier?: string;
+    /** User password */
+    userPassword?: string;
+};
+/**
+ * Result of storage path resolution
+ * Contains the actual filesystem paths for auth storage
+ */
+export type AuthSessionConfig = {
+    /** Resolved directory for auth storage files */
+    storageDir: string;
+    /** Full path to the Playwright storage state file */
+    storageStatePath: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/auth-session/internal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/auth-session/internal/types.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,kBAAkB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CACpE,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAClC,OAAO,CAAA;AAEZ;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;KACrC,CAAC,CAAA;IACF,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,KAAK,CAAC;YAClB,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,EAAE,MAAM,CAAA;SACd,CAAC,CAAA;KACH,CAAC,CAAA;CACH,CAAA;AAED,gGAAgG;AAChG,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CACxD,OAAO,EACP,sBAAsB,CACvB,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,mCAAmC;AACnC,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD;iGAC6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAA;IACxE,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,+FAA+F;IAC/F,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAC1C;;mEAE+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;6EAEyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,iCAAiC;AACjC,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,WAAW,EAAE,WAAW,CAAA;IAExB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IAEjB;;;uBAGmB;IACnB,kBAAkB,EAAE,OAAO,CAAA;CAG5B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;kDAC8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;IAElB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA"}

package/dist/cjs/auth-session/internal/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Type definitions for the authentication session manager
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/auth-session/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/auth-session/internal/types.ts"],"names":[],"mappings":";AAAA,0DAA0D"}

package/dist/cjs/burn-in/core/analyzer.d.ts

@@ -0,0 +1,36 @@
+import type { BurnInConfig, BurnInOptions } from './types';
+type ChangedFiles = {
+    testFiles: string[];
+    skipBurnInFiles: string[];
+    otherFiles: string[];
+    all: string[];
+};
+type TestRunPlan = {
+    /** Tests to run, or null to use --only-changed */
+    tests: string[] | null;
+    /** Special flags like --shard */
+    flags?: string[];
+    /** Reason for the test selection */
+    reason: string;
+};
+export declare class BurnInAnalyzer {
+    private config;
+    private options;
+    private debugMode;
+    constructor(config: BurnInConfig, options: BurnInOptions);
+    getChangedFiles(baseBranch: string): ChangedFiles;
+    private isTestFile;
+    private isSkipBurnInFile;
+    private matchesPattern;
+    analyzeTestableDependencies(changedFiles: ChangedFiles): Promise<TestRunPlan>;
+    private createCustomTestPlan;
+    private findAffectedTests;
+    private findTsConfig;
+    private findTestFiles;
+    private testDependsOnChangedFiles;
+    private pathsMatch;
+    private isBasenameMatch;
+    buildCommand(plan: TestRunPlan): string[] | null;
+}
+export {};
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/cjs/burn-in/core/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../../src/burn-in/core/analyzer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAG1D,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,GAAG,EAAE,MAAM,EAAE,CAAA;CACd,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACtB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,qBAAa,cAAc;IAIvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,SAAS,CAAS;gBAGhB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa;IAMhC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAqEjD,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,cAAc;IAYhB,2BAA2B,CAC/B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,WAAW,CAAC;YA+BT,oBAAoB;YA+DpB,iBAAiB;IA0D/B,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,yBAAyB;IAgDjC,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,eAAe;IAIvB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,GAAG,IAAI;CA8BjD"}