@seontechnologies/playwright-utils 3.10.0

package/dist/esm/log/outputs/add-test-header.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addTestHeader = addTestHeader;
+const context_1 = require("./context");
+/** Initial empty tracker state */
+const initialTracker = {
+    lastTestName: '',
+    lastTestFile: ''
+};
+/** For consolidated logs, format section header with a consistent divider */
+const formatSectionHeader = () => `\n${'='.repeat(40)} TEST SECTION ${'='.repeat(40)}\n\n`;
+/** Pure function to generate updated tracker state */
+const createUpdatedTracker = (current, testName, testFile) => ({
+    ...current,
+    lastTestName: testName || '',
+    ...(testFile ? { lastTestFile: testFile } : {})
+});
+/** For consolidated logs, creates a formatted header for test logs
+ * If consolidated logging is disabled, the original message is returned unchanged.
+ * Generates a section header based on available test information and prepends it to the original message. */
+const createFormattedHeader = ({ message, isConsolidatedLog }) => {
+    if (!isConsolidatedLog)
+        return message;
+    const header = formatSectionHeader();
+    return `${header}${message}`;
+};
+/** Format test header and return the updated message and tracker state
+ * Works with both consolidated and non-consolidated logs, but only adds headers for consolidated logs */
+const formatTestHeader = (input, testInfo) => {
+    const { tracker, message, options, isConsolidatedLog } = input;
+    const { sectionInfo, safeTestFile, detectedTestFile } = testInfo;
+    const formattedMessage = createFormattedHeader({
+        message,
+        isConsolidatedLog,
+        sectionInfo,
+        options,
+        tracker,
+        safeTestFile
+    });
+    // Update the tracker using pure function
+    const updatedTracker = createUpdatedTracker(tracker, options.testName || '', safeTestFile);
+    return {
+        message: formattedMessage,
+        testFile: detectedTestFile,
+        tracker: updatedTracker
+    };
+};
+/** Extract a section title from a log message using a regex */
+const extractSectionTitle = (message) => {
+    if (!message.includes('==== '))
+        return undefined;
+    const match = message.match(/====\s+(.+?)\s+====/);
+    return match && match[1] ? match[1].trim() : undefined;
+};
+/** For consolidated logs, process section headers to extract meaningful test info */
+const processSectionHeaders = (message, isConsolidatedLog) => {
+    if (!message.includes('==== ') || !isConsolidatedLog)
+        return {};
+    // Extract title from section header
+    const title = extractSectionTitle(message);
+    return title ? { sectionTitle: title } : {};
+};
+/** Add test header to message when needed */
+function addTestHeader(tracker = initialTracker, message, options, testFile) {
+    // Get the detected test file
+    const detectedTestFile = testFile;
+    // Try to extract test info from log message if not provided
+    const updatedTestFile = (0, context_1.extractTestInfoIfNeeded)(message, options, detectedTestFile);
+    // Use safe values with fallbacks
+    const safeTestFile = updatedTestFile ?? detectedTestFile ?? '';
+    const newTest = options.testName !== tracker.lastTestName;
+    const newFile = safeTestFile !== tracker.lastTestFile;
+    // Check if this is a default folder consolidated log
+    const isConsolidatedLog = !options.testFile && !testFile;
+    // Extract section info from message for consolidated logs
+    const sectionInfo = processSectionHeaders(message, isConsolidatedLog);
+    // Special case: we're starting a new test, add a header regardless
+    if (isConsolidatedLog && (newTest || newFile)) {
+        return formatTestHeader({
+            tracker,
+            message,
+            options,
+            isConsolidatedLog
+        }, {
+            sectionInfo,
+            safeTestFile,
+            detectedTestFile
+        });
+    }
+    return { message, testFile: detectedTestFile, tracker };
+}
+//# sourceMappingURL=add-test-header.js.map

package/dist/esm/log/outputs/add-test-header.js.map

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

package/dist/esm/log/outputs/context.d.ts

@@ -0,0 +1,73 @@
+/** Log context and test tracking */
+import type { LogContext, LoggingConfig } from '../types';
+type LoggingContextOptions = LoggingConfig & {
+    workerIndex?: number;
+};
+/**
+ * Creates a unified context object for organizing and formatting logs.
+ *
+ * This function serves several important purposes in the logging system:
+ *
+ * 1. Combines global configuration with per-call options to enable flexibility
+ *    in how logs are formatted and stored
+ *
+ * 2. Enriches logging context with test information (test name, file, worker index)
+ *    which is used for properly organizing logs by test
+ *
+ * 3. Normalizes worker ID settings by determining if worker IDs are enabled
+ *    and what format they should use
+ *
+ * 4. Provides a consistent interface for other logging components (file, console)
+ *    to access all context information needed for their operations
+ *
+ * The returned LogContext is used throughout the logging system to:
+ * - Create proper file paths for log files
+ * - Format messages with appropriate test headers
+ * - Add worker identification to logs
+ * - Apply formatting rules consistently
+ *
+ * @param options - Per-call logging options passed to the log method
+ * @returns LogContext - A complete context object with both global and call-specific settings
+ */
+export declare function getLogContext(options: LoggingConfig): LogContext;
+/**
+ * Extracts test information from log messages and updates options object with this data.
+ *
+ * Used specifically for consolidated logging mode to ensure test context is maintained
+ * when multiple tests write to the same log file. This function:
+ *
+ * 1. Checks if the message contains test info in the [TestName] [File: path] format
+ * 2. Updates the options object directly by adding the extracted test name
+ * 3. If needed, also updates the test file path in the options object
+ * 4. Returns the detected test file path for caller's reference
+ *
+ * Note: This function intentionally mutates the options parameter as a side effect
+ * to ensure test context is properly maintained across the logging system.
+ */
+export declare function extractTestInfoIfNeeded(message: string, options: LoggingConfig, detectedFile?: string): string | undefined;
+/**
+ * Populates test options with context information for both logging modes.
+ *
+ * This function enriches logging options with test context information,
+ * supporting both organized and consolidated logging modes:
+ *
+ * For organized logging:
+ * - Ensures each test log file has the correct test name in its path
+ * - Provides proper file organization based on test information
+ *
+ * For consolidated logging:
+ * - Ensures test identification headers contain accurate test names
+ * - Provides fallback test names based on file paths when needed
+ *
+ * The function mutates the options object by adding test context,
+ * and returns additional metadata about the context enrichment.
+ *
+ * @param options - The logging options to enrich with test context
+ * @returns Object containing the resolved test file and whether context was found
+ */
+export declare function populateTestOptions(options: LoggingContextOptions): {
+    testFile: string | undefined;
+    hasTestContext: boolean;
+};
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/esm/log/outputs/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/log/outputs/context.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAIzD,KAAK,qBAAqB,GAAG,aAAa,GAAG;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,CAiChE;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAiBpB;AAkBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG;IACnE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,cAAc,EAAE,OAAO,CAAA;CACxB,CAkBA"}

package/dist/esm/log/outputs/context.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogContext = getLogContext;
+exports.extractTestInfoIfNeeded = extractTestInfoIfNeeded;
+exports.populateTestOptions = populateTestOptions;
+const config_1 = require("../config");
+const DEFAULT_WORKER_FORMAT = '[W{workerIndex}]';
+/**
+ * Creates a unified context object for organizing and formatting logs.
+ *
+ * This function serves several important purposes in the logging system:
+ *
+ * 1. Combines global configuration with per-call options to enable flexibility
+ *    in how logs are formatted and stored
+ *
+ * 2. Enriches logging context with test information (test name, file, worker index)
+ *    which is used for properly organizing logs by test
+ *
+ * 3. Normalizes worker ID settings by determining if worker IDs are enabled
+ *    and what format they should use
+ *
+ * 4. Provides a consistent interface for other logging components (file, console)
+ *    to access all context information needed for their operations
+ *
+ * The returned LogContext is used throughout the logging system to:
+ * - Create proper file paths for log files
+ * - Format messages with appropriate test headers
+ * - Add worker identification to logs
+ * - Apply formatting rules consistently
+ *
+ * @param options - Per-call logging options passed to the log method
+ * @returns LogContext - A complete context object with both global and call-specific settings
+ */
+function getLogContext(options) {
+    const config = (0, config_1.getLoggingConfig)();
+    const testContext = (0, config_1.getTestContextInfo)();
+    // Create a new options object with test context information
+    const enrichedOptions = {
+        ...options,
+        // Use options values or fallback to test context values
+        testFile: options.testFile || testContext?.testFile,
+        testName: options.testName || testContext?.testName,
+        // Worker index is stored in test context but not part of LoggingConfig
+        workerIndex: testContext?.workerIndex
+    };
+    // Determine if worker IDs are enabled (default to true unless explicitly disabled)
+    const workerIDEnabled = typeof config.workerID === 'boolean'
+        ? config.workerID
+        : config.workerID?.enabled !== false;
+    const workerIDFormat = typeof config.workerID === 'object' && config.workerID?.format
+        ? config.workerID.format
+        : DEFAULT_WORKER_FORMAT;
+    return {
+        config,
+        testFile: enrichedOptions.testFile,
+        testName: enrichedOptions.testName,
+        options: enrichedOptions,
+        workerIDEnabled,
+        workerIDFormat
+    };
+}
+/** Extract test information from formatted messages
+ * like [TestName] [File: filename.spec.ts] */
+const extractTestInfoFromMessage = (message) => {
+    // [TestName] [File: filename.spec.ts]
+    const testInfoPattern = /\[([^\]]+)\]\s*\[File:\s*([^\]]+)\]/;
+    const testNameMatch = message.match(testInfoPattern);
+    // If we have a match (3 capture groups), extract the test name and file
+    if (testNameMatch && testNameMatch.length >= 3) {
+        return {
+            testName: testNameMatch[1] ? testNameMatch[1].trim() : undefined,
+            testFile: testNameMatch[2] ? testNameMatch[2].trim() : undefined
+        };
+    }
+    return {};
+};
+/**
+ * Extracts test information from log messages and updates options object with this data.
+ *
+ * Used specifically for consolidated logging mode to ensure test context is maintained
+ * when multiple tests write to the same log file. This function:
+ *
+ * 1. Checks if the message contains test info in the [TestName] [File: path] format
+ * 2. Updates the options object directly by adding the extracted test name
+ * 3. If needed, also updates the test file path in the options object
+ * 4. Returns the detected test file path for caller's reference
+ *
+ * Note: This function intentionally mutates the options parameter as a side effect
+ * to ensure test context is properly maintained across the logging system.
+ */
+function extractTestInfoIfNeeded(message, options, detectedFile) {
+    // If no test name in options, see if we can extract it from the message
+    if (!options.testName) {
+        const testInfo = extractTestInfoFromMessage(message);
+        if (testInfo.testName) {
+            options.testName = testInfo.testName;
+            // If no test file either in options or detected, use the one from message
+            if (!options.testFile && !detectedFile && testInfo.testFile) {
+                options.testFile = testInfo.testFile;
+                return testInfo.testFile;
+            }
+        }
+    }
+    return detectedFile;
+}
+/** Get test name from a spec file path
+ * Useful for log formatting when test context isn't captured */
+function getTestNameFromFilePath(filePath) {
+    if (!filePath)
+        return 'Unknown Test';
+    // Extract filename without extension
+    const filename = filePath
+        .split('/')
+        .pop()
+        ?.replace(/\.spec\.ts$|\.test\.ts$/, '') || '';
+    // Convert kebab-case to readable format
+    return filename.replace(/-/g, ' ');
+}
+/**
+ * Populates test options with context information for both logging modes.
+ *
+ * This function enriches logging options with test context information,
+ * supporting both organized and consolidated logging modes:
+ *
+ * For organized logging:
+ * - Ensures each test log file has the correct test name in its path
+ * - Provides proper file organization based on test information
+ *
+ * For consolidated logging:
+ * - Ensures test identification headers contain accurate test names
+ * - Provides fallback test names based on file paths when needed
+ *
+ * The function mutates the options object by adding test context,
+ * and returns additional metadata about the context enrichment.
+ *
+ * @param options - The logging options to enrich with test context
+ * @returns Object containing the resolved test file and whether context was found
+ */
+function populateTestOptions(options) {
+    // Get the test context - this will provide better info for logs
+    const testContext = (0, config_1.getTestContextInfo)();
+    let hasTestContext = false;
+    // Add the actual test name from test context if available
+    if (!options.testName && testContext.testName) {
+        options.testName = testContext.testName;
+        hasTestContext = true;
+    }
+    else if (!options.testName && options.testFile) {
+        // Use the file name as a fallback
+        options.testName = getTestNameFromFilePath(options.testFile);
+    }
+    // Get the test file if available
+    const testFile = options.testFile || testContext.testFile;
+    return { testFile, hasTestContext };
+}
+//# sourceMappingURL=context.js.map

package/dist/esm/log/outputs/context.js.map

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

package/dist/esm/log/outputs/create-log-file-path.d.ts

@@ -0,0 +1,6 @@
+import type { LogContext } from '../types';
+/** Creates a file path for logs based on test context.
+ * This function uses pure helper functions for decision logic,
+ * while managing side effects (directory creation) as needed. */
+export declare function createLogFilePath(context: LogContext): string;
+//# sourceMappingURL=create-log-file-path.d.ts.map

package/dist/esm/log/outputs/create-log-file-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-log-file-path.d.ts","sourceRoot":"","sources":["../../../../src/log/outputs/create-log-file-path.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,UAAU,CAAA;AAqGzD;;iEAEiE;AACjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAoB7D"}

package/dist/esm/log/outputs/create-log-file-path.js

@@ -0,0 +1,118 @@
+"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.createLogFilePath = createLogFilePath;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** Ensures a directory exists, creating it if necessary */
+const ensureDirectoryExists = (directory) => {
+    if (!fs.existsSync(directory)) {
+        try {
+            fs.mkdirSync(directory, { recursive: true });
+        }
+        catch (error) {
+            console.error(`Error creating directory: ${directory}`, error);
+        }
+    }
+};
+/** Gets current date formatted as YYYY-MM-DD */
+const getFormattedDate = () => {
+    const date = new Date();
+    return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;
+};
+/** Creates a file name for test-organized logs */
+const createTestBasedFileName = (testName, workerIndex) => {
+    const safeName = testName
+        ? testName.replace(/[^a-zA-Z0-9]/g, '-') // replace non-alphanumeric characters with hyphens
+        : 'unnamed-test';
+    return `${safeName}-worker-${workerIndex}.log`;
+};
+/* PURE HELPERS */
+/** Extracts a safe test file name from the provided file path. */
+const getTestFileName = (testFile) => testFile
+    ? path.basename(testFile, path.extname(testFile))
+    : 'unknown-test-file';
+/** Extracts the worker information from the options. */
+const getWorkerString = (options) => {
+    const logContextOptions = options;
+    return typeof logContextOptions?.workerIndex === 'number'
+        ? logContextOptions.workerIndex.toString()
+        : 'unknown';
+};
+/** Computes the subdirectory and file name for test-organized logs. */
+const getSubDirAndFileNameForTestContext = (outputDir, dateString, testFile, testName, options) => {
+    const testFileName = getTestFileName(testFile);
+    const subDir = path.join(outputDir, dateString, testFileName);
+    const workerString = getWorkerString(options);
+    const fileName = createTestBasedFileName(testName, workerString);
+    return { subDir, fileName };
+};
+/** Returns the folder name used for consolidated logs. */
+const getConsolidatedFolderName = (config) => (typeof config.fileLogging === 'object' &&
+    config.fileLogging?.defaultTestFolder) ||
+    'consolidated';
+/** * Computes the subdirectory and file name for consolidated logs. */
+const getSubDirAndFileNameForConsolidated = (outputDir, dateString, config) => {
+    const defaultFolder = getConsolidatedFolderName(config);
+    const subDir = path.join(outputDir, dateString, defaultFolder);
+    const fileName = 'test-logs.log';
+    return { subDir, fileName };
+};
+/** Determines the base output directory for logs using the config,
+ * or falls back to 'playwright-logs'. */
+const getOutputDir = (config) => (typeof config.fileLogging === 'object' && config.fileLogging?.outputDir) ||
+    'playwright-logs';
+/** Determines if log consolidation is forced by config. */
+const isForceConsolidated = (config) => typeof config.fileLogging === 'object' &&
+    config.fileLogging.forceConsolidated === true;
+/** Determines if test context (test file or test name) is available
+ * and should be used to organize logs. */
+const hasTestContext = (config, testFile, testName) => !isForceConsolidated(config) && Boolean(testFile || testName);
+/* FINAL IMPURE FUNCTION */
+/** Creates a file path for logs based on test context.
+ * This function uses pure helper functions for decision logic,
+ * while managing side effects (directory creation) as needed. */
+function createLogFilePath(context) {
+    const { config, testFile, testName, options } = context;
+    const outputDir = getOutputDir(config);
+    ensureDirectoryExists(outputDir);
+    const dateString = getFormattedDate();
+    const { subDir, fileName } = hasTestContext(config, testFile, testName)
+        ? getSubDirAndFileNameForTestContext(outputDir, dateString, testFile, testName, options)
+        : getSubDirAndFileNameForConsolidated(outputDir, dateString, config);
+    ensureDirectoryExists(subDir);
+    return path.join(subDir, fileName);
+}
+//# sourceMappingURL=create-log-file-path.js.map

package/dist/esm/log/outputs/create-log-file-path.js.map

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

package/dist/esm/log/outputs/log-to-console.d.ts

@@ -0,0 +1,4 @@
+import type { LogLevel } from '../types';
+/** Logs a message to the console using the method corresponding to the log level */
+export declare const logToConsole: (message: string, level: LogLevel) => Promise<void>;
+//# sourceMappingURL=log-to-console.d.ts.map

package/dist/esm/log/outputs/log-to-console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-to-console.d.ts","sourceRoot":"","sources":["../../../../src/log/outputs/log-to-console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAmBxC,oFAAoF;AACpF,eAAO,MAAM,YAAY,GACvB,SAAS,MAAM,EACf,OAAO,QAAQ,KACd,OAAO,CAAC,IAAI,CAMd,CAAA"}

package/dist/esm/log/outputs/log-to-console.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logToConsole = void 0;
+const async_1 = require("../utils/async");
+/** Maps log levels to appropriate console methods */
+const getConsoleMethodForLevel = (level) => {
+    // Map log levels to console methods using a functional approach
+    const methodMap = {
+        info: console.info,
+        step: console.info, // Steps are considered informational
+        success: console.log, // Success uses log with green formatting
+        warning: console.warn,
+        error: console.error,
+        debug: console.debug
+    };
+    return methodMap[level] || console.log;
+};
+/** Logs a message to the console using the method corresponding to the log level */
+const logToConsole = async (message, level) => {
+    // Get the appropriate console method for this log level
+    const consoleMethod = getConsoleMethodForLevel(level);
+    // Use asPromise to ensure I/O operations complete before resolving
+    return (0, async_1.asPromise)(() => consoleMethod(message));
+};
+exports.logToConsole = logToConsole;
+//# sourceMappingURL=log-to-console.js.map

package/dist/esm/log/outputs/log-to-console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-to-console.js","sourceRoot":"","sources":["../../../../src/log/outputs/log-to-console.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAG1C,qDAAqD;AACrD,MAAM,wBAAwB,GAAG,CAC/B,KAAe,EACc,EAAE;IAC/B,gEAAgE;IAChE,MAAM,SAAS,GAAgD;QAC7D,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,qCAAqC;QACzD,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,yCAAyC;QAC/D,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAA;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAA;AACxC,CAAC,CAAA;AAED,oFAAoF;AAC7E,MAAM,YAAY,GAAG,KAAK,EAC/B,OAAe,EACf,KAAe,EACA,EAAE;IACjB,wDAAwD;IACxD,MAAM,aAAa,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAA;IAErD,mEAAmE;IACnE,OAAO,IAAA,iBAAS,EAAC,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;AAChD,CAAC,CAAA;AATY,QAAA,YAAY,gBASxB"}

package/dist/esm/log/outputs/log-to-file.d.ts

@@ -0,0 +1,23 @@
+import type { LogLevel, LoggingConfig } from '../types';
+/**
+ * Logs a message to the file system, handling both organized and consolidated logging modes.
+ *
+ * This function manages the complete file logging process:
+ * 1. Prepares the message by stripping ANSI codes
+ * 2. Resolves test context information and adds appropriate headers
+ * 3. Determines the proper file path based on logging configuration
+ *    - For organized logs: Creates test-specific log files in dated folders
+ *    - For consolidated logs: Writes to a single shared log file
+ * 4. Formats and writes the message with proper timestamps and context
+ *
+ * The behavior is controlled by the global logging configuration and per-call options.
+ *
+ * @param message - The message content to log to the file
+ * @param _level - The log level (info, debug, etc.) - reserved for future filtering capabilities
+ * @param options - Configuration options that can override global settings:
+ *                  Can use boolean or detailed object configuration for flexibility
+ * @returns Promise<boolean> - Resolves to true if logging was successful, false otherwise
+ */
+export declare function logToFile(message: string, _level?: LogLevel, // not being used at the moment, but for consistent api with console and future proofing
+options?: LoggingConfig): Promise<boolean>;
+//# sourceMappingURL=log-to-file.d.ts.map

package/dist/esm/log/outputs/log-to-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-to-file.d.ts","sourceRoot":"","sources":["../../../../src/log/outputs/log-to-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AA8InE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,QAAiB,EAAE,wFAAwF;AACnH,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAoClB"}