@theunwalked/cardigantime 0.0.7 → 0.0.9

package/dist/cardigantime.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cardigantime.cjs","sources":["../src/error/ArgumentError.ts","../src/configure.ts","../src/constants.ts","../src/error/FileSystemError.ts","../src/util/storage.ts","../src/util/hierarchical.ts","../src/read.ts","../src/error/ConfigurationError.ts","../src/types.ts","../src/validate.ts","../src/cardigantime.ts"],"sourcesContent":["/**\n * Error thrown when CLI arguments or function parameters are invalid.\n * \n * This error provides specific context about which argument failed validation\n * and why, making it easier for users to fix their command-line usage or\n * for developers to debug parameter issues.\n * \n * @example\n * ```typescript\n * throw new ArgumentError('config-directory', 'Path cannot be empty');\n * // Error message: \"Path cannot be empty\"\n * // error.argument: \"config-directory\"\n * ```\n */\nexport class ArgumentError extends Error {\n    /** The name of the argument that caused the error */\n    private argumentName: string;\n\n    /**\n     * Creates a new ArgumentError instance.\n     * \n     * @param argumentName - The name of the invalid argument\n     * @param message - Description of why the argument is invalid\n     */\n    constructor(argumentName: string, message: string) {\n        super(`${message}`);\n        this.name = 'ArgumentError';\n        this.argumentName = argumentName;\n    }\n\n    /**\n     * Gets the name of the argument that caused this error.\n     * \n     * @returns The argument name\n     */\n    get argument(): string {\n        return this.argumentName;\n    }\n}","import { Command } from \"commander\";\nimport { z } from \"zod\";\nimport { ArgumentError } from \"./error/ArgumentError\";\nimport { Options } from \"./types\";\nexport { ArgumentError };\n\n/**\n * Validates a configuration directory path to ensure it's safe and valid.\n * \n * Performs security and safety checks including:\n * - Non-empty string validation\n * - Null byte injection prevention\n * - Path length validation\n * - Type checking\n * \n * @param configDirectory - The configuration directory path to validate\n * @param _testThrowNonArgumentError - Internal testing parameter to simulate non-ArgumentError exceptions\n * @returns The trimmed and validated configuration directory path\n * @throws {ArgumentError} When the directory path is invalid\n * \n * @example\n * ```typescript\n * const validDir = validateConfigDirectory('./config'); // Returns './config'\n * const invalidDir = validateConfigDirectory(''); // Throws ArgumentError\n * ```\n */\nexport function validateConfigDirectory(configDirectory: string, _testThrowNonArgumentError?: boolean): string {\n    if (_testThrowNonArgumentError) {\n        throw new Error('Test non-ArgumentError for coverage');\n    }\n\n    if (!configDirectory) {\n        throw new ArgumentError('configDirectory', 'Configuration directory cannot be empty');\n    }\n\n    if (typeof configDirectory !== 'string') {\n        throw new ArgumentError('configDirectory', 'Configuration directory must be a string');\n    }\n\n    const trimmed = configDirectory.trim();\n    if (trimmed.length === 0) {\n        throw new ArgumentError('configDirectory', 'Configuration directory cannot be empty or whitespace only');\n    }\n\n    // Check for obviously invalid paths\n    if (trimmed.includes('\\0')) {\n        throw new ArgumentError('configDirectory', 'Configuration directory contains invalid null character');\n    }\n\n    // Validate path length (reasonable limit)\n    if (trimmed.length > 1000) {\n        throw new ArgumentError('configDirectory', 'Configuration directory path is too long (max 1000 characters)');\n    }\n\n    return trimmed;\n}\n\n/**\n * Configures a Commander.js command with Cardigantime's CLI options.\n * \n * This function adds command-line options that allow users to override\n * configuration settings at runtime, such as:\n * - --config-directory: Override the default configuration directory\n * \n * The function validates both the command object and the options to ensure\n * they meet the requirements for proper integration.\n * \n * @template T - The Zod schema shape type for configuration validation\n * @param command - The Commander.js Command instance to configure\n * @param options - Cardigantime options containing defaults and schema\n * @param _testThrowNonArgumentError - Internal testing parameter\n * @returns Promise resolving to the configured Command instance\n * @throws {ArgumentError} When command or options are invalid\n * \n * @example\n * ```typescript\n * import { Command } from 'commander';\n * import { configure } from './configure';\n * \n * const program = new Command();\n * const configuredProgram = await configure(program, options);\n * \n * // Now the program accepts: --config-directory <path>\n * ```\n */\nexport const configure = async <T extends z.ZodRawShape>(\n    command: Command,\n    options: Options<T>,\n    _testThrowNonArgumentError?: boolean\n): Promise<Command> => {\n    // Validate the command object\n    if (!command) {\n        throw new ArgumentError('command', 'Command instance is required');\n    }\n\n    if (typeof command.option !== 'function') {\n        throw new ArgumentError('command', 'Command must be a valid Commander.js Command instance');\n    }\n\n    // Validate options\n    if (!options) {\n        throw new ArgumentError('options', 'Options object is required');\n    }\n\n    if (!options.defaults) {\n        throw new ArgumentError('options.defaults', 'Options must include defaults configuration');\n    }\n\n    if (!options.defaults.configDirectory) {\n        throw new ArgumentError('options.defaults.configDirectory', 'Default config directory is required');\n    }\n\n    // Validate the default config directory\n    const validatedDefaultDir = validateConfigDirectory(options.defaults.configDirectory, _testThrowNonArgumentError);\n\n    let retCommand = command;\n\n    // Add the config directory option with validation\n    retCommand = retCommand.option(\n        '-c, --config-directory <configDirectory>',\n        'Configuration directory path',\n        (value: string) => {\n            try {\n                return validateConfigDirectory(value, _testThrowNonArgumentError);\n            } catch (error) {\n                if (error instanceof ArgumentError) {\n                    // Re-throw with more specific context for CLI usage\n                    throw new ArgumentError('config-directory', `Invalid --config-directory: ${error.message}`);\n                }\n                throw error;\n            }\n        },\n        validatedDefaultDir\n    );\n\n    return retCommand;\n}\n\n\n\n\n","import { DefaultOptions, Feature, Logger } from \"./types\";\n\n/** Version string populated at build time with git and system information */\nexport const VERSION = '__VERSION__ (__GIT_BRANCH__/__GIT_COMMIT__ __GIT_TAGS__ __GIT_COMMIT_DATE__) __SYSTEM_INFO__';\n\n/** The program name used in CLI help and error messages */\nexport const PROGRAM_NAME = 'cardigantime';\n\n/** Default file encoding for reading configuration files */\nexport const DEFAULT_ENCODING = 'utf8';\n\n/** Default configuration file name to look for in the config directory */\nexport const DEFAULT_CONFIG_FILE = 'config.yaml';\n\n/**\n * Default configuration options applied when creating a Cardigantime instance.\n * These provide sensible defaults that work for most use cases.\n */\nexport const DEFAULT_OPTIONS: Partial<DefaultOptions> = {\n    configFile: DEFAULT_CONFIG_FILE,\n    isRequired: false,\n    encoding: DEFAULT_ENCODING,\n}\n\n/**\n * Default features enabled when creating a Cardigantime instance.\n * Currently includes only the 'config' feature for configuration file support.\n */\nexport const DEFAULT_FEATURES: Feature[] = ['config'];\n\n/**\n * Default logger implementation using console methods.\n * Provides basic logging functionality when no custom logger is specified.\n * The verbose and silly methods are no-ops to avoid excessive output.\n */\nexport const DEFAULT_LOGGER: Logger = {\n    // eslint-disable-next-line no-console\n    debug: console.debug,\n    // eslint-disable-next-line no-console\n    info: console.info,\n    // eslint-disable-next-line no-console\n    warn: console.warn,\n    // eslint-disable-next-line no-console\n    error: console.error,\n\n    verbose: () => { },\n\n    silly: () => { },\n}\n","/**\n * Error thrown when file system operations fail\n */\nexport class FileSystemError extends Error {\n    public readonly errorType: 'not_found' | 'not_readable' | 'not_writable' | 'creation_failed' | 'operation_failed';\n    public readonly path: string;\n    public readonly operation: string;\n    public readonly originalError?: Error;\n\n    constructor(\n        errorType: 'not_found' | 'not_readable' | 'not_writable' | 'creation_failed' | 'operation_failed',\n        message: string,\n        path: string,\n        operation: string,\n        originalError?: Error\n    ) {\n        super(message);\n        this.name = 'FileSystemError';\n        this.errorType = errorType;\n        this.path = path;\n        this.operation = operation;\n        this.originalError = originalError;\n    }\n\n    /**\n     * Creates an error for when a required directory doesn't exist\n     */\n    static directoryNotFound(path: string, isRequired: boolean = false): FileSystemError {\n        const message = isRequired\n            ? 'Configuration directory does not exist and is required'\n            : 'Configuration directory not found';\n        return new FileSystemError('not_found', message, path, 'directory_access');\n    }\n\n    /**\n     * Creates an error for when a directory exists but isn't readable\n     */\n    static directoryNotReadable(path: string): FileSystemError {\n        const message = 'Configuration directory exists but is not readable';\n        return new FileSystemError('not_readable', message, path, 'directory_read');\n    }\n\n    /**\n     * Creates an error for directory creation failures\n     */\n    static directoryCreationFailed(path: string, originalError: Error): FileSystemError {\n        const message = 'Failed to create directory: ' + (originalError.message || 'Unknown error');\n        return new FileSystemError('creation_failed', message, path, 'directory_create', originalError);\n    }\n\n    /**\n     * Creates an error for file operation failures (glob, etc.)\n     */\n    static operationFailed(operation: string, path: string, originalError: Error): FileSystemError {\n        const message = `Failed to ${operation}: ${originalError.message || 'Unknown error'}`;\n        return new FileSystemError('operation_failed', message, path, operation, originalError);\n    }\n\n    /**\n     * Creates an error for when a file is not found\n     */\n    static fileNotFound(path: string): FileSystemError {\n        const message = 'Configuration file not found';\n        return new FileSystemError('not_found', message, path, 'file_read');\n    }\n} ","// eslint-disable-next-line no-restricted-imports\nimport * as fs from 'fs';\nimport { glob } from 'glob';\nimport path from 'path';\nimport crypto from 'crypto';\nimport { FileSystemError } from '../error/FileSystemError';\n/**\n * This module exists to isolate filesystem operations from the rest of the codebase.\n * This makes testing easier by avoiding direct fs mocking in jest configuration.\n * \n * Additionally, abstracting storage operations allows for future flexibility - \n * this export utility may need to work with storage systems other than the local filesystem\n * (e.g. S3, Google Cloud Storage, etc).\n */\n\nexport interface Utility {\n    exists: (path: string) => Promise<boolean>;\n    isDirectory: (path: string) => Promise<boolean>;\n    isFile: (path: string) => Promise<boolean>;\n    isReadable: (path: string) => Promise<boolean>;\n    isWritable: (path: string) => Promise<boolean>;\n    isFileReadable: (path: string) => Promise<boolean>;\n    isDirectoryWritable: (path: string) => Promise<boolean>;\n    isDirectoryReadable: (path: string) => Promise<boolean>;\n    createDirectory: (path: string) => Promise<void>;\n    readFile: (path: string, encoding: string) => Promise<string>;\n    readStream: (path: string) => Promise<fs.ReadStream>;\n    writeFile: (path: string, data: string | Buffer, encoding: string) => Promise<void>;\n    forEachFileIn: (directory: string, callback: (path: string) => Promise<void>, options?: { pattern: string }) => Promise<void>;\n    hashFile: (path: string, length: number) => Promise<string>;\n    listFiles: (directory: string) => Promise<string[]>;\n}\n\nexport const create = (params: { log?: (message: string, ...args: any[]) => void }): Utility => {\n\n    // eslint-disable-next-line no-console\n    const log = params.log || console.log;\n\n    const exists = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.stat(path);\n            return true;\n            // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        } catch (error: any) {\n            return false;\n        }\n    }\n\n    const isDirectory = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isDirectory()) {\n            log(`${path} is not a directory`);\n            return false;\n        }\n        return true;\n    }\n\n    const isFile = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isFile()) {\n            log(`${path} is not a file`);\n            return false;\n        }\n        return true;\n    }\n\n    const isReadable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.R_OK);\n        } catch (error: any) {\n            log(`${path} is not readable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isWritable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.W_OK);\n        } catch (error: any) {\n            log(`${path} is not writable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isFileReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isFile(path) && await isReadable(path);\n    }\n\n    const isDirectoryWritable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isWritable(path);\n    }\n\n    const isDirectoryReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isReadable(path);\n    }\n\n    const createDirectory = async (path: string): Promise<void> => {\n        try {\n            await fs.promises.mkdir(path, { recursive: true });\n        } catch (mkdirError: any) {\n            throw FileSystemError.directoryCreationFailed(path, mkdirError);\n        }\n    }\n\n    const readFile = async (path: string, encoding: string): Promise<string> => {\n        // Validate encoding parameter\n        const validEncodings = ['utf8', 'utf-8', 'ascii', 'latin1', 'base64', 'hex', 'utf16le', 'ucs2', 'ucs-2'];\n        if (!validEncodings.includes(encoding.toLowerCase())) {\n            throw new Error('Invalid encoding specified');\n        }\n\n        // Check file size before reading to prevent DoS\n        try {\n            const stats = await fs.promises.stat(path);\n            const maxFileSize = 10 * 1024 * 1024; // 10MB limit\n            if (stats.size > maxFileSize) {\n                throw new Error('File too large to process');\n            }\n        } catch (error: any) {\n            if (error.code === 'ENOENT') {\n                throw FileSystemError.fileNotFound(path);\n            }\n            throw error;\n        }\n\n        return await fs.promises.readFile(path, { encoding: encoding as BufferEncoding });\n    }\n\n    const writeFile = async (path: string, data: string | Buffer, encoding: string): Promise<void> => {\n        await fs.promises.writeFile(path, data, { encoding: encoding as BufferEncoding });\n    }\n\n    const forEachFileIn = async (directory: string, callback: (file: string) => Promise<void>, options: { pattern: string | string[] } = { pattern: '*.*' }): Promise<void> => {\n        try {\n            const files = await glob(options.pattern, { cwd: directory, nodir: true });\n            for (const file of files) {\n                await callback(path.join(directory, file));\n            }\n        } catch (err: any) {\n            throw FileSystemError.operationFailed(`glob pattern ${options.pattern}`, directory, err);\n        }\n    }\n\n    const readStream = async (path: string): Promise<fs.ReadStream> => {\n        return fs.createReadStream(path);\n    }\n\n    const hashFile = async (path: string, length: number): Promise<string> => {\n        const file = await readFile(path, 'utf8');\n        return crypto.createHash('sha256').update(file).digest('hex').slice(0, length);\n    }\n\n    const listFiles = async (directory: string): Promise<string[]> => {\n        return await fs.promises.readdir(directory);\n    }\n\n    return {\n        exists,\n        isDirectory,\n        isFile,\n        isReadable,\n        isWritable,\n        isFileReadable,\n        isDirectoryWritable,\n        isDirectoryReadable,\n        createDirectory,\n        readFile,\n        readStream,\n        writeFile,\n        forEachFileIn,\n        hashFile,\n        listFiles,\n    };\n}","import path from 'path';\nimport * as yaml from 'js-yaml';\nimport { create as createStorage } from './storage';\nimport { Logger } from '../types';\n\n/**\n * Represents a discovered configuration directory with its path and precedence level.\n */\nexport interface DiscoveredConfigDir {\n    /** Absolute path to the configuration directory */\n    path: string;\n    /** Distance from the starting directory (0 = closest/highest precedence) */\n    level: number;\n}\n\n/**\n * Options for hierarchical configuration discovery.\n */\nexport interface HierarchicalDiscoveryOptions {\n    /** Name of the configuration directory to look for (e.g., '.kodrdriv') */\n    configDirName: string;\n    /** Name of the configuration file within each directory */\n    configFileName: string;\n    /** Maximum number of parent directories to traverse (default: 10) */\n    maxLevels?: number;\n    /** Starting directory for discovery (default: process.cwd()) */\n    startingDir?: string;\n    /** File encoding for reading configuration files */\n    encoding?: string;\n    /** Logger for debugging */\n    logger?: Logger;\n}\n\n/**\n * Result of loading configurations from multiple directories.\n */\nexport interface HierarchicalConfigResult {\n    /** Merged configuration object with proper precedence */\n    config: object;\n    /** Array of directories where configuration was found */\n    discoveredDirs: DiscoveredConfigDir[];\n    /** Array of any errors encountered during loading (non-fatal) */\n    errors: string[];\n}\n\n/**\n * Discovers configuration directories by traversing up the directory tree.\n * \n * Starting from the specified directory (or current working directory),\n * this function searches for directories with the given name, continuing\n * up the directory tree until it reaches the filesystem root or the\n * maximum number of levels.\n * \n * @param options Configuration options for discovery\n * @returns Promise resolving to array of discovered configuration directories\n * \n * @example\n * ```typescript\n * const dirs = await discoverConfigDirectories({\n *   configDirName: '.kodrdriv',\n *   configFileName: 'config.yaml',\n *   maxLevels: 5\n * });\n * // Returns: [\n * //   { path: '/project/.kodrdriv', level: 0 },\n * //   { path: '/project/parent/.kodrdriv', level: 1 }\n * // ]\n * ```\n */\nexport async function discoverConfigDirectories(\n    options: HierarchicalDiscoveryOptions\n): Promise<DiscoveredConfigDir[]> {\n    const {\n        configDirName,\n        maxLevels = 10,\n        startingDir = process.cwd(),\n        logger\n    } = options;\n\n    const storage = createStorage({ log: logger?.debug || (() => { }) });\n    const discoveredDirs: DiscoveredConfigDir[] = [];\n\n    let currentDir = path.resolve(startingDir);\n    let level = 0;\n    const visited = new Set<string>(); // Prevent infinite loops with symlinks\n\n    logger?.debug(`Starting hierarchical discovery from: ${currentDir}`);\n\n    while (level < maxLevels) {\n        // Prevent infinite loops with symlinks\n        const realPath = path.resolve(currentDir);\n        if (visited.has(realPath)) {\n            logger?.debug(`Already visited ${realPath}, stopping discovery`);\n            break;\n        }\n        visited.add(realPath);\n\n        const configDirPath = path.join(currentDir, configDirName);\n        logger?.debug(`Checking for config directory: ${configDirPath}`);\n\n        try {\n            const exists = await storage.exists(configDirPath);\n            const isReadable = exists && await storage.isDirectoryReadable(configDirPath);\n\n            if (exists && isReadable) {\n                discoveredDirs.push({\n                    path: configDirPath,\n                    level\n                });\n                logger?.debug(`Found config directory at level ${level}: ${configDirPath}`);\n            } else if (exists && !isReadable) {\n                logger?.debug(`Config directory exists but is not readable: ${configDirPath}`);\n            }\n        } catch (error: any) {\n            logger?.debug(`Error checking config directory ${configDirPath}: ${error.message}`);\n        }\n\n        // Move up one directory level\n        const parentDir = path.dirname(currentDir);\n\n        // Check if we've reached the root directory\n        if (parentDir === currentDir) {\n            logger?.debug('Reached filesystem root, stopping discovery');\n            break;\n        }\n\n        currentDir = parentDir;\n        level++;\n    }\n\n    logger?.verbose(`Discovery complete. Found ${discoveredDirs.length} config directories`);\n    return discoveredDirs;\n}\n\n/**\n * Loads and parses a configuration file from a directory.\n * \n * @param configDir Path to the configuration directory\n * @param configFileName Name of the configuration file\n * @param encoding File encoding\n * @param logger Optional logger\n * @returns Promise resolving to parsed configuration object or null if not found\n */\nexport async function loadConfigFromDirectory(\n    configDir: string,\n    configFileName: string,\n    encoding: string = 'utf8',\n    logger?: Logger\n): Promise<object | null> {\n    const storage = createStorage({ log: logger?.debug || (() => { }) });\n    const configFilePath = path.join(configDir, configFileName);\n\n    try {\n        logger?.verbose(`Attempting to load config file: ${configFilePath}`);\n\n        const exists = await storage.exists(configFilePath);\n        if (!exists) {\n            logger?.debug(`Config file does not exist: ${configFilePath}`);\n            return null;\n        }\n\n        const isReadable = await storage.isFileReadable(configFilePath);\n        if (!isReadable) {\n            logger?.debug(`Config file exists but is not readable: ${configFilePath}`);\n            return null;\n        }\n\n        const yamlContent = await storage.readFile(configFilePath, encoding);\n        const parsedYaml = yaml.load(yamlContent);\n\n        if (parsedYaml !== null && typeof parsedYaml === 'object') {\n            logger?.verbose(`Successfully loaded config from: ${configFilePath}`);\n            return parsedYaml as object;\n        } else {\n            logger?.debug(`Config file contains invalid format: ${configFilePath}`);\n            return null;\n        }\n    } catch (error: any) {\n        logger?.debug(`Error loading config from ${configFilePath}: ${error.message}`);\n        return null;\n    }\n}\n\n/**\n * Deep merges multiple configuration objects with proper precedence.\n * \n * Objects are merged from lowest precedence to highest precedence,\n * meaning that properties in later objects override properties in earlier objects.\n * Arrays are replaced entirely (not merged).\n * \n * @param configs Array of configuration objects, ordered from lowest to highest precedence\n * @returns Merged configuration object\n * \n * @example\n * ```typescript\n * const merged = deepMergeConfigs([\n *   { api: { timeout: 5000 }, debug: true },        // Lower precedence\n *   { api: { retries: 3 }, features: ['auth'] },    // Higher precedence\n * ]);\n * // Result: { api: { timeout: 5000, retries: 3 }, debug: true, features: ['auth'] }\n * ```\n */\nexport function deepMergeConfigs(configs: object[]): object {\n    if (configs.length === 0) {\n        return {};\n    }\n\n    if (configs.length === 1) {\n        return { ...configs[0] };\n    }\n\n    return configs.reduce((merged, current) => {\n        return deepMergeTwo(merged, current);\n    }, {});\n}\n\n/**\n * Deep merges two objects with proper precedence.\n * \n * @param target Target object (lower precedence)\n * @param source Source object (higher precedence)\n * @returns Merged object\n */\nfunction deepMergeTwo(target: any, source: any): any {\n    // Handle null/undefined\n    if (source == null) return target;\n    if (target == null) return source;\n\n    // Handle non-objects (primitives, arrays, functions, etc.)\n    if (typeof source !== 'object' || typeof target !== 'object') {\n        return source; // Source takes precedence\n    }\n\n    // Handle arrays - replace entirely, don't merge\n    if (Array.isArray(source)) {\n        return [...source];\n    }\n\n    if (Array.isArray(target)) {\n        return source; // Source object replaces target array\n    }\n\n    // Deep merge objects\n    const result = { ...target };\n\n    for (const key in source) {\n        if (Object.prototype.hasOwnProperty.call(source, key)) {\n            if (Object.prototype.hasOwnProperty.call(result, key) &&\n                typeof result[key] === 'object' &&\n                typeof source[key] === 'object' &&\n                !Array.isArray(source[key]) &&\n                !Array.isArray(result[key])) {\n                // Recursively merge nested objects\n                result[key] = deepMergeTwo(result[key], source[key]);\n            } else {\n                // Replace with source value (higher precedence)\n                result[key] = source[key];\n            }\n        }\n    }\n\n    return result;\n}\n\n/**\n * Loads configurations from multiple directories and merges them with proper precedence.\n * \n * This is the main function for hierarchical configuration loading. It:\n * 1. Discovers configuration directories up the directory tree\n * 2. Loads configuration files from each discovered directory\n * 3. Merges them with proper precedence (closer directories win)\n * 4. Returns the merged configuration with metadata\n * \n * @param options Configuration options for hierarchical loading\n * @returns Promise resolving to hierarchical configuration result\n * \n * @example\n * ```typescript\n * const result = await loadHierarchicalConfig({\n *   configDirName: '.kodrdriv',\n *   configFileName: 'config.yaml',\n *   startingDir: '/project/subdir',\n *   maxLevels: 5\n * });\n * \n * // result.config contains merged configuration\n * // result.discoveredDirs shows where configs were found\n * // result.errors contains any non-fatal errors\n * ```\n */\nexport async function loadHierarchicalConfig(\n    options: HierarchicalDiscoveryOptions\n): Promise<HierarchicalConfigResult> {\n    const { configFileName, encoding = 'utf8', logger } = options;\n\n    logger?.verbose('Starting hierarchical configuration loading');\n\n    // Discover all configuration directories\n    const discoveredDirs = await discoverConfigDirectories(options);\n\n    if (discoveredDirs.length === 0) {\n        logger?.verbose('No configuration directories found');\n        return {\n            config: {},\n            discoveredDirs: [],\n            errors: []\n        };\n    }\n\n    // Load configurations from each directory\n    const configs: object[] = [];\n    const errors: string[] = [];\n\n    // Sort by level (highest level first = lowest precedence first)\n    const sortedDirs = [...discoveredDirs].sort((a, b) => b.level - a.level);\n\n    for (const dir of sortedDirs) {\n        try {\n            const config = await loadConfigFromDirectory(\n                dir.path,\n                configFileName,\n                encoding,\n                logger\n            );\n\n            if (config !== null) {\n                configs.push(config);\n                logger?.debug(`Loaded config from level ${dir.level}: ${dir.path}`);\n            } else {\n                logger?.debug(`No valid config found at level ${dir.level}: ${dir.path}`);\n            }\n        } catch (error: any) {\n            const errorMsg = `Failed to load config from ${dir.path}: ${error.message}`;\n            errors.push(errorMsg);\n            logger?.debug(errorMsg);\n        }\n    }\n\n    // Merge all configurations with proper precedence\n    const mergedConfig = deepMergeConfigs(configs);\n\n    logger?.verbose(`Hierarchical loading complete. Merged ${configs.length} configurations`);\n\n    return {\n        config: mergedConfig,\n        discoveredDirs,\n        errors\n    };\n} ","import * as yaml from 'js-yaml';\nimport * as path from 'path';\nimport { z, ZodObject } from 'zod';\nimport { Args, ConfigSchema, Options } from './types';\nimport * as Storage from './util/storage';\nimport { loadHierarchicalConfig } from './util/hierarchical';\n\n/**\n * Removes undefined values from an object to create a clean configuration.\n * This is used to merge configuration sources while avoiding undefined pollution.\n * \n * @param obj - The object to clean\n * @returns A new object with undefined values filtered out\n */\nfunction clean(obj: any) {\n    return Object.fromEntries(\n        Object.entries(obj).filter(([_, v]) => v !== undefined)\n    );\n}\n\n/**\n * Validates and secures a user-provided path to prevent path traversal attacks.\n * \n * Security checks include:\n * - Path traversal prevention (blocks '..')\n * - Absolute path detection\n * - Path separator validation\n * \n * @param userPath - The user-provided path component\n * @param basePath - The base directory to join the path with\n * @returns The safely joined and normalized path\n * @throws {Error} When path traversal or absolute paths are detected\n */\nfunction validatePath(userPath: string, basePath: string): string {\n    if (!userPath || !basePath) {\n        throw new Error('Invalid path parameters');\n    }\n\n    const normalized = path.normalize(userPath);\n\n    // Prevent path traversal attacks\n    if (normalized.includes('..') || path.isAbsolute(normalized)) {\n        throw new Error('Invalid path: path traversal detected');\n    }\n\n    // Ensure the path doesn't start with a path separator\n    if (normalized.startsWith('/') || normalized.startsWith('\\\\')) {\n        throw new Error('Invalid path: absolute path detected');\n    }\n\n    return path.join(basePath, normalized);\n}\n\n/**\n * Validates a configuration directory path for security and basic formatting.\n * \n * Performs validation to prevent:\n * - Null byte injection attacks\n * - Extremely long paths that could cause DoS\n * - Empty or invalid directory specifications\n * \n * @param configDir - The configuration directory path to validate\n * @returns The normalized configuration directory path\n * @throws {Error} When the directory path is invalid or potentially dangerous\n */\nfunction validateConfigDirectory(configDir: string): string {\n    if (!configDir) {\n        throw new Error('Configuration directory is required');\n    }\n\n    // Check for null bytes which could be used for path injection\n    if (configDir.includes('\\0')) {\n        throw new Error('Invalid path: null byte detected');\n    }\n\n    const normalized = path.normalize(configDir);\n\n    // Basic validation - could be expanded based on requirements\n    if (normalized.length > 1000) {\n        throw new Error('Configuration directory path too long');\n    }\n\n    return normalized;\n}\n\n/**\n * Reads configuration from files and merges it with CLI arguments.\n * \n * This function implements the core configuration loading logic:\n * 1. Validates and resolves the configuration directory path\n * 2. Attempts to read the YAML configuration file\n * 3. Safely parses the YAML content with security protections\n * 4. Merges file configuration with runtime arguments\n * 5. Returns a typed configuration object\n * \n * The function handles missing files gracefully and provides detailed\n * logging for troubleshooting configuration issues.\n * \n * @template T - The Zod schema shape type for configuration validation\n * @param args - Parsed command-line arguments containing potential config overrides\n * @param options - Cardigantime options with defaults, schema, and logger\n * @returns Promise resolving to the merged and typed configuration object\n * @throws {Error} When configuration directory is invalid or required files cannot be read\n * \n * @example\n * ```typescript\n * const config = await read(cliArgs, {\n *   defaults: { configDirectory: './config', configFile: 'app.yaml' },\n *   configShape: MySchema.shape,\n *   logger: console,\n *   features: ['config']\n * });\n * // config is fully typed based on your schema\n * ```\n */\nexport const read = async <T extends z.ZodRawShape>(args: Args, options: Options<T>): Promise<z.infer<ZodObject<T & typeof ConfigSchema.shape>>> => {\n    const logger = options.logger;\n\n    const rawConfigDir = args.configDirectory || options.defaults?.configDirectory;\n    if (!rawConfigDir) {\n        throw new Error('Configuration directory must be specified');\n    }\n\n    const resolvedConfigDir = validateConfigDirectory(rawConfigDir);\n    logger.verbose('Resolved config directory');\n\n    let rawFileConfig: object = {};\n\n    // Check if hierarchical configuration discovery is enabled\n    if (options.features.includes('hierarchical')) {\n        logger.verbose('Hierarchical configuration discovery enabled');\n\n        try {\n            // Extract the config directory name from the path for hierarchical discovery\n            const configDirName = path.basename(resolvedConfigDir);\n            const startingDir = path.dirname(resolvedConfigDir);\n\n            logger.debug(`Using hierarchical discovery: configDirName=${configDirName}, startingDir=${startingDir}`);\n\n            const hierarchicalResult = await loadHierarchicalConfig({\n                configDirName,\n                configFileName: options.defaults.configFile,\n                startingDir,\n                encoding: options.defaults.encoding,\n                logger\n            });\n\n            rawFileConfig = hierarchicalResult.config;\n\n            if (hierarchicalResult.discoveredDirs.length > 0) {\n                logger.verbose(`Hierarchical discovery found ${hierarchicalResult.discoveredDirs.length} configuration directories`);\n                hierarchicalResult.discoveredDirs.forEach(dir => {\n                    logger.debug(`  Level ${dir.level}: ${dir.path}`);\n                });\n            } else {\n                logger.verbose('No configuration directories found in hierarchy');\n            }\n\n            if (hierarchicalResult.errors.length > 0) {\n                hierarchicalResult.errors.forEach(error => logger.warn(`Hierarchical config warning: ${error}`));\n            }\n\n        } catch (error: any) {\n            logger.error('Hierarchical configuration loading failed: ' + (error.message || 'Unknown error'));\n            // Fall back to single directory mode\n            logger.verbose('Falling back to single directory configuration loading');\n            rawFileConfig = await loadSingleDirectoryConfig(resolvedConfigDir, options, logger);\n        }\n    } else {\n        // Use traditional single directory configuration loading\n        logger.verbose('Using single directory configuration loading');\n        rawFileConfig = await loadSingleDirectoryConfig(resolvedConfigDir, options, logger);\n    }\n\n    const config: z.infer<ZodObject<T & typeof ConfigSchema.shape>> = clean({\n        ...rawFileConfig,\n        ...{\n            configDirectory: resolvedConfigDir,\n        }\n    }) as z.infer<ZodObject<T & typeof ConfigSchema.shape>>;\n\n    return config;\n}\n\n/**\n * Loads configuration from a single directory (traditional mode).\n * \n * @param resolvedConfigDir - The resolved configuration directory path\n * @param options - Cardigantime options\n * @param logger - Logger instance\n * @returns Promise resolving to the configuration object\n */\nasync function loadSingleDirectoryConfig<T extends z.ZodRawShape>(\n    resolvedConfigDir: string,\n    options: Options<T>,\n    logger: any\n): Promise<object> {\n    const storage = Storage.create({ log: logger.debug });\n    const configFile = validatePath(options.defaults.configFile, resolvedConfigDir);\n    logger.verbose('Attempting to load config file for cardigantime');\n\n    let rawFileConfig: object = {};\n\n    try {\n        const yamlContent = await storage.readFile(configFile, options.defaults.encoding);\n\n        // SECURITY FIX: Use safer parsing options to prevent code execution vulnerabilities\n        const parsedYaml = yaml.load(yamlContent);\n\n        if (parsedYaml !== null && typeof parsedYaml === 'object') {\n            rawFileConfig = parsedYaml;\n            logger.verbose('Loaded configuration file successfully');\n        } else if (parsedYaml !== null) {\n            logger.warn('Ignoring invalid configuration format. Expected an object, got ' + typeof parsedYaml);\n        }\n    } catch (error: any) {\n        if (error.code === 'ENOENT' || /not found|no such file/i.test(error.message)) {\n            logger.verbose('Configuration file not found. Using empty configuration.');\n        } else {\n            // SECURITY FIX: Don't expose internal paths or detailed error information\n            logger.error('Failed to load or parse configuration file: ' + (error.message || 'Unknown error'));\n        }\n    }\n\n    return rawFileConfig;\n}","/**\n * Error thrown when configuration validation fails\n */\nexport class ConfigurationError extends Error {\n    public readonly errorType: 'validation' | 'schema' | 'extra_keys';\n    public readonly details?: any;\n    public readonly configPath?: string;\n\n    constructor(\n        errorType: 'validation' | 'schema' | 'extra_keys',\n        message: string,\n        details?: any,\n        configPath?: string\n    ) {\n        super(message);\n        this.name = 'ConfigurationError';\n        this.errorType = errorType;\n        this.details = details;\n        this.configPath = configPath;\n    }\n\n    /**\n     * Creates a validation error for when config doesn't match the schema\n     */\n    static validation(message: string, zodError?: any, configPath?: string): ConfigurationError {\n        return new ConfigurationError('validation', message, zodError, configPath);\n    }\n\n    /**\n     * Creates an error for when extra/unknown keys are found\n     */\n    static extraKeys(extraKeys: string[], allowedKeys: string[], configPath?: string): ConfigurationError {\n        const message = `Unknown configuration keys found: ${extraKeys.join(', ')}. Allowed keys are: ${allowedKeys.join(', ')}`;\n        return new ConfigurationError('extra_keys', message, { extraKeys, allowedKeys }, configPath);\n    }\n\n    /**\n     * Creates a schema error for when the configuration schema itself is invalid\n     */\n    static schema(message: string, details?: any): ConfigurationError {\n        return new ConfigurationError('schema', message, details);\n    }\n} ","import { Command } from \"commander\";\nimport { ZodObject } from \"zod\";\n\nimport { z } from \"zod\";\n\n/**\n * Available features that can be enabled in Cardigantime.\n * Currently supports:\n * - 'config': Configuration file reading and validation\n * - 'hierarchical': Hierarchical configuration discovery and layering\n */\nexport type Feature = 'config' | 'hierarchical';\n\n/**\n * Default configuration options for Cardigantime.\n * These define the basic behavior of configuration loading.\n */\nexport interface DefaultOptions {\n    /** Directory path where configuration files are located */\n    configDirectory: string;\n    /** Name of the configuration file (e.g., 'config.yaml', 'app.yml') */\n    configFile: string;\n    /** Whether the configuration directory must exist. If true, throws error if directory doesn't exist */\n    isRequired: boolean;\n    /** File encoding for reading configuration files (e.g., 'utf8', 'ascii') */\n    encoding: string;\n}\n\n/**\n * Complete options object passed to Cardigantime functions.\n * Combines defaults, features, schema shape, and logger.\n * \n * @template T - The Zod schema shape type for configuration validation\n */\nexport interface Options<T extends z.ZodRawShape> {\n    /** Default configuration options */\n    defaults: DefaultOptions,\n    /** Array of enabled features */\n    features: Feature[],\n    /** Zod schema shape for validating user configuration */\n    configShape: T;\n    /** Logger instance for debugging and error reporting */\n    logger: Logger;\n}\n\n/**\n * Logger interface for Cardigantime's internal logging.\n * Compatible with popular logging libraries like Winston, Bunyan, etc.\n */\nexport interface Logger {\n    /** Debug-level logging for detailed troubleshooting information */\n    debug: (message: string, ...args: any[]) => void;\n    /** Info-level logging for general information */\n    info: (message: string, ...args: any[]) => void;\n    /** Warning-level logging for non-critical issues */\n    warn: (message: string, ...args: any[]) => void;\n    /** Error-level logging for critical problems */\n    error: (message: string, ...args: any[]) => void;\n    /** Verbose-level logging for extensive detail */\n    verbose: (message: string, ...args: any[]) => void;\n    /** Silly-level logging for maximum detail */\n    silly: (message: string, ...args: any[]) => void;\n}\n\n/**\n * Main Cardigantime interface providing configuration management functionality.\n * \n * @template T - The Zod schema shape type for configuration validation\n */\nexport interface Cardigantime<T extends z.ZodRawShape> {\n    /** \n     * Adds Cardigantime's CLI options to a Commander.js command.\n     * This includes options like --config-directory for runtime config path overrides.\n     */\n    configure: (command: Command) => Promise<Command>;\n    /** Sets a custom logger for debugging and error reporting */\n    setLogger: (logger: Logger) => void;\n    /** \n     * Reads configuration from files and merges with CLI arguments.\n     * Returns a fully typed configuration object.\n     */\n    read: (args: Args) => Promise<z.infer<ZodObject<T & typeof ConfigSchema.shape>>>;\n    /** \n     * Validates the merged configuration against the Zod schema.\n     * Throws ConfigurationError if validation fails.\n     */\n    validate: (config: z.infer<ZodObject<T & typeof ConfigSchema.shape>>) => Promise<void>;\n}\n\n/**\n * Parsed command-line arguments object, typically from Commander.js opts().\n * Keys correspond to CLI option names with values from user input.\n */\nexport interface Args {\n    [key: string]: any;\n}\n\n/**\n * Base Zod schema for core Cardigantime configuration.\n * Contains the minimum required configuration fields.\n */\nexport const ConfigSchema = z.object({\n    /** The resolved configuration directory path */\n    configDirectory: z.string(),\n});\n\n/**\n * Base configuration type derived from the core schema.\n */\nexport type Config = z.infer<typeof ConfigSchema>;\n","import { z, ZodObject } from \"zod\";\nimport { ArgumentError } from \"./error/ArgumentError\";\nimport { ConfigurationError } from \"./error/ConfigurationError\";\nimport { FileSystemError } from \"./error/FileSystemError\";\nimport { ConfigSchema, Logger, Options } from \"./types\";\nimport * as Storage from \"./util/storage\";\nexport { ArgumentError, ConfigurationError, FileSystemError };\n\n/**\n * Recursively extracts all keys from a Zod schema in dot notation.\n * \n * This function traverses a Zod schema structure and builds a flat list\n * of all possible keys, using dot notation for nested objects. It handles\n * optional/nullable types by unwrapping them and supports arrays by\n * introspecting their element type.\n * \n * Special handling for:\n * - ZodOptional/ZodNullable: Unwraps to get the underlying type\n * - ZodAny/ZodRecord: Accepts any keys, returns the prefix or empty array\n * - ZodArray: Introspects the element type\n * - ZodObject: Recursively processes all shape properties\n * \n * @param schema - The Zod schema to introspect\n * @param prefix - Internal parameter for building nested key paths\n * @returns Array of strings representing all possible keys in dot notation\n * \n * @example\n * ```typescript\n * const schema = z.object({\n *   user: z.object({\n *     name: z.string(),\n *     settings: z.object({ theme: z.string() })\n *   }),\n *   debug: z.boolean()\n * });\n * \n * const keys = listZodKeys(schema);\n * // Returns: ['user.name', 'user.settings.theme', 'debug']\n * ```\n */\nexport const listZodKeys = (schema: z.ZodTypeAny, prefix = ''): string[] => {\n    // Check if schema has unwrap method (which both ZodOptional and ZodNullable have)\n    if (schema._def && (schema._def.typeName === 'ZodOptional' || schema._def.typeName === 'ZodNullable')) {\n        // Use type assertion to handle the unwrap method\n        const unwrappable = schema as z.ZodOptional<any> | z.ZodNullable<any>;\n        return listZodKeys(unwrappable.unwrap(), prefix);\n    }\n\n    // Handle ZodAny and ZodRecord - these accept any keys, so don't introspect\n    if (schema._def && (schema._def.typeName === 'ZodAny' || schema._def.typeName === 'ZodRecord')) {\n        return prefix ? [prefix] : [];\n    }\n\n    if (schema._def && schema._def.typeName === 'ZodArray') {\n        // Use type assertion to handle the element property\n        const arraySchema = schema as z.ZodArray<any>;\n        return listZodKeys(arraySchema.element, prefix);\n    }\n    if (schema._def && schema._def.typeName === 'ZodObject') {\n        // Use type assertion to handle the shape property\n        const objectSchema = schema as z.ZodObject<any>;\n        return Object.entries(objectSchema.shape).flatMap(([key, subschema]) => {\n            const fullKey = prefix ? `${prefix}.${key}` : key;\n            const nested = listZodKeys(subschema as z.ZodTypeAny, fullKey);\n            return nested.length ? nested : fullKey;\n        });\n    }\n    return [];\n}\n\n/**\n * Type guard to check if a value is a plain object (not array, null, or other types).\n * \n * @param value - The value to check\n * @returns True if the value is a plain object\n */\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n    // Check if it's an object, not null, and not an array.\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n};\n\n/**\n * Generates a list of all keys within a JavaScript object, using dot notation for nested keys.\n * Mimics the behavior of listZodKeys but operates on plain objects.\n * For arrays, it inspects the first element that is a plain object to determine nested keys.\n * If an array contains no plain objects, or is empty, the key for the array itself is listed.\n *\n * @param obj The object to introspect.\n * @param prefix Internal use for recursion: the prefix for the current nesting level.\n * @returns An array of strings representing all keys in dot notation.\n */\nexport const listObjectKeys = (obj: Record<string, unknown>, prefix = ''): string[] => {\n    const keys = new Set<string>(); // Use Set to automatically handle duplicates from array recursion\n\n    for (const key in obj) {\n        // Ensure it's an own property, not from the prototype chain\n        if (Object.prototype.hasOwnProperty.call(obj, key)) {\n            const value = obj[key];\n            const fullKey = prefix ? `${prefix}.${key}` : key;\n\n            if (Array.isArray(value)) {\n                // Find the first element that is a plain object to determine structure\n                const firstObjectElement = value.find(isPlainObject);\n                if (firstObjectElement) {\n                    // Recurse into the structure of the first object element found\n                    const nestedKeys = listObjectKeys(firstObjectElement, fullKey);\n                    nestedKeys.forEach(k => keys.add(k));\n                } else {\n                    // Array is empty or contains no plain objects, list the array key itself\n                    keys.add(fullKey);\n                }\n            } else if (isPlainObject(value)) {\n                // Recurse into nested plain objects\n                const nestedKeys = listObjectKeys(value, fullKey);\n                nestedKeys.forEach(k => keys.add(k));\n            } else {\n                // It's a primitive, null, or other non-plain object/array type\n                keys.add(fullKey);\n            }\n        }\n    }\n    return Array.from(keys); // Convert Set back to Array\n};\n\n/**\n * Validates that the configuration object contains only keys allowed by the schema.\n * \n * This function prevents configuration errors by detecting typos or extra keys\n * that aren't defined in the Zod schema. It intelligently handles:\n * - ZodRecord types that accept arbitrary keys\n * - Nested objects and their key structures\n * - Arrays and their element key structures\n * \n * The function throws a ConfigurationError if extra keys are found, providing\n * helpful information about what keys are allowed vs. what was found.\n * \n * @param mergedSources - The merged configuration object to validate\n * @param fullSchema - The complete Zod schema including base and user schemas\n * @param logger - Logger for error reporting\n * @throws {ConfigurationError} When extra keys are found that aren't in the schema\n * \n * @example\n * ```typescript\n * const schema = z.object({ name: z.string(), age: z.number() });\n * const config = { name: 'John', age: 30, typo: 'invalid' };\n * \n * checkForExtraKeys(config, schema, console);\n * // Throws: ConfigurationError with details about 'typo' being an extra key\n * ```\n */\nexport const checkForExtraKeys = (mergedSources: object, fullSchema: ZodObject<any>, logger: Logger | typeof console): void => {\n    const allowedKeys = new Set(listZodKeys(fullSchema));\n    const actualKeys = listObjectKeys(mergedSources as Record<string, unknown>);\n\n    // Filter out keys that are under a record type (ZodRecord accepts any keys)\n    const recordPrefixes = new Set<string>();\n\n    // Find all prefixes that are ZodRecord types\n    const findRecordPrefixes = (schema: z.ZodTypeAny, prefix = ''): void => {\n        if (schema._def && (schema._def.typeName === 'ZodOptional' || schema._def.typeName === 'ZodNullable')) {\n            const unwrappable = schema as z.ZodOptional<any> | z.ZodNullable<any>;\n            findRecordPrefixes(unwrappable.unwrap(), prefix);\n            return;\n        }\n\n        if (schema._def && (schema._def.typeName === 'ZodAny' || schema._def.typeName === 'ZodRecord')) {\n            if (prefix) recordPrefixes.add(prefix);\n            return;\n        }\n\n        if (schema._def && schema._def.typeName === 'ZodObject') {\n            const objectSchema = schema as z.ZodObject<any>;\n            Object.entries(objectSchema.shape).forEach(([key, subschema]) => {\n                const fullKey = prefix ? `${prefix}.${key}` : key;\n                findRecordPrefixes(subschema as z.ZodTypeAny, fullKey);\n            });\n        }\n    };\n\n    findRecordPrefixes(fullSchema);\n\n    // Filter out keys that are under record prefixes\n    const extraKeys = actualKeys.filter(key => {\n        if (allowedKeys.has(key)) return false;\n\n        // Check if this key is under a record prefix\n        for (const recordPrefix of recordPrefixes) {\n            if (key.startsWith(recordPrefix + '.')) {\n                return false; // This key is allowed under a record\n            }\n        }\n\n        return true; // This is an extra key\n    });\n\n    if (extraKeys.length > 0) {\n        const allowedKeysArray = Array.from(allowedKeys);\n        const error = ConfigurationError.extraKeys(extraKeys, allowedKeysArray);\n        logger.error(error.message);\n        throw error;\n    }\n}\n\n/**\n * Validates that a configuration directory exists and is accessible.\n * \n * This function performs file system checks to ensure the configuration\n * directory can be used. It handles the isRequired flag to determine\n * whether a missing directory should cause an error or be silently ignored.\n * \n * @param configDirectory - Path to the configuration directory\n * @param isRequired - Whether the directory must exist\n * @param logger - Optional logger for debug information\n * @throws {FileSystemError} When the directory is required but missing or unreadable\n */\nconst validateConfigDirectory = async (configDirectory: string, isRequired: boolean, logger?: Logger): Promise<void> => {\n    const storage = Storage.create({ log: logger?.debug || (() => { }) });\n    const exists = await storage.exists(configDirectory);\n    if (!exists) {\n        if (isRequired) {\n            throw FileSystemError.directoryNotFound(configDirectory, true);\n        }\n    } else if (exists) {\n        const isReadable = await storage.isDirectoryReadable(configDirectory);\n        if (!isReadable) {\n            throw FileSystemError.directoryNotReadable(configDirectory);\n        }\n    }\n}\n\n/**\n * Validates a configuration object against the combined Zod schema.\n * \n * This is the main validation function that:\n * 1. Validates the configuration directory (if config feature enabled)\n * 2. Combines the base ConfigSchema with user-provided schema shape\n * 3. Checks for extra keys not defined in the schema\n * 4. Validates all values against their schema definitions\n * 5. Provides detailed error reporting for validation failures\n * \n * The validation is comprehensive and catches common configuration errors\n * including typos, missing required fields, wrong types, and invalid values.\n * \n * @template T - The Zod schema shape type for configuration validation\n * @param config - The merged configuration object to validate\n * @param options - Cardigantime options containing schema, defaults, and logger\n * @throws {ConfigurationError} When configuration validation fails\n * @throws {FileSystemError} When configuration directory validation fails\n * \n * @example\n * ```typescript\n * const schema = z.object({\n *   apiKey: z.string().min(1),\n *   timeout: z.number().positive(),\n * });\n * \n * await validate(config, {\n *   configShape: schema.shape,\n *   defaults: { configDirectory: './config', isRequired: true },\n *   logger: console,\n *   features: ['config']\n * });\n * // Throws detailed errors if validation fails\n * ```\n */\nexport const validate = async <T extends z.ZodRawShape>(config: z.infer<ZodObject<T & typeof ConfigSchema.shape>>, options: Options<T>): Promise<void> => {\n    const logger = options.logger;\n\n    if (options.features.includes('config') && config.configDirectory) {\n        await validateConfigDirectory(config.configDirectory, options.defaults.isRequired, logger);\n    }\n\n    // Combine the base schema with the user-provided shape\n    const fullSchema = z.object({\n        ...ConfigSchema.shape,\n        ...options.configShape,\n    });\n\n    // Validate the merged sources against the full schema\n    const validationResult = fullSchema.safeParse(config);\n\n    // Check for extraneous keys\n    checkForExtraKeys(config, fullSchema, logger);\n\n    if (!validationResult.success) {\n        const formattedError = JSON.stringify(validationResult.error.format(), null, 2);\n        logger.error('Configuration validation failed. Check logs for details.');\n        logger.silly('Configuration validation failed: %s', formattedError);\n        throw ConfigurationError.validation('Configuration validation failed. Check logs for details.', validationResult.error);\n    }\n\n    return;\n}\n\n","import { Command } from 'commander';\nimport { Args, DefaultOptions, Feature, Cardigantime, Logger, Options } from 'types';\nimport { z, ZodObject } from 'zod';\nimport { configure } from './configure';\nimport { DEFAULT_FEATURES, DEFAULT_LOGGER, DEFAULT_OPTIONS } from './constants';\nimport { read } from './read';\nimport { ConfigSchema } from 'types';\nimport { validate } from './validate';\n\nexport * from './types';\nexport { ArgumentError, ConfigurationError, FileSystemError } from './validate';\n\n/**\n * Creates a new Cardigantime instance for configuration management.\n * \n * Cardigantime handles the complete configuration lifecycle including:\n * - Reading configuration from YAML files\n * - Validating configuration against Zod schemas\n * - Merging CLI arguments with file configuration and defaults\n * - Providing type-safe configuration objects\n * \n * @template T - The Zod schema shape type for your configuration\n * @param pOptions - Configuration options for the Cardigantime instance\n * @param pOptions.defaults - Default configuration settings\n * @param pOptions.defaults.configDirectory - Directory to search for configuration files (required)\n * @param pOptions.defaults.configFile - Name of the configuration file (optional, defaults to 'config.yaml')\n * @param pOptions.defaults.isRequired - Whether the config directory must exist (optional, defaults to false)\n * @param pOptions.defaults.encoding - File encoding for reading config files (optional, defaults to 'utf8')\n * @param pOptions.features - Array of features to enable (optional, defaults to ['config'])\n * @param pOptions.configShape - Zod schema shape defining your configuration structure (required)\n * @param pOptions.logger - Custom logger implementation (optional, defaults to console logger)\n * @returns A Cardigantime instance with methods for configure, read, validate, and setLogger\n * \n * @example\n * ```typescript\n * import { create } from '@theunwalked/cardigantime';\n * import { z } from 'zod';\n * \n * const MyConfigSchema = z.object({\n *   apiKey: z.string().min(1),\n *   timeout: z.number().default(5000),\n *   debug: z.boolean().default(false),\n * });\n * \n * const cardigantime = create({\n *   defaults: {\n *     configDirectory: './config',\n *     configFile: 'myapp.yaml',\n *   },\n *   configShape: MyConfigSchema.shape,\n * });\n * ```\n */\nexport const create = <T extends z.ZodRawShape>(pOptions: {\n    defaults: Pick<DefaultOptions, 'configDirectory'> & Partial<Omit<DefaultOptions, 'configDirectory'>>,\n    features?: Feature[],\n    configShape: T, // Make configShape mandatory\n    logger?: Logger,\n}): Cardigantime<T> => {\n\n\n    const defaults: DefaultOptions = { ...DEFAULT_OPTIONS, ...pOptions.defaults } as DefaultOptions;\n    const features = pOptions.features || DEFAULT_FEATURES;\n    const configShape = pOptions.configShape;\n    let logger = pOptions.logger || DEFAULT_LOGGER;\n\n    const options: Options<T> = {\n        defaults,\n        features,\n        configShape, // Store the shape\n        logger,\n    }\n\n    const setLogger = (pLogger: Logger) => {\n        logger = pLogger;\n        options.logger = pLogger;\n    }\n\n    return {\n        setLogger,\n        configure: (command: Command) => configure(command, options),\n        validate: (config: z.infer<ZodObject<T & typeof ConfigSchema.shape>>) => validate(config, options),\n        read: (args: Args) => read(args, options),\n    }\n}\n\n\n\n\n\n"],"names":["_define_property","ArgumentError","Error","argument","argumentName","message","name","validateConfigDirectory","configDirectory","_testThrowNonArgumentError","trimmed","trim","length","includes","configure","command","options","option","defaults","validatedDefaultDir","retCommand","value","error","DEFAULT_ENCODING","DEFAULT_CONFIG_FILE","DEFAULT_OPTIONS","configFile","isRequired","encoding","DEFAULT_FEATURES","DEFAULT_LOGGER","debug","console","info","warn","verbose","silly","FileSystemError","directoryNotFound","path","directoryNotReadable","directoryCreationFailed","originalError","operationFailed","operation","fileNotFound","errorType","create","params","log","exists","fs","promises","stat","isDirectory","stats","isFile","isReadable","access","constants","R_OK","stack","isWritable","W_OK","isFileReadable","isDirectoryWritable","isDirectoryReadable","createDirectory","mkdir","recursive","mkdirError","readFile","validEncodings","toLowerCase","maxFileSize","size","code","writeFile","data","forEachFileIn","directory","callback","pattern","files","glob","cwd","nodir","file","join","err","readStream","createReadStream","hashFile","crypto","createHash","update","digest","slice","listFiles","readdir","discoverConfigDirectories","configDirName","maxLevels","startingDir","process","logger","storage","createStorage","discoveredDirs","currentDir","resolve","level","visited","Set","realPath","has","add","configDirPath","push","parentDir","dirname","loadConfigFromDirectory","configDir","configFileName","configFilePath","yamlContent","parsedYaml","yaml","load","deepMergeConfigs","configs","reduce","merged","current","deepMergeTwo","target","source","Array","isArray","result","key","Object","prototype","hasOwnProperty","call","loadHierarchicalConfig","config","errors","sortedDirs","sort","a","b","dir","errorMsg","mergedConfig","clean","obj","fromEntries","entries","filter","_","v","undefined","validatePath","userPath","basePath","normalized","normalize","isAbsolute","startsWith","read","args","rawConfigDir","resolvedConfigDir","rawFileConfig","features","basename","hierarchicalResult","forEach","loadSingleDirectoryConfig","Storage","test","ConfigurationError","validation","zodError","configPath","extraKeys","allowedKeys","schema","details","ConfigSchema","z","object","string","listZodKeys","prefix","_def","typeName","unwrappable","unwrap","arraySchema","element","objectSchema","shape","flatMap","subschema","fullKey","nested","isPlainObject","listObjectKeys","keys","firstObjectElement","find","nestedKeys","k","from","checkForExtraKeys","mergedSources","fullSchema","actualKeys","recordPrefixes","findRecordPrefixes","recordPrefix","allowedKeysArray","validate","configShape","validationResult","safeParse","success","formattedError","JSON","stringify","format","pOptions","setLogger","pLogger"],"mappings":"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"}
+{"version":3,"file":"cardigantime.cjs","sources":["../src/error/ArgumentError.ts","../src/configure.ts","../src/constants.ts","../src/error/FileSystemError.ts","../src/util/storage.ts","../src/util/hierarchical.ts","../src/read.ts","../src/error/ConfigurationError.ts","../src/types.ts","../src/validate.ts","../src/cardigantime.ts"],"sourcesContent":["/**\n * Error thrown when CLI arguments or function parameters are invalid.\n * \n * This error provides specific context about which argument failed validation\n * and why, making it easier for users to fix their command-line usage or\n * for developers to debug parameter issues.\n * \n * @example\n * ```typescript\n * throw new ArgumentError('config-directory', 'Path cannot be empty');\n * // Error message: \"Path cannot be empty\"\n * // error.argument: \"config-directory\"\n * ```\n */\nexport class ArgumentError extends Error {\n    /** The name of the argument that caused the error */\n    private argumentName: string;\n\n    /**\n     * Creates a new ArgumentError instance.\n     * \n     * @param argumentName - The name of the invalid argument\n     * @param message - Description of why the argument is invalid\n     */\n    constructor(argumentName: string, message: string) {\n        super(`${message}`);\n        this.name = 'ArgumentError';\n        this.argumentName = argumentName;\n    }\n\n    /**\n     * Gets the name of the argument that caused this error.\n     * \n     * @returns The argument name\n     */\n    get argument(): string {\n        return this.argumentName;\n    }\n}","import { Command } from \"commander\";\nimport { z } from \"zod\";\nimport { ArgumentError } from \"./error/ArgumentError\";\nimport { Options } from \"./types\";\nexport { ArgumentError };\n\n/**\n * Validates a configuration directory path to ensure it's safe and valid.\n * \n * Performs security and safety checks including:\n * - Non-empty string validation\n * - Null byte injection prevention\n * - Path length validation\n * - Type checking\n * \n * @param configDirectory - The configuration directory path to validate\n * @param _testThrowNonArgumentError - Internal testing parameter to simulate non-ArgumentError exceptions\n * @returns The trimmed and validated configuration directory path\n * @throws {ArgumentError} When the directory path is invalid\n * \n * @example\n * ```typescript\n * const validDir = validateConfigDirectory('./config'); // Returns './config'\n * const invalidDir = validateConfigDirectory(''); // Throws ArgumentError\n * ```\n */\nexport function validateConfigDirectory(configDirectory: string, _testThrowNonArgumentError?: boolean): string {\n    if (_testThrowNonArgumentError) {\n        throw new Error('Test non-ArgumentError for coverage');\n    }\n\n    if (!configDirectory) {\n        throw new ArgumentError('configDirectory', 'Configuration directory cannot be empty');\n    }\n\n    if (typeof configDirectory !== 'string') {\n        throw new ArgumentError('configDirectory', 'Configuration directory must be a string');\n    }\n\n    const trimmed = configDirectory.trim();\n    if (trimmed.length === 0) {\n        throw new ArgumentError('configDirectory', 'Configuration directory cannot be empty or whitespace only');\n    }\n\n    // Check for obviously invalid paths\n    if (trimmed.includes('\\0')) {\n        throw new ArgumentError('configDirectory', 'Configuration directory contains invalid null character');\n    }\n\n    // Validate path length (reasonable limit)\n    if (trimmed.length > 1000) {\n        throw new ArgumentError('configDirectory', 'Configuration directory path is too long (max 1000 characters)');\n    }\n\n    return trimmed;\n}\n\n/**\n * Configures a Commander.js command with Cardigantime's CLI options.\n * \n * This function adds command-line options that allow users to override\n * configuration settings at runtime, such as:\n * - --config-directory: Override the default configuration directory\n * \n * The function validates both the command object and the options to ensure\n * they meet the requirements for proper integration.\n * \n * @template T - The Zod schema shape type for configuration validation\n * @param command - The Commander.js Command instance to configure\n * @param options - Cardigantime options containing defaults and schema\n * @param _testThrowNonArgumentError - Internal testing parameter\n * @returns Promise resolving to the configured Command instance\n * @throws {ArgumentError} When command or options are invalid\n * \n * @example\n * ```typescript\n * import { Command } from 'commander';\n * import { configure } from './configure';\n * \n * const program = new Command();\n * const configuredProgram = await configure(program, options);\n * \n * // Now the program accepts: --config-directory <path>\n * ```\n */\nexport const configure = async <T extends z.ZodRawShape>(\n    command: Command,\n    options: Options<T>,\n    _testThrowNonArgumentError?: boolean\n): Promise<Command> => {\n    // Validate the command object\n    if (!command) {\n        throw new ArgumentError('command', 'Command instance is required');\n    }\n\n    if (typeof command.option !== 'function') {\n        throw new ArgumentError('command', 'Command must be a valid Commander.js Command instance');\n    }\n\n    // Validate options\n    if (!options) {\n        throw new ArgumentError('options', 'Options object is required');\n    }\n\n    if (!options.defaults) {\n        throw new ArgumentError('options.defaults', 'Options must include defaults configuration');\n    }\n\n    if (!options.defaults.configDirectory) {\n        throw new ArgumentError('options.defaults.configDirectory', 'Default config directory is required');\n    }\n\n    // Validate the default config directory\n    const validatedDefaultDir = validateConfigDirectory(options.defaults.configDirectory, _testThrowNonArgumentError);\n\n    let retCommand = command;\n\n    // Add the config directory option with validation\n    retCommand = retCommand.option(\n        '-c, --config-directory <configDirectory>',\n        'Configuration directory path',\n        (value: string) => {\n            try {\n                return validateConfigDirectory(value, _testThrowNonArgumentError);\n            } catch (error) {\n                if (error instanceof ArgumentError) {\n                    // Re-throw with more specific context for CLI usage\n                    throw new ArgumentError('config-directory', `Invalid --config-directory: ${error.message}`);\n                }\n                throw error;\n            }\n        },\n        validatedDefaultDir\n    );\n\n    return retCommand;\n}\n\n\n\n\n","import { DefaultOptions, Feature, Logger } from \"./types\";\n\n/** Version string populated at build time with git and system information */\nexport const VERSION = '__VERSION__ (__GIT_BRANCH__/__GIT_COMMIT__ __GIT_TAGS__ __GIT_COMMIT_DATE__) __SYSTEM_INFO__';\n\n/** The program name used in CLI help and error messages */\nexport const PROGRAM_NAME = 'cardigantime';\n\n/** Default file encoding for reading configuration files */\nexport const DEFAULT_ENCODING = 'utf8';\n\n/** Default configuration file name to look for in the config directory */\nexport const DEFAULT_CONFIG_FILE = 'config.yaml';\n\n/**\n * Default configuration options applied when creating a Cardigantime instance.\n * These provide sensible defaults that work for most use cases.\n */\nexport const DEFAULT_OPTIONS: Partial<DefaultOptions> = {\n    configFile: DEFAULT_CONFIG_FILE,\n    isRequired: false,\n    encoding: DEFAULT_ENCODING,\n    pathResolution: undefined, // No path resolution by default\n}\n\n/**\n * Default features enabled when creating a Cardigantime instance.\n * Currently includes only the 'config' feature for configuration file support.\n */\nexport const DEFAULT_FEATURES: Feature[] = ['config'];\n\n/**\n * Default logger implementation using console methods.\n * Provides basic logging functionality when no custom logger is specified.\n * The verbose and silly methods are no-ops to avoid excessive output.\n */\nexport const DEFAULT_LOGGER: Logger = {\n    // eslint-disable-next-line no-console\n    debug: console.debug,\n    // eslint-disable-next-line no-console\n    info: console.info,\n    // eslint-disable-next-line no-console\n    warn: console.warn,\n    // eslint-disable-next-line no-console\n    error: console.error,\n\n    verbose: () => { },\n\n    silly: () => { },\n}\n","/**\n * Error thrown when file system operations fail\n */\nexport class FileSystemError extends Error {\n    public readonly errorType: 'not_found' | 'not_readable' | 'not_writable' | 'creation_failed' | 'operation_failed';\n    public readonly path: string;\n    public readonly operation: string;\n    public readonly originalError?: Error;\n\n    constructor(\n        errorType: 'not_found' | 'not_readable' | 'not_writable' | 'creation_failed' | 'operation_failed',\n        message: string,\n        path: string,\n        operation: string,\n        originalError?: Error\n    ) {\n        super(message);\n        this.name = 'FileSystemError';\n        this.errorType = errorType;\n        this.path = path;\n        this.operation = operation;\n        this.originalError = originalError;\n    }\n\n    /**\n     * Creates an error for when a required directory doesn't exist\n     */\n    static directoryNotFound(path: string, isRequired: boolean = false): FileSystemError {\n        const message = isRequired\n            ? 'Configuration directory does not exist and is required'\n            : 'Configuration directory not found';\n        return new FileSystemError('not_found', message, path, 'directory_access');\n    }\n\n    /**\n     * Creates an error for when a directory exists but isn't readable\n     */\n    static directoryNotReadable(path: string): FileSystemError {\n        const message = 'Configuration directory exists but is not readable';\n        return new FileSystemError('not_readable', message, path, 'directory_read');\n    }\n\n    /**\n     * Creates an error for directory creation failures\n     */\n    static directoryCreationFailed(path: string, originalError: Error): FileSystemError {\n        const message = 'Failed to create directory: ' + (originalError.message || 'Unknown error');\n        return new FileSystemError('creation_failed', message, path, 'directory_create', originalError);\n    }\n\n    /**\n     * Creates an error for file operation failures (glob, etc.)\n     */\n    static operationFailed(operation: string, path: string, originalError: Error): FileSystemError {\n        const message = `Failed to ${operation}: ${originalError.message || 'Unknown error'}`;\n        return new FileSystemError('operation_failed', message, path, operation, originalError);\n    }\n\n    /**\n     * Creates an error for when a file is not found\n     */\n    static fileNotFound(path: string): FileSystemError {\n        const message = 'Configuration file not found';\n        return new FileSystemError('not_found', message, path, 'file_read');\n    }\n} ","// eslint-disable-next-line no-restricted-imports\nimport * as fs from 'fs';\nimport { glob } from 'glob';\nimport path from 'path';\nimport crypto from 'crypto';\nimport { FileSystemError } from '../error/FileSystemError';\n/**\n * This module exists to isolate filesystem operations from the rest of the codebase.\n * This makes testing easier by avoiding direct fs mocking in jest configuration.\n * \n * Additionally, abstracting storage operations allows for future flexibility - \n * this export utility may need to work with storage systems other than the local filesystem\n * (e.g. S3, Google Cloud Storage, etc).\n */\n\nexport interface Utility {\n    exists: (path: string) => Promise<boolean>;\n    isDirectory: (path: string) => Promise<boolean>;\n    isFile: (path: string) => Promise<boolean>;\n    isReadable: (path: string) => Promise<boolean>;\n    isWritable: (path: string) => Promise<boolean>;\n    isFileReadable: (path: string) => Promise<boolean>;\n    isDirectoryWritable: (path: string) => Promise<boolean>;\n    isDirectoryReadable: (path: string) => Promise<boolean>;\n    createDirectory: (path: string) => Promise<void>;\n    readFile: (path: string, encoding: string) => Promise<string>;\n    readStream: (path: string) => Promise<fs.ReadStream>;\n    writeFile: (path: string, data: string | Buffer, encoding: string) => Promise<void>;\n    forEachFileIn: (directory: string, callback: (path: string) => Promise<void>, options?: { pattern: string }) => Promise<void>;\n    hashFile: (path: string, length: number) => Promise<string>;\n    listFiles: (directory: string) => Promise<string[]>;\n}\n\nexport const create = (params: { log?: (message: string, ...args: any[]) => void }): Utility => {\n\n    // eslint-disable-next-line no-console\n    const log = params.log || console.log;\n\n    const exists = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.stat(path);\n            return true;\n            // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        } catch (error: any) {\n            return false;\n        }\n    }\n\n    const isDirectory = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isDirectory()) {\n            log(`${path} is not a directory`);\n            return false;\n        }\n        return true;\n    }\n\n    const isFile = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isFile()) {\n            log(`${path} is not a file`);\n            return false;\n        }\n        return true;\n    }\n\n    const isReadable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.R_OK);\n        } catch (error: any) {\n            log(`${path} is not readable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isWritable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.W_OK);\n        } catch (error: any) {\n            log(`${path} is not writable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isFileReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isFile(path) && await isReadable(path);\n    }\n\n    const isDirectoryWritable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isWritable(path);\n    }\n\n    const isDirectoryReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isReadable(path);\n    }\n\n    const createDirectory = async (path: string): Promise<void> => {\n        try {\n            await fs.promises.mkdir(path, { recursive: true });\n        } catch (mkdirError: any) {\n            throw FileSystemError.directoryCreationFailed(path, mkdirError);\n        }\n    }\n\n    const readFile = async (path: string, encoding: string): Promise<string> => {\n        // Validate encoding parameter\n        const validEncodings = ['utf8', 'utf-8', 'ascii', 'latin1', 'base64', 'hex', 'utf16le', 'ucs2', 'ucs-2'];\n        if (!validEncodings.includes(encoding.toLowerCase())) {\n            throw new Error('Invalid encoding specified');\n        }\n\n        // Check file size before reading to prevent DoS\n        try {\n            const stats = await fs.promises.stat(path);\n            const maxFileSize = 10 * 1024 * 1024; // 10MB limit\n            if (stats.size > maxFileSize) {\n                throw new Error('File too large to process');\n            }\n        } catch (error: any) {\n            if (error.code === 'ENOENT') {\n                throw FileSystemError.fileNotFound(path);\n            }\n            throw error;\n        }\n\n        return await fs.promises.readFile(path, { encoding: encoding as BufferEncoding });\n    }\n\n    const writeFile = async (path: string, data: string | Buffer, encoding: string): Promise<void> => {\n        await fs.promises.writeFile(path, data, { encoding: encoding as BufferEncoding });\n    }\n\n    const forEachFileIn = async (directory: string, callback: (file: string) => Promise<void>, options: { pattern: string | string[] } = { pattern: '*.*' }): Promise<void> => {\n        try {\n            const files = await glob(options.pattern, { cwd: directory, nodir: true });\n            for (const file of files) {\n                await callback(path.join(directory, file));\n            }\n        } catch (err: any) {\n            throw FileSystemError.operationFailed(`glob pattern ${options.pattern}`, directory, err);\n        }\n    }\n\n    const readStream = async (path: string): Promise<fs.ReadStream> => {\n        return fs.createReadStream(path);\n    }\n\n    const hashFile = async (path: string, length: number): Promise<string> => {\n        const file = await readFile(path, 'utf8');\n        return crypto.createHash('sha256').update(file).digest('hex').slice(0, length);\n    }\n\n    const listFiles = async (directory: string): Promise<string[]> => {\n        return await fs.promises.readdir(directory);\n    }\n\n    return {\n        exists,\n        isDirectory,\n        isFile,\n        isReadable,\n        isWritable,\n        isFileReadable,\n        isDirectoryWritable,\n        isDirectoryReadable,\n        createDirectory,\n        readFile,\n        readStream,\n        writeFile,\n        forEachFileIn,\n        hashFile,\n        listFiles,\n    };\n}","import path from 'path';\nimport * as yaml from 'js-yaml';\nimport { create as createStorage } from './storage';\nimport { Logger, FieldOverlapOptions, ArrayOverlapMode } from '../types';\n\n/**\n * Resolves relative paths in configuration values relative to the configuration file's directory.\n */\nfunction resolveConfigPaths(\n    config: any,\n    configDir: string,\n    pathFields: string[] = [],\n    resolvePathArray: string[] = []\n): any {\n    if (!config || typeof config !== 'object' || pathFields.length === 0) {\n        return config;\n    }\n\n    const resolvedConfig = { ...config };\n\n    for (const fieldPath of pathFields) {\n        const value = getNestedValue(resolvedConfig, fieldPath);\n        if (value !== undefined) {\n            const shouldResolveArrayElements = resolvePathArray.includes(fieldPath);\n            const resolvedValue = resolvePathValue(value, configDir, shouldResolveArrayElements);\n            setNestedValue(resolvedConfig, fieldPath, resolvedValue);\n        }\n    }\n\n    return resolvedConfig;\n}\n\n/**\n * Gets a nested value from an object using dot notation.\n */\nfunction getNestedValue(obj: any, path: string): any {\n    return path.split('.').reduce((current, key) => current?.[key], obj);\n}\n\n/**\n * Sets a nested value in an object using dot notation.\n */\nfunction setNestedValue(obj: any, path: string, value: any): void {\n    const keys = path.split('.');\n    const lastKey = keys.pop()!;\n    const target = keys.reduce((current, key) => {\n        if (!(key in current)) {\n            current[key] = {};\n        }\n        return current[key];\n    }, obj);\n    target[lastKey] = value;\n}\n\n/**\n * Resolves a path value (string or array of strings) relative to the config directory.\n */\nfunction resolvePathValue(value: any, configDir: string, resolveArrayElements: boolean): any {\n    if (typeof value === 'string') {\n        return resolveSinglePath(value, configDir);\n    }\n\n    if (Array.isArray(value) && resolveArrayElements) {\n        return value.map(item =>\n            typeof item === 'string' ? resolveSinglePath(item, configDir) : item\n        );\n    }\n\n    return value;\n}\n\n/**\n * Resolves a single path string relative to the config directory if it's a relative path.\n */\nfunction resolveSinglePath(pathStr: string, configDir: string): string {\n    if (!pathStr || path.isAbsolute(pathStr)) {\n        return pathStr;\n    }\n\n    return path.resolve(configDir, pathStr);\n}\n\n/**\n * Represents a discovered configuration directory with its path and precedence level.\n */\nexport interface DiscoveredConfigDir {\n    /** Absolute path to the configuration directory */\n    path: string;\n    /** Distance from the starting directory (0 = closest/highest precedence) */\n    level: number;\n}\n\n/**\n * Options for hierarchical configuration discovery.\n */\nexport interface HierarchicalDiscoveryOptions {\n    /** Name of the configuration directory to look for (e.g., '.kodrdriv') */\n    configDirName: string;\n    /** Name of the configuration file within each directory */\n    configFileName: string;\n    /** Maximum number of parent directories to traverse (default: 10) */\n    maxLevels?: number;\n    /** Starting directory for discovery (default: process.cwd()) */\n    startingDir?: string;\n    /** File encoding for reading configuration files */\n    encoding?: string;\n    /** Logger for debugging */\n    logger?: Logger;\n    /** Array of field names that contain paths to be resolved */\n    pathFields?: string[];\n    /** Array of field names whose array elements should all be resolved as paths */\n    resolvePathArray?: string[];\n    /** Configuration for how array fields should be merged in hierarchical mode */\n    fieldOverlaps?: FieldOverlapOptions;\n}\n\n/**\n * Result of loading configurations from multiple directories.\n */\nexport interface HierarchicalConfigResult {\n    /** Merged configuration object with proper precedence */\n    config: object;\n    /** Array of directories where configuration was found */\n    discoveredDirs: DiscoveredConfigDir[];\n    /** Array of any errors encountered during loading (non-fatal) */\n    errors: string[];\n}\n\n/**\n * Discovers configuration directories by traversing up the directory tree.\n * \n * Starting from the specified directory (or current working directory),\n * this function searches for directories with the given name, continuing\n * up the directory tree until it reaches the filesystem root or the\n * maximum number of levels.\n * \n * @param options Configuration options for discovery\n * @returns Promise resolving to array of discovered configuration directories\n * \n * @example\n * ```typescript\n * const dirs = await discoverConfigDirectories({\n *   configDirName: '.kodrdriv',\n *   configFileName: 'config.yaml',\n *   maxLevels: 5\n * });\n * // Returns: [\n * //   { path: '/project/.kodrdriv', level: 0 },\n * //   { path: '/project/parent/.kodrdriv', level: 1 }\n * // ]\n * ```\n */\nexport async function discoverConfigDirectories(\n    options: HierarchicalDiscoveryOptions\n): Promise<DiscoveredConfigDir[]> {\n    const {\n        configDirName,\n        maxLevels = 10,\n        startingDir = process.cwd(),\n        logger\n    } = options;\n\n    const storage = createStorage({ log: logger?.debug || (() => { }) });\n    const discoveredDirs: DiscoveredConfigDir[] = [];\n\n    let currentDir = path.resolve(startingDir);\n    let level = 0;\n    const visited = new Set<string>(); // Prevent infinite loops with symlinks\n\n    logger?.debug(`Starting hierarchical discovery from: ${currentDir}`);\n\n    while (level < maxLevels) {\n        // Prevent infinite loops with symlinks\n        const realPath = path.resolve(currentDir);\n        if (visited.has(realPath)) {\n            logger?.debug(`Already visited ${realPath}, stopping discovery`);\n            break;\n        }\n        visited.add(realPath);\n\n        const configDirPath = path.join(currentDir, configDirName);\n        logger?.debug(`Checking for config directory: ${configDirPath}`);\n\n        try {\n            const exists = await storage.exists(configDirPath);\n            const isReadable = exists && await storage.isDirectoryReadable(configDirPath);\n\n            if (exists && isReadable) {\n                discoveredDirs.push({\n                    path: configDirPath,\n                    level\n                });\n                logger?.debug(`Found config directory at level ${level}: ${configDirPath}`);\n            } else if (exists && !isReadable) {\n                logger?.debug(`Config directory exists but is not readable: ${configDirPath}`);\n            }\n        } catch (error: any) {\n            logger?.debug(`Error checking config directory ${configDirPath}: ${error.message}`);\n        }\n\n        // Move up one directory level\n        const parentDir = path.dirname(currentDir);\n\n        // Check if we've reached the root directory\n        if (parentDir === currentDir) {\n            logger?.debug('Reached filesystem root, stopping discovery');\n            break;\n        }\n\n        currentDir = parentDir;\n        level++;\n    }\n\n    logger?.verbose(`Discovery complete. Found ${discoveredDirs.length} config directories`);\n    return discoveredDirs;\n}\n\n/**\n * Loads and parses a configuration file from a directory.\n * \n * @param configDir Path to the configuration directory\n * @param configFileName Name of the configuration file\n * @param encoding File encoding\n * @param logger Optional logger\n * @param pathFields Optional array of field names that contain paths to be resolved\n * @param resolvePathArray Optional array of field names whose array elements should all be resolved as paths\n * @returns Promise resolving to parsed configuration object or null if not found\n */\nexport async function loadConfigFromDirectory(\n    configDir: string,\n    configFileName: string,\n    encoding: string = 'utf8',\n    logger?: Logger,\n    pathFields?: string[],\n    resolvePathArray?: string[]\n): Promise<object | null> {\n    const storage = createStorage({ log: logger?.debug || (() => { }) });\n    const configFilePath = path.join(configDir, configFileName);\n\n    try {\n        logger?.verbose(`Attempting to load config file: ${configFilePath}`);\n\n        const exists = await storage.exists(configFilePath);\n        if (!exists) {\n            logger?.debug(`Config file does not exist: ${configFilePath}`);\n            return null;\n        }\n\n        const isReadable = await storage.isFileReadable(configFilePath);\n        if (!isReadable) {\n            logger?.debug(`Config file exists but is not readable: ${configFilePath}`);\n            return null;\n        }\n\n        const yamlContent = await storage.readFile(configFilePath, encoding);\n        const parsedYaml = yaml.load(yamlContent);\n\n        if (parsedYaml !== null && typeof parsedYaml === 'object') {\n            let config = parsedYaml as object;\n\n            // Apply path resolution if configured\n            if (pathFields && pathFields.length > 0) {\n                config = resolveConfigPaths(config, configDir, pathFields, resolvePathArray || []);\n            }\n\n            logger?.verbose(`Successfully loaded config from: ${configFilePath}`);\n            return config;\n        } else {\n            logger?.debug(`Config file contains invalid format: ${configFilePath}`);\n            return null;\n        }\n    } catch (error: any) {\n        logger?.debug(`Error loading config from ${configFilePath}: ${error.message}`);\n        return null;\n    }\n}\n\n/**\n * Deep merges multiple configuration objects with proper precedence and configurable array overlap behavior.\n * \n * Objects are merged from lowest precedence to highest precedence,\n * meaning that properties in later objects override properties in earlier objects.\n * Arrays can be merged using different strategies based on the fieldOverlaps configuration.\n * \n * @param configs Array of configuration objects, ordered from lowest to highest precedence\n * @param fieldOverlaps Configuration for how array fields should be merged (optional)\n * @returns Merged configuration object\n * \n * @example\n * ```typescript\n * const merged = deepMergeConfigs([\n *   { api: { timeout: 5000 }, features: ['auth'] },        // Lower precedence\n *   { api: { retries: 3 }, features: ['analytics'] },      // Higher precedence\n * ], {\n *   'features': 'append'  // Results in features: ['auth', 'analytics']\n * });\n * ```\n */\nexport function deepMergeConfigs(configs: object[], fieldOverlaps?: FieldOverlapOptions): object {\n    if (configs.length === 0) {\n        return {};\n    }\n\n    if (configs.length === 1) {\n        return { ...configs[0] };\n    }\n\n    return configs.reduce((merged, current) => {\n        return deepMergeTwo(merged, current, fieldOverlaps);\n    }, {});\n}\n\n/**\n * Deep merges two objects with proper precedence and configurable array overlap behavior.\n * \n * @param target Target object (lower precedence)\n * @param source Source object (higher precedence)\n * @param fieldOverlaps Configuration for how array fields should be merged (optional)\n * @param currentPath Current field path for nested merging (used internally)\n * @returns Merged object\n */\nfunction deepMergeTwo(target: any, source: any, fieldOverlaps?: FieldOverlapOptions, currentPath: string = ''): any {\n    // Handle null/undefined\n    if (source == null) return target;\n    if (target == null) return source;\n\n    // Handle non-objects (primitives, arrays, functions, etc.)\n    if (typeof source !== 'object' || typeof target !== 'object') {\n        return source; // Source takes precedence\n    }\n\n    // Handle arrays with configurable overlap behavior\n    if (Array.isArray(source)) {\n        if (Array.isArray(target) && fieldOverlaps) {\n            const overlapMode = getOverlapModeForPath(currentPath, fieldOverlaps);\n            return mergeArrays(target, source, overlapMode);\n        } else {\n            // Default behavior: replace entirely\n            return [...source];\n        }\n    }\n\n    if (Array.isArray(target)) {\n        return source; // Source object replaces target array\n    }\n\n    // Deep merge objects\n    const result = { ...target };\n\n    for (const key in source) {\n        if (Object.prototype.hasOwnProperty.call(source, key)) {\n            const fieldPath = currentPath ? `${currentPath}.${key}` : key;\n\n            if (Object.prototype.hasOwnProperty.call(result, key) &&\n                typeof result[key] === 'object' &&\n                typeof source[key] === 'object' &&\n                !Array.isArray(source[key]) &&\n                !Array.isArray(result[key])) {\n                // Recursively merge nested objects\n                result[key] = deepMergeTwo(result[key], source[key], fieldOverlaps, fieldPath);\n            } else {\n                // Handle arrays and primitives with overlap consideration\n                if (Array.isArray(source[key]) && Array.isArray(result[key]) && fieldOverlaps) {\n                    const overlapMode = getOverlapModeForPath(fieldPath, fieldOverlaps);\n                    result[key] = mergeArrays(result[key], source[key], overlapMode);\n                } else {\n                    // Replace with source value (higher precedence)\n                    result[key] = source[key];\n                }\n            }\n        }\n    }\n\n    return result;\n}\n\n/**\n * Determines the overlap mode for a given field path.\n * \n * @param fieldPath The current field path (dot notation)\n * @param fieldOverlaps Configuration mapping field paths to overlap modes\n * @returns The overlap mode to use for this field path\n */\nfunction getOverlapModeForPath(fieldPath: string, fieldOverlaps: FieldOverlapOptions): ArrayOverlapMode {\n    // Check for exact match first\n    if (fieldPath in fieldOverlaps) {\n        return fieldOverlaps[fieldPath];\n    }\n\n    // Check for any parent path matches (for nested configurations)\n    const pathParts = fieldPath.split('.');\n    for (let i = pathParts.length - 1; i > 0; i--) {\n        const parentPath = pathParts.slice(0, i).join('.');\n        if (parentPath in fieldOverlaps) {\n            return fieldOverlaps[parentPath];\n        }\n    }\n\n    // Default to override if no specific configuration found\n    return 'override';\n}\n\n/**\n * Merges two arrays based on the specified overlap mode.\n * \n * @param targetArray The lower precedence array\n * @param sourceArray The higher precedence array\n * @param mode The overlap mode to use\n * @returns The merged array\n */\nfunction mergeArrays(targetArray: any[], sourceArray: any[], mode: ArrayOverlapMode): any[] {\n    switch (mode) {\n        case 'append':\n            return [...targetArray, ...sourceArray];\n        case 'prepend':\n            return [...sourceArray, ...targetArray];\n        case 'override':\n        default:\n            return [...sourceArray];\n    }\n}\n\n/**\n * Loads configurations from multiple directories and merges them with proper precedence.\n * \n * This is the main function for hierarchical configuration loading. It:\n * 1. Discovers configuration directories up the directory tree\n * 2. Loads configuration files from each discovered directory\n * 3. Merges them with proper precedence (closer directories win)\n * 4. Returns the merged configuration with metadata\n * \n * @param options Configuration options for hierarchical loading\n * @returns Promise resolving to hierarchical configuration result\n * \n * @example\n * ```typescript\n * const result = await loadHierarchicalConfig({\n *   configDirName: '.kodrdriv',\n *   configFileName: 'config.yaml',\n *   startingDir: '/project/subdir',\n *   maxLevels: 5,\n *   fieldOverlaps: {\n *     'features': 'append',\n *     'excludePatterns': 'prepend'\n *   }\n * });\n * \n * // result.config contains merged configuration with custom array merging\n * // result.discoveredDirs shows where configs were found\n * // result.errors contains any non-fatal errors\n * ```\n */\nexport async function loadHierarchicalConfig(\n    options: HierarchicalDiscoveryOptions\n): Promise<HierarchicalConfigResult> {\n    const { configFileName, encoding = 'utf8', logger, pathFields, resolvePathArray, fieldOverlaps } = options;\n\n    logger?.verbose('Starting hierarchical configuration loading');\n\n    // Discover all configuration directories\n    const discoveredDirs = await discoverConfigDirectories(options);\n\n    if (discoveredDirs.length === 0) {\n        logger?.verbose('No configuration directories found');\n        return {\n            config: {},\n            discoveredDirs: [],\n            errors: []\n        };\n    }\n\n    // Load configurations from each directory\n    const configs: object[] = [];\n    const errors: string[] = [];\n\n    // Sort by level (highest level first = lowest precedence first)\n    const sortedDirs = [...discoveredDirs].sort((a, b) => b.level - a.level);\n\n    for (const dir of sortedDirs) {\n        try {\n            const config = await loadConfigFromDirectory(\n                dir.path,\n                configFileName,\n                encoding,\n                logger,\n                pathFields,\n                resolvePathArray\n            );\n\n            if (config !== null) {\n                configs.push(config);\n                logger?.debug(`Loaded config from level ${dir.level}: ${dir.path}`);\n            } else {\n                logger?.debug(`No valid config found at level ${dir.level}: ${dir.path}`);\n            }\n        } catch (error: any) {\n            const errorMsg = `Failed to load config from ${dir.path}: ${error.message}`;\n            errors.push(errorMsg);\n            logger?.debug(errorMsg);\n        }\n    }\n\n    // Merge all configurations with proper precedence and configurable array overlap\n    const mergedConfig = deepMergeConfigs(configs, fieldOverlaps);\n\n    logger?.verbose(`Hierarchical loading complete. Merged ${configs.length} configurations`);\n\n    return {\n        config: mergedConfig,\n        discoveredDirs,\n        errors\n    };\n} ","import * as yaml from 'js-yaml';\nimport * as path from 'path';\nimport { z, ZodObject } from 'zod';\nimport { Args, ConfigSchema, Options } from './types';\nimport * as Storage from './util/storage';\nimport { loadHierarchicalConfig } from './util/hierarchical';\n\n/**\n * Removes undefined values from an object to create a clean configuration.\n * This is used to merge configuration sources while avoiding undefined pollution.\n * \n * @param obj - The object to clean\n * @returns A new object with undefined values filtered out\n */\nfunction clean(obj: any) {\n    return Object.fromEntries(\n        Object.entries(obj).filter(([_, v]) => v !== undefined)\n    );\n}\n\n/**\n * Resolves relative paths in configuration values relative to the configuration file's directory.\n * \n * @param config - The configuration object to process\n * @param configDir - The directory containing the configuration file\n * @param pathFields - Array of field names (using dot notation) that contain paths to be resolved\n * @param resolvePathArray - Array of field names whose array elements should all be resolved as paths\n * @returns The configuration object with resolved paths\n */\nfunction resolveConfigPaths(\n    config: any,\n    configDir: string,\n    pathFields: string[] = [],\n    resolvePathArray: string[] = []\n): any {\n    if (!config || typeof config !== 'object' || pathFields.length === 0) {\n        return config;\n    }\n\n    const resolvedConfig = { ...config };\n\n    for (const fieldPath of pathFields) {\n        const value = getNestedValue(resolvedConfig, fieldPath);\n        if (value !== undefined) {\n            const shouldResolveArrayElements = resolvePathArray.includes(fieldPath);\n            const resolvedValue = resolvePathValue(value, configDir, shouldResolveArrayElements);\n            setNestedValue(resolvedConfig, fieldPath, resolvedValue);\n        }\n    }\n\n    return resolvedConfig;\n}\n\n/**\n * Gets a nested value from an object using dot notation.\n */\nfunction getNestedValue(obj: any, path: string): any {\n    return path.split('.').reduce((current, key) => current?.[key], obj);\n}\n\n/**\n * Sets a nested value in an object using dot notation.\n */\nfunction setNestedValue(obj: any, path: string, value: any): void {\n    const keys = path.split('.');\n    const lastKey = keys.pop()!;\n    const target = keys.reduce((current, key) => {\n        if (!(key in current)) {\n            current[key] = {};\n        }\n        return current[key];\n    }, obj);\n    target[lastKey] = value;\n}\n\n/**\n * Resolves a path value (string or array of strings) relative to the config directory.\n */\nfunction resolvePathValue(value: any, configDir: string, resolveArrayElements: boolean): any {\n    if (typeof value === 'string') {\n        return resolveSinglePath(value, configDir);\n    }\n\n    if (Array.isArray(value) && resolveArrayElements) {\n        return value.map(item =>\n            typeof item === 'string' ? resolveSinglePath(item, configDir) : item\n        );\n    }\n\n    return value;\n}\n\n/**\n * Resolves a single path string relative to the config directory if it's a relative path.\n */\nfunction resolveSinglePath(pathStr: string, configDir: string): string {\n    if (!pathStr || path.isAbsolute(pathStr)) {\n        return pathStr;\n    }\n\n    return path.resolve(configDir, pathStr);\n}\n\n/**\n * Validates and secures a user-provided path to prevent path traversal attacks.\n * \n * Security checks include:\n * - Path traversal prevention (blocks '..')\n * - Absolute path detection\n * - Path separator validation\n * \n * @param userPath - The user-provided path component\n * @param basePath - The base directory to join the path with\n * @returns The safely joined and normalized path\n * @throws {Error} When path traversal or absolute paths are detected\n */\nfunction validatePath(userPath: string, basePath: string): string {\n    if (!userPath || !basePath) {\n        throw new Error('Invalid path parameters');\n    }\n\n    const normalized = path.normalize(userPath);\n\n    // Prevent path traversal attacks\n    if (normalized.includes('..') || path.isAbsolute(normalized)) {\n        throw new Error('Invalid path: path traversal detected');\n    }\n\n    // Ensure the path doesn't start with a path separator\n    if (normalized.startsWith('/') || normalized.startsWith('\\\\')) {\n        throw new Error('Invalid path: absolute path detected');\n    }\n\n    return path.join(basePath, normalized);\n}\n\n/**\n * Validates a configuration directory path for security and basic formatting.\n * \n * Performs validation to prevent:\n * - Null byte injection attacks\n * - Extremely long paths that could cause DoS\n * - Empty or invalid directory specifications\n * \n * @param configDir - The configuration directory path to validate\n * @returns The normalized configuration directory path\n * @throws {Error} When the directory path is invalid or potentially dangerous\n */\nfunction validateConfigDirectory(configDir: string): string {\n    if (!configDir) {\n        throw new Error('Configuration directory is required');\n    }\n\n    // Check for null bytes which could be used for path injection\n    if (configDir.includes('\\0')) {\n        throw new Error('Invalid path: null byte detected');\n    }\n\n    const normalized = path.normalize(configDir);\n\n    // Basic validation - could be expanded based on requirements\n    if (normalized.length > 1000) {\n        throw new Error('Configuration directory path too long');\n    }\n\n    return normalized;\n}\n\n/**\n * Reads configuration from files and merges it with CLI arguments.\n * \n * This function implements the core configuration loading logic:\n * 1. Validates and resolves the configuration directory path\n * 2. Attempts to read the YAML configuration file\n * 3. Safely parses the YAML content with security protections\n * 4. Merges file configuration with runtime arguments\n * 5. Returns a typed configuration object\n * \n * The function handles missing files gracefully and provides detailed\n * logging for troubleshooting configuration issues.\n * \n * @template T - The Zod schema shape type for configuration validation\n * @param args - Parsed command-line arguments containing potential config overrides\n * @param options - Cardigantime options with defaults, schema, and logger\n * @returns Promise resolving to the merged and typed configuration object\n * @throws {Error} When configuration directory is invalid or required files cannot be read\n * \n * @example\n * ```typescript\n * const config = await read(cliArgs, {\n *   defaults: { configDirectory: './config', configFile: 'app.yaml' },\n *   configShape: MySchema.shape,\n *   logger: console,\n *   features: ['config']\n * });\n * // config is fully typed based on your schema\n * ```\n */\nexport const read = async <T extends z.ZodRawShape>(args: Args, options: Options<T>): Promise<z.infer<ZodObject<T & typeof ConfigSchema.shape>>> => {\n    const logger = options.logger;\n\n    const rawConfigDir = args.configDirectory || options.defaults?.configDirectory;\n    if (!rawConfigDir) {\n        throw new Error('Configuration directory must be specified');\n    }\n\n    const resolvedConfigDir = validateConfigDirectory(rawConfigDir);\n    logger.verbose('Resolved config directory');\n\n    let rawFileConfig: object = {};\n\n    // Check if hierarchical configuration discovery is enabled\n    if (options.features.includes('hierarchical')) {\n        logger.verbose('Hierarchical configuration discovery enabled');\n\n        try {\n            // Extract the config directory name from the path for hierarchical discovery\n            const configDirName = path.basename(resolvedConfigDir);\n            const startingDir = path.dirname(resolvedConfigDir);\n\n            logger.debug(`Using hierarchical discovery: configDirName=${configDirName}, startingDir=${startingDir}`);\n\n            const hierarchicalResult = await loadHierarchicalConfig({\n                configDirName,\n                configFileName: options.defaults.configFile,\n                startingDir,\n                encoding: options.defaults.encoding,\n                logger,\n                pathFields: options.defaults.pathResolution?.pathFields,\n                resolvePathArray: options.defaults.pathResolution?.resolvePathArray,\n                fieldOverlaps: options.defaults.fieldOverlaps\n            });\n\n            rawFileConfig = hierarchicalResult.config;\n\n            if (hierarchicalResult.discoveredDirs.length > 0) {\n                logger.verbose(`Hierarchical discovery found ${hierarchicalResult.discoveredDirs.length} configuration directories`);\n                hierarchicalResult.discoveredDirs.forEach(dir => {\n                    logger.debug(`  Level ${dir.level}: ${dir.path}`);\n                });\n            } else {\n                logger.verbose('No configuration directories found in hierarchy');\n            }\n\n            if (hierarchicalResult.errors.length > 0) {\n                hierarchicalResult.errors.forEach(error => logger.warn(`Hierarchical config warning: ${error}`));\n            }\n\n        } catch (error: any) {\n            logger.error('Hierarchical configuration loading failed: ' + (error.message || 'Unknown error'));\n            // Fall back to single directory mode\n            logger.verbose('Falling back to single directory configuration loading');\n            rawFileConfig = await loadSingleDirectoryConfig(resolvedConfigDir, options, logger);\n        }\n    } else {\n        // Use traditional single directory configuration loading\n        logger.verbose('Using single directory configuration loading');\n        rawFileConfig = await loadSingleDirectoryConfig(resolvedConfigDir, options, logger);\n    }\n\n    // Apply path resolution if configured\n    let processedConfig = rawFileConfig;\n    if (options.defaults.pathResolution?.pathFields) {\n        processedConfig = resolveConfigPaths(\n            rawFileConfig,\n            resolvedConfigDir,\n            options.defaults.pathResolution.pathFields,\n            options.defaults.pathResolution.resolvePathArray || []\n        );\n    }\n\n    const config: z.infer<ZodObject<T & typeof ConfigSchema.shape>> = clean({\n        ...processedConfig,\n        ...{\n            configDirectory: resolvedConfigDir,\n        }\n    }) as z.infer<ZodObject<T & typeof ConfigSchema.shape>>;\n\n    return config;\n}\n\n/**\n * Loads configuration from a single directory (traditional mode).\n * \n * @param resolvedConfigDir - The resolved configuration directory path\n * @param options - Cardigantime options\n * @param logger - Logger instance\n * @returns Promise resolving to the configuration object\n */\nasync function loadSingleDirectoryConfig<T extends z.ZodRawShape>(\n    resolvedConfigDir: string,\n    options: Options<T>,\n    logger: any\n): Promise<object> {\n    const storage = Storage.create({ log: logger.debug });\n    const configFile = validatePath(options.defaults.configFile, resolvedConfigDir);\n    logger.verbose('Attempting to load config file for cardigantime');\n\n    let rawFileConfig: object = {};\n\n    try {\n        const yamlContent = await storage.readFile(configFile, options.defaults.encoding);\n\n        // SECURITY FIX: Use safer parsing options to prevent code execution vulnerabilities\n        const parsedYaml = yaml.load(yamlContent);\n\n        if (parsedYaml !== null && typeof parsedYaml === 'object') {\n            rawFileConfig = parsedYaml;\n            logger.verbose('Loaded configuration file successfully');\n        } else if (parsedYaml !== null) {\n            logger.warn('Ignoring invalid configuration format. Expected an object, got ' + typeof parsedYaml);\n        }\n    } catch (error: any) {\n        if (error.code === 'ENOENT' || /not found|no such file/i.test(error.message)) {\n            logger.verbose('Configuration file not found. Using empty configuration.');\n        } else {\n            // SECURITY FIX: Don't expose internal paths or detailed error information\n            logger.error('Failed to load or parse configuration file: ' + (error.message || 'Unknown error'));\n        }\n    }\n\n    return rawFileConfig;\n}","/**\n * Error thrown when configuration validation fails\n */\nexport class ConfigurationError extends Error {\n    public readonly errorType: 'validation' | 'schema' | 'extra_keys';\n    public readonly details?: any;\n    public readonly configPath?: string;\n\n    constructor(\n        errorType: 'validation' | 'schema' | 'extra_keys',\n        message: string,\n        details?: any,\n        configPath?: string\n    ) {\n        super(message);\n        this.name = 'ConfigurationError';\n        this.errorType = errorType;\n        this.details = details;\n        this.configPath = configPath;\n    }\n\n    /**\n     * Creates a validation error for when config doesn't match the schema\n     */\n    static validation(message: string, zodError?: any, configPath?: string): ConfigurationError {\n        return new ConfigurationError('validation', message, zodError, configPath);\n    }\n\n    /**\n     * Creates an error for when extra/unknown keys are found\n     */\n    static extraKeys(extraKeys: string[], allowedKeys: string[], configPath?: string): ConfigurationError {\n        const message = `Unknown configuration keys found: ${extraKeys.join(', ')}. Allowed keys are: ${allowedKeys.join(', ')}`;\n        return new ConfigurationError('extra_keys', message, { extraKeys, allowedKeys }, configPath);\n    }\n\n    /**\n     * Creates a schema error for when the configuration schema itself is invalid\n     */\n    static schema(message: string, details?: any): ConfigurationError {\n        return new ConfigurationError('schema', message, details);\n    }\n} ","import { Command } from \"commander\";\nimport { ZodObject } from \"zod\";\n\nimport { z } from \"zod\";\n\n/**\n * Available features that can be enabled in Cardigantime.\n * Currently supports:\n * - 'config': Configuration file reading and validation\n * - 'hierarchical': Hierarchical configuration discovery and layering\n */\nexport type Feature = 'config' | 'hierarchical';\n\n/**\n * Defines how array fields should be merged in hierarchical configurations.\n * \n * - 'override': Higher precedence arrays completely replace lower precedence arrays (default)\n * - 'append': Higher precedence array elements are appended to lower precedence arrays\n * - 'prepend': Higher precedence array elements are prepended to lower precedence arrays\n */\nexport type ArrayOverlapMode = 'override' | 'append' | 'prepend';\n\n/**\n * Configuration for how fields should be merged in hierarchical configurations.\n * Maps field names (using dot notation) to their overlap behavior.\n * \n * @example\n * ```typescript\n * const fieldOverlaps: FieldOverlapOptions = {\n *   'features': 'append',           // features arrays will be combined by appending\n *   'api.endpoints': 'prepend',     // nested endpoint arrays will be combined by prepending\n *   'excludePatterns': 'override'   // excludePatterns arrays will replace each other (default behavior)\n * };\n * ```\n */\nexport interface FieldOverlapOptions {\n    [fieldPath: string]: ArrayOverlapMode;\n}\n\n/**\n * Configuration for resolving relative paths in configuration values.\n * Paths specified in these fields will be resolved relative to the configuration file's directory.\n */\nexport interface PathResolutionOptions {\n    /** Array of field names (using dot notation) that contain paths to be resolved */\n    pathFields?: string[];\n    /** Array of field names whose array elements should all be resolved as paths */\n    resolvePathArray?: string[];\n}\n\n/**\n * Default configuration options for Cardigantime.\n * These define the basic behavior of configuration loading.\n */\nexport interface DefaultOptions {\n    /** Directory path where configuration files are located */\n    configDirectory: string;\n    /** Name of the configuration file (e.g., 'config.yaml', 'app.yml') */\n    configFile: string;\n    /** Whether the configuration directory must exist. If true, throws error if directory doesn't exist */\n    isRequired: boolean;\n    /** File encoding for reading configuration files (e.g., 'utf8', 'ascii') */\n    encoding: string;\n    /** Configuration for resolving relative paths in configuration values */\n    pathResolution?: PathResolutionOptions;\n    /** \n     * Configuration for how array fields should be merged in hierarchical mode.\n     * Only applies when the 'hierarchical' feature is enabled.\n     * If not specified, all arrays use 'override' behavior (default).\n     */\n    fieldOverlaps?: FieldOverlapOptions;\n}\n\n/**\n * Complete options object passed to Cardigantime functions.\n * Combines defaults, features, schema shape, and logger.\n * \n * @template T - The Zod schema shape type for configuration validation\n */\nexport interface Options<T extends z.ZodRawShape> {\n    /** Default configuration options */\n    defaults: DefaultOptions,\n    /** Array of enabled features */\n    features: Feature[],\n    /** Zod schema shape for validating user configuration */\n    configShape: T;\n    /** Logger instance for debugging and error reporting */\n    logger: Logger;\n}\n\n/**\n * Logger interface for Cardigantime's internal logging.\n * Compatible with popular logging libraries like Winston, Bunyan, etc.\n */\nexport interface Logger {\n    /** Debug-level logging for detailed troubleshooting information */\n    debug: (message: string, ...args: any[]) => void;\n    /** Info-level logging for general information */\n    info: (message: string, ...args: any[]) => void;\n    /** Warning-level logging for non-critical issues */\n    warn: (message: string, ...args: any[]) => void;\n    /** Error-level logging for critical problems */\n    error: (message: string, ...args: any[]) => void;\n    /** Verbose-level logging for extensive detail */\n    verbose: (message: string, ...args: any[]) => void;\n    /** Silly-level logging for maximum detail */\n    silly: (message: string, ...args: any[]) => void;\n}\n\n/**\n * Main Cardigantime interface providing configuration management functionality.\n * \n * @template T - The Zod schema shape type for configuration validation\n */\nexport interface Cardigantime<T extends z.ZodRawShape> {\n    /** \n     * Adds Cardigantime's CLI options to a Commander.js command.\n     * This includes options like --config-directory for runtime config path overrides.\n     */\n    configure: (command: Command) => Promise<Command>;\n    /** Sets a custom logger for debugging and error reporting */\n    setLogger: (logger: Logger) => void;\n    /** \n     * Reads configuration from files and merges with CLI arguments.\n     * Returns a fully typed configuration object.\n     */\n    read: (args: Args) => Promise<z.infer<ZodObject<T & typeof ConfigSchema.shape>>>;\n    /** \n     * Validates the merged configuration against the Zod schema.\n     * Throws ConfigurationError if validation fails.\n     */\n    validate: (config: z.infer<ZodObject<T & typeof ConfigSchema.shape>>) => Promise<void>;\n}\n\n/**\n * Parsed command-line arguments object, typically from Commander.js opts().\n * Keys correspond to CLI option names with values from user input.\n */\nexport interface Args {\n    [key: string]: any;\n}\n\n/**\n * Base Zod schema for core Cardigantime configuration.\n * Contains the minimum required configuration fields.\n */\nexport const ConfigSchema = z.object({\n    /** The resolved configuration directory path */\n    configDirectory: z.string(),\n});\n\n/**\n * Base configuration type derived from the core schema.\n */\nexport type Config = z.infer<typeof ConfigSchema>;\n","import { z, ZodObject } from \"zod\";\nimport { ArgumentError } from \"./error/ArgumentError\";\nimport { ConfigurationError } from \"./error/ConfigurationError\";\nimport { FileSystemError } from \"./error/FileSystemError\";\nimport { ConfigSchema, Logger, Options } from \"./types\";\nimport * as Storage from \"./util/storage\";\nexport { ArgumentError, ConfigurationError, FileSystemError };\n\n/**\n * Recursively extracts all keys from a Zod schema in dot notation.\n * \n * This function traverses a Zod schema structure and builds a flat list\n * of all possible keys, using dot notation for nested objects. It handles\n * optional/nullable types by unwrapping them and supports arrays by\n * introspecting their element type.\n * \n * Special handling for:\n * - ZodOptional/ZodNullable: Unwraps to get the underlying type\n * - ZodAny/ZodRecord: Accepts any keys, returns the prefix or empty array\n * - ZodArray: Introspects the element type\n * - ZodObject: Recursively processes all shape properties\n * \n * @param schema - The Zod schema to introspect\n * @param prefix - Internal parameter for building nested key paths\n * @returns Array of strings representing all possible keys in dot notation\n * \n * @example\n * ```typescript\n * const schema = z.object({\n *   user: z.object({\n *     name: z.string(),\n *     settings: z.object({ theme: z.string() })\n *   }),\n *   debug: z.boolean()\n * });\n * \n * const keys = listZodKeys(schema);\n * // Returns: ['user.name', 'user.settings.theme', 'debug']\n * ```\n */\nexport const listZodKeys = (schema: z.ZodTypeAny, prefix = ''): string[] => {\n    // Check if schema has unwrap method (which both ZodOptional and ZodNullable have)\n    if (schema._def && (schema._def.typeName === 'ZodOptional' || schema._def.typeName === 'ZodNullable')) {\n        // Use type assertion to handle the unwrap method\n        const unwrappable = schema as z.ZodOptional<any> | z.ZodNullable<any>;\n        return listZodKeys(unwrappable.unwrap(), prefix);\n    }\n\n    // Handle ZodAny and ZodRecord - these accept any keys, so don't introspect\n    if (schema._def && (schema._def.typeName === 'ZodAny' || schema._def.typeName === 'ZodRecord')) {\n        return prefix ? [prefix] : [];\n    }\n\n    if (schema._def && schema._def.typeName === 'ZodArray') {\n        // Use type assertion to handle the element property\n        const arraySchema = schema as z.ZodArray<any>;\n        return listZodKeys(arraySchema.element, prefix);\n    }\n    if (schema._def && schema._def.typeName === 'ZodObject') {\n        // Use type assertion to handle the shape property\n        const objectSchema = schema as z.ZodObject<any>;\n        return Object.entries(objectSchema.shape).flatMap(([key, subschema]) => {\n            const fullKey = prefix ? `${prefix}.${key}` : key;\n            const nested = listZodKeys(subschema as z.ZodTypeAny, fullKey);\n            return nested.length ? nested : fullKey;\n        });\n    }\n    return [];\n}\n\n/**\n * Type guard to check if a value is a plain object (not array, null, or other types).\n * \n * @param value - The value to check\n * @returns True if the value is a plain object\n */\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n    // Check if it's an object, not null, and not an array.\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n};\n\n/**\n * Generates a list of all keys within a JavaScript object, using dot notation for nested keys.\n * Mimics the behavior of listZodKeys but operates on plain objects.\n * For arrays, it inspects the first element that is a plain object to determine nested keys.\n * If an array contains no plain objects, or is empty, the key for the array itself is listed.\n *\n * @param obj The object to introspect.\n * @param prefix Internal use for recursion: the prefix for the current nesting level.\n * @returns An array of strings representing all keys in dot notation.\n */\nexport const listObjectKeys = (obj: Record<string, unknown>, prefix = ''): string[] => {\n    const keys = new Set<string>(); // Use Set to automatically handle duplicates from array recursion\n\n    for (const key in obj) {\n        // Ensure it's an own property, not from the prototype chain\n        if (Object.prototype.hasOwnProperty.call(obj, key)) {\n            const value = obj[key];\n            const fullKey = prefix ? `${prefix}.${key}` : key;\n\n            if (Array.isArray(value)) {\n                // Find the first element that is a plain object to determine structure\n                const firstObjectElement = value.find(isPlainObject);\n                if (firstObjectElement) {\n                    // Recurse into the structure of the first object element found\n                    const nestedKeys = listObjectKeys(firstObjectElement, fullKey);\n                    nestedKeys.forEach(k => keys.add(k));\n                } else {\n                    // Array is empty or contains no plain objects, list the array key itself\n                    keys.add(fullKey);\n                }\n            } else if (isPlainObject(value)) {\n                // Recurse into nested plain objects\n                const nestedKeys = listObjectKeys(value, fullKey);\n                nestedKeys.forEach(k => keys.add(k));\n            } else {\n                // It's a primitive, null, or other non-plain object/array type\n                keys.add(fullKey);\n            }\n        }\n    }\n    return Array.from(keys); // Convert Set back to Array\n};\n\n/**\n * Validates that the configuration object contains only keys allowed by the schema.\n * \n * This function prevents configuration errors by detecting typos or extra keys\n * that aren't defined in the Zod schema. It intelligently handles:\n * - ZodRecord types that accept arbitrary keys\n * - Nested objects and their key structures\n * - Arrays and their element key structures\n * \n * The function throws a ConfigurationError if extra keys are found, providing\n * helpful information about what keys are allowed vs. what was found.\n * \n * @param mergedSources - The merged configuration object to validate\n * @param fullSchema - The complete Zod schema including base and user schemas\n * @param logger - Logger for error reporting\n * @throws {ConfigurationError} When extra keys are found that aren't in the schema\n * \n * @example\n * ```typescript\n * const schema = z.object({ name: z.string(), age: z.number() });\n * const config = { name: 'John', age: 30, typo: 'invalid' };\n * \n * checkForExtraKeys(config, schema, console);\n * // Throws: ConfigurationError with details about 'typo' being an extra key\n * ```\n */\nexport const checkForExtraKeys = (mergedSources: object, fullSchema: ZodObject<any>, logger: Logger | typeof console): void => {\n    const allowedKeys = new Set(listZodKeys(fullSchema));\n    const actualKeys = listObjectKeys(mergedSources as Record<string, unknown>);\n\n    // Filter out keys that are under a record type (ZodRecord accepts any keys)\n    const recordPrefixes = new Set<string>();\n\n    // Find all prefixes that are ZodRecord types\n    const findRecordPrefixes = (schema: z.ZodTypeAny, prefix = ''): void => {\n        if (schema._def && (schema._def.typeName === 'ZodOptional' || schema._def.typeName === 'ZodNullable')) {\n            const unwrappable = schema as z.ZodOptional<any> | z.ZodNullable<any>;\n            findRecordPrefixes(unwrappable.unwrap(), prefix);\n            return;\n        }\n\n        if (schema._def && (schema._def.typeName === 'ZodAny' || schema._def.typeName === 'ZodRecord')) {\n            if (prefix) recordPrefixes.add(prefix);\n            return;\n        }\n\n        if (schema._def && schema._def.typeName === 'ZodObject') {\n            const objectSchema = schema as z.ZodObject<any>;\n            Object.entries(objectSchema.shape).forEach(([key, subschema]) => {\n                const fullKey = prefix ? `${prefix}.${key}` : key;\n                findRecordPrefixes(subschema as z.ZodTypeAny, fullKey);\n            });\n        }\n    };\n\n    findRecordPrefixes(fullSchema);\n\n    // Filter out keys that are under record prefixes\n    const extraKeys = actualKeys.filter(key => {\n        if (allowedKeys.has(key)) return false;\n\n        // Check if this key is under a record prefix\n        for (const recordPrefix of recordPrefixes) {\n            if (key.startsWith(recordPrefix + '.')) {\n                return false; // This key is allowed under a record\n            }\n        }\n\n        return true; // This is an extra key\n    });\n\n    if (extraKeys.length > 0) {\n        const allowedKeysArray = Array.from(allowedKeys);\n        const error = ConfigurationError.extraKeys(extraKeys, allowedKeysArray);\n        logger.error(error.message);\n        throw error;\n    }\n}\n\n/**\n * Validates that a configuration directory exists and is accessible.\n * \n * This function performs file system checks to ensure the configuration\n * directory can be used. It handles the isRequired flag to determine\n * whether a missing directory should cause an error or be silently ignored.\n * \n * @param configDirectory - Path to the configuration directory\n * @param isRequired - Whether the directory must exist\n * @param logger - Optional logger for debug information\n * @throws {FileSystemError} When the directory is required but missing or unreadable\n */\nconst validateConfigDirectory = async (configDirectory: string, isRequired: boolean, logger?: Logger): Promise<void> => {\n    const storage = Storage.create({ log: logger?.debug || (() => { }) });\n    const exists = await storage.exists(configDirectory);\n    if (!exists) {\n        if (isRequired) {\n            throw FileSystemError.directoryNotFound(configDirectory, true);\n        }\n    } else if (exists) {\n        const isReadable = await storage.isDirectoryReadable(configDirectory);\n        if (!isReadable) {\n            throw FileSystemError.directoryNotReadable(configDirectory);\n        }\n    }\n}\n\n/**\n * Validates a configuration object against the combined Zod schema.\n * \n * This is the main validation function that:\n * 1. Validates the configuration directory (if config feature enabled)\n * 2. Combines the base ConfigSchema with user-provided schema shape\n * 3. Checks for extra keys not defined in the schema\n * 4. Validates all values against their schema definitions\n * 5. Provides detailed error reporting for validation failures\n * \n * The validation is comprehensive and catches common configuration errors\n * including typos, missing required fields, wrong types, and invalid values.\n * \n * @template T - The Zod schema shape type for configuration validation\n * @param config - The merged configuration object to validate\n * @param options - Cardigantime options containing schema, defaults, and logger\n * @throws {ConfigurationError} When configuration validation fails\n * @throws {FileSystemError} When configuration directory validation fails\n * \n * @example\n * ```typescript\n * const schema = z.object({\n *   apiKey: z.string().min(1),\n *   timeout: z.number().positive(),\n * });\n * \n * await validate(config, {\n *   configShape: schema.shape,\n *   defaults: { configDirectory: './config', isRequired: true },\n *   logger: console,\n *   features: ['config']\n * });\n * // Throws detailed errors if validation fails\n * ```\n */\nexport const validate = async <T extends z.ZodRawShape>(config: z.infer<ZodObject<T & typeof ConfigSchema.shape>>, options: Options<T>): Promise<void> => {\n    const logger = options.logger;\n\n    if (options.features.includes('config') && config.configDirectory) {\n        await validateConfigDirectory(config.configDirectory, options.defaults.isRequired, logger);\n    }\n\n    // Combine the base schema with the user-provided shape\n    const fullSchema = z.object({\n        ...ConfigSchema.shape,\n        ...options.configShape,\n    });\n\n    // Validate the merged sources against the full schema\n    const validationResult = fullSchema.safeParse(config);\n\n    // Check for extraneous keys\n    checkForExtraKeys(config, fullSchema, logger);\n\n    if (!validationResult.success) {\n        const formattedError = JSON.stringify(validationResult.error.format(), null, 2);\n        logger.error('Configuration validation failed. Check logs for details.');\n        logger.silly('Configuration validation failed: %s', formattedError);\n        throw ConfigurationError.validation('Configuration validation failed. Check logs for details.', validationResult.error);\n    }\n\n    return;\n}\n\n","import { Command } from 'commander';\nimport { Args, DefaultOptions, Feature, Cardigantime, Logger, Options } from 'types';\nimport { z, ZodObject } from 'zod';\nimport { configure } from './configure';\nimport { DEFAULT_FEATURES, DEFAULT_LOGGER, DEFAULT_OPTIONS } from './constants';\nimport { read } from './read';\nimport { ConfigSchema } from 'types';\nimport { validate } from './validate';\n\nexport * from './types';\nexport { ArgumentError, ConfigurationError, FileSystemError } from './validate';\n\n/**\n * Creates a new Cardigantime instance for configuration management.\n * \n * Cardigantime handles the complete configuration lifecycle including:\n * - Reading configuration from YAML files\n * - Validating configuration against Zod schemas\n * - Merging CLI arguments with file configuration and defaults\n * - Providing type-safe configuration objects\n * \n * @template T - The Zod schema shape type for your configuration\n * @param pOptions - Configuration options for the Cardigantime instance\n * @param pOptions.defaults - Default configuration settings\n * @param pOptions.defaults.configDirectory - Directory to search for configuration files (required)\n * @param pOptions.defaults.configFile - Name of the configuration file (optional, defaults to 'config.yaml')\n * @param pOptions.defaults.isRequired - Whether the config directory must exist (optional, defaults to false)\n * @param pOptions.defaults.encoding - File encoding for reading config files (optional, defaults to 'utf8')\n * @param pOptions.defaults.pathResolution - Configuration for resolving relative paths in config values relative to the config file's directory (optional)\n * @param pOptions.features - Array of features to enable (optional, defaults to ['config'])\n * @param pOptions.configShape - Zod schema shape defining your configuration structure (required)\n * @param pOptions.logger - Custom logger implementation (optional, defaults to console logger)\n * @returns A Cardigantime instance with methods for configure, read, validate, and setLogger\n * \n * @example\n * ```typescript\n * import { create } from '@theunwalked/cardigantime';\n * import { z } from 'zod';\n * \n * const MyConfigSchema = z.object({\n *   apiKey: z.string().min(1),\n *   timeout: z.number().default(5000),\n *   debug: z.boolean().default(false),\n *   contextDirectories: z.array(z.string()).optional(),\n * });\n * \n * const cardigantime = create({\n *   defaults: {\n *     configDirectory: './config',\n *     configFile: 'myapp.yaml',\n *     // Resolve relative paths in contextDirectories relative to config file location\n *     pathResolution: {\n *       pathFields: ['contextDirectories'],\n *       resolvePathArray: ['contextDirectories']\n *     },\n *     // Configure how array fields are merged in hierarchical mode\n *     fieldOverlaps: {\n *       'features': 'append',              // Accumulate features from all levels\n *       'excludePatterns': 'prepend'       // Higher precedence patterns come first\n *     }\n *   },\n *   configShape: MyConfigSchema.shape,\n *   features: ['config', 'hierarchical'],   // Enable hierarchical discovery\n * });\n * \n * // If config file is at ../config/myapp.yaml and contains:\n * // contextDirectories: ['./context', './data']\n * // These paths will be resolved relative to ../config/ directory\n * ```\n */\nexport const create = <T extends z.ZodRawShape>(pOptions: {\n    defaults: Pick<DefaultOptions, 'configDirectory'> & Partial<Omit<DefaultOptions, 'configDirectory'>>,\n    features?: Feature[],\n    configShape: T, // Make configShape mandatory\n    logger?: Logger,\n}): Cardigantime<T> => {\n\n\n    const defaults: DefaultOptions = { ...DEFAULT_OPTIONS, ...pOptions.defaults } as DefaultOptions;\n    const features = pOptions.features || DEFAULT_FEATURES;\n    const configShape = pOptions.configShape;\n    let logger = pOptions.logger || DEFAULT_LOGGER;\n\n    const options: Options<T> = {\n        defaults,\n        features,\n        configShape, // Store the shape\n        logger,\n    }\n\n    const setLogger = (pLogger: Logger) => {\n        logger = pLogger;\n        options.logger = pLogger;\n    }\n\n    return {\n        setLogger,\n        configure: (command: Command) => configure(command, options),\n        validate: (config: z.infer<ZodObject<T & typeof ConfigSchema.shape>>) => validate(config, options),\n        read: (args: Args) => read(args, options),\n    }\n}\n\n\n\n\n\n"],"names":["_define_property","ArgumentError","Error","argument","argumentName","message","name","validateConfigDirectory","configDirectory","_testThrowNonArgumentError","trimmed","trim","length","includes","configure","command","options","option","defaults","validatedDefaultDir","retCommand","value","error","DEFAULT_ENCODING","DEFAULT_CONFIG_FILE","DEFAULT_OPTIONS","configFile","isRequired","encoding","pathResolution","undefined","DEFAULT_FEATURES","DEFAULT_LOGGER","debug","console","info","warn","verbose","silly","FileSystemError","directoryNotFound","path","directoryNotReadable","directoryCreationFailed","originalError","operationFailed","operation","fileNotFound","errorType","create","params","log","exists","fs","promises","stat","isDirectory","stats","isFile","isReadable","access","constants","R_OK","stack","isWritable","W_OK","isFileReadable","isDirectoryWritable","isDirectoryReadable","createDirectory","mkdir","recursive","mkdirError","readFile","validEncodings","toLowerCase","maxFileSize","size","code","writeFile","data","forEachFileIn","directory","callback","pattern","files","glob","cwd","nodir","file","join","err","readStream","createReadStream","hashFile","crypto","createHash","update","digest","slice","listFiles","readdir","resolveConfigPaths","config","configDir","pathFields","resolvePathArray","resolvedConfig","fieldPath","getNestedValue","shouldResolveArrayElements","resolvedValue","resolvePathValue","setNestedValue","obj","split","reduce","current","key","keys","lastKey","pop","target","resolveArrayElements","resolveSinglePath","Array","isArray","map","item","pathStr","isAbsolute","resolve","discoverConfigDirectories","configDirName","maxLevels","startingDir","process","logger","storage","createStorage","discoveredDirs","currentDir","level","visited","Set","realPath","has","add","configDirPath","push","parentDir","dirname","loadConfigFromDirectory","configFileName","configFilePath","yamlContent","parsedYaml","yaml","load","deepMergeConfigs","configs","fieldOverlaps","merged","deepMergeTwo","source","currentPath","overlapMode","getOverlapModeForPath","mergeArrays","result","Object","prototype","hasOwnProperty","call","pathParts","i","parentPath","targetArray","sourceArray","mode","loadHierarchicalConfig","errors","sortedDirs","sort","a","b","dir","errorMsg","mergedConfig","clean","fromEntries","entries","filter","_","v","validatePath","userPath","basePath","normalized","normalize","startsWith","read","args","rawConfigDir","resolvedConfigDir","rawFileConfig","features","basename","hierarchicalResult","forEach","loadSingleDirectoryConfig","processedConfig","Storage","test","ConfigurationError","validation","zodError","configPath","extraKeys","allowedKeys","schema","details","ConfigSchema","z","object","string","listZodKeys","prefix","_def","typeName","unwrappable","unwrap","arraySchema","element","objectSchema","shape","flatMap","subschema","fullKey","nested","isPlainObject","listObjectKeys","firstObjectElement","find","nestedKeys","k","from","checkForExtraKeys","mergedSources","fullSchema","actualKeys","recordPrefixes","findRecordPrefixes","recordPrefix","allowedKeysArray","validate","configShape","validationResult","safeParse","success","formattedError","JSON","stringify","format","pOptions","setLogger","pLogger"],"mappings":"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"}

package/dist/cardigantime.d.ts

@@ -18,6 +18,7 @@ export { ArgumentError, ConfigurationError, FileSystemError } from './validate';
  * @param pOptions.defaults.configFile - Name of the configuration file (optional, defaults to 'config.yaml')
  * @param pOptions.defaults.isRequired - Whether the config directory must exist (optional, defaults to false)
  * @param pOptions.defaults.encoding - File encoding for reading config files (optional, defaults to 'utf8')
+ * @param pOptions.defaults.pathResolution - Configuration for resolving relative paths in config values relative to the config file's directory (optional)
  * @param pOptions.features - Array of features to enable (optional, defaults to ['config'])
  * @param pOptions.configShape - Zod schema shape defining your configuration structure (required)
  * @param pOptions.logger - Custom logger implementation (optional, defaults to console logger)
@@ -32,15 +33,31 @@ export { ArgumentError, ConfigurationError, FileSystemError } from './validate';
  *   apiKey: z.string().min(1),
  *   timeout: z.number().default(5000),
  *   debug: z.boolean().default(false),
+ *   contextDirectories: z.array(z.string()).optional(),
  * });
  *
  * const cardigantime = create({
  *   defaults: {
  *     configDirectory: './config',
  *     configFile: 'myapp.yaml',
+ *     // Resolve relative paths in contextDirectories relative to config file location
+ *     pathResolution: {
+ *       pathFields: ['contextDirectories'],
+ *       resolvePathArray: ['contextDirectories']
+ *     },
+ *     // Configure how array fields are merged in hierarchical mode
+ *     fieldOverlaps: {
+ *       'features': 'append',              // Accumulate features from all levels
+ *       'excludePatterns': 'prepend'       // Higher precedence patterns come first
+ *     }
  *   },
  *   configShape: MyConfigSchema.shape,
+ *   features: ['config', 'hierarchical'],   // Enable hierarchical discovery
  * });
+ *
+ * // If config file is at ../config/myapp.yaml and contains:
+ * // contextDirectories: ['./context', './data']
+ * // These paths will be resolved relative to ../config/ directory
  * ```
  */
 export declare const create: <T extends z.ZodRawShape>(pOptions: {

package/dist/cardigantime.js

@@ -23,6 +23,7 @@ export { FileSystemError } from './error/FileSystemError.js';
  * @param pOptions.defaults.configFile - Name of the configuration file (optional, defaults to 'config.yaml')
  * @param pOptions.defaults.isRequired - Whether the config directory must exist (optional, defaults to false)
  * @param pOptions.defaults.encoding - File encoding for reading config files (optional, defaults to 'utf8')
+ * @param pOptions.defaults.pathResolution - Configuration for resolving relative paths in config values relative to the config file's directory (optional)
  * @param pOptions.features - Array of features to enable (optional, defaults to ['config'])
  * @param pOptions.configShape - Zod schema shape defining your configuration structure (required)
  * @param pOptions.logger - Custom logger implementation (optional, defaults to console logger)
@@ -37,15 +38,31 @@ export { FileSystemError } from './error/FileSystemError.js';
  *   apiKey: z.string().min(1),
  *   timeout: z.number().default(5000),
  *   debug: z.boolean().default(false),
+ *   contextDirectories: z.array(z.string()).optional(),
  * });
  * 
  * const cardigantime = create({
  *   defaults: {
  *     configDirectory: './config',
  *     configFile: 'myapp.yaml',
+ *     // Resolve relative paths in contextDirectories relative to config file location
+ *     pathResolution: {
+ *       pathFields: ['contextDirectories'],
+ *       resolvePathArray: ['contextDirectories']
+ *     },
+ *     // Configure how array fields are merged in hierarchical mode
+ *     fieldOverlaps: {
+ *       'features': 'append',              // Accumulate features from all levels
+ *       'excludePatterns': 'prepend'       // Higher precedence patterns come first
+ *     }
  *   },
  *   configShape: MyConfigSchema.shape,
+ *   features: ['config', 'hierarchical'],   // Enable hierarchical discovery
  * });
+ * 
+ * // If config file is at ../config/myapp.yaml and contains:
+ * // contextDirectories: ['./context', './data']
+ * // These paths will be resolved relative to ../config/ directory
  * ```
  */ const create = (pOptions)=>{
     const defaults = {