@theunwalked/cardigantime 0.0.1 → 0.0.3

package/dist/cardigantime.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cardigantime.cjs","sources":["../src/cardigantime.ts"],"sourcesContent":["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';\n\n// Make create function generic\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":["create","pOptions","defaults","DEFAULT_OPTIONS","features","DEFAULT_FEATURES","configShape","logger","DEFAULT_LOGGER","options","setLogger","pLogger","configure","command","validate","config","read","args"],"mappings":";;;;;;;;;;AAWA;AACO,MAAMA,SAAS,CAA0BC,QAAAA,GAAAA;AAQ5C,IAAA,MAAMC,QAA2B,GAAA;AAAE,QAAA,GAAGC,yBAAe;AAAE,QAAA,GAAGF,SAASC;AAAS,KAAA;IAC5E,MAAME,QAAAA,GAAWH,QAASG,CAAAA,QAAQ,IAAIC,0BAAAA;IACtC,MAAMC,WAAAA,GAAcL,SAASK,WAAW;IACxC,IAAIC,MAAAA,GAASN,QAASM,CAAAA,MAAM,IAAIC,wBAAAA;AAEhC,IAAA,MAAMC,OAAsB,GAAA;AACxBP,QAAAA,QAAAA;AACAE,QAAAA,QAAAA;AACAE,QAAAA,WAAAA;AACAC,QAAAA;AACJ,KAAA;AAEA,IAAA,MAAMG,YAAY,CAACC,OAAAA,GAAAA;QACfJ,MAASI,GAAAA,OAAAA;AACTF,QAAAA,OAAAA,CAAQF,MAAM,GAAGI,OAAAA;AACrB,KAAA;IAEA,OAAO;AACHD,QAAAA,SAAAA;QACAE,SAAW,EAAA,CAACC,OAAqBD,GAAAA,mBAAAA,CAAUC,OAASJ,EAAAA,OAAAA,CAAAA;QACpDK,QAAU,EAAA,CAACC,MAA8DD,GAAAA,iBAAAA,CAASC,MAAQN,EAAAA,OAAAA,CAAAA;QAC1FO,IAAM,EAAA,CAACC,IAAeD,GAAAA,SAAAA,CAAKC,IAAMR,EAAAA,OAAAA;AACrC,KAAA;AACJ;;;;;"}
+{"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/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 * 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';\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    const storage = Storage.create({ log: logger.debug });\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.debug('Resolved config directory');\n\n    const configFile = validatePath(options.defaults.configFile, resolvedConfigDir);\n    logger.debug('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.debug('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.debug('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    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 * 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 */\nexport type Feature = 'config';\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: %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","clean","obj","Object","fromEntries","entries","filter","_","v","undefined","validatePath","userPath","basePath","normalized","normalize","isAbsolute","startsWith","configDir","read","args","logger","storage","Storage","rawConfigDir","resolvedConfigDir","rawFileConfig","yamlContent","parsedYaml","yaml","load","test","config","ConfigurationError","validation","zodError","configPath","extraKeys","allowedKeys","schema","details","ConfigSchema","z","object","string","listZodKeys","prefix","_def","typeName","unwrappable","unwrap","arraySchema","element","objectSchema","shape","flatMap","key","subschema","fullKey","nested","isPlainObject","Array","isArray","listObjectKeys","keys","Set","prototype","hasOwnProperty","call","firstObjectElement","find","nestedKeys","forEach","k","add","from","checkForExtraKeys","mergedSources","fullSchema","actualKeys","recordPrefixes","findRecordPrefixes","has","recordPrefix","allowedKeysArray","validate","features","configShape","validationResult","safeParse","success","formattedError","JSON","stringify","format","pOptions","setLogger","pLogger"],"mappings":"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"}

package/dist/cardigantime.d.ts

@@ -1,6 +1,48 @@
 import { DefaultOptions, Feature, Cardigantime, Logger } from './types';
 import { z } from 'zod';
 export * from './types';
+export { ArgumentError, ConfigurationError, FileSystemError } from './validate';
+/**
+ * Creates a new Cardigantime instance for configuration management.
+ *
+ * Cardigantime handles the complete configuration lifecycle including:
+ * - Reading configuration from YAML files
+ * - Validating configuration against Zod schemas
+ * - Merging CLI arguments with file configuration and defaults
+ * - Providing type-safe configuration objects
+ *
+ * @template T - The Zod schema shape type for your configuration
+ * @param pOptions - Configuration options for the Cardigantime instance
+ * @param pOptions.defaults - Default configuration settings
+ * @param pOptions.defaults.configDirectory - Directory to search for configuration files (required)
+ * @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.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)
+ * @returns A Cardigantime instance with methods for configure, read, validate, and setLogger
+ *
+ * @example
+ * ```typescript
+ * import { create } from '@theunwalked/cardigantime';
+ * import { z } from 'zod';
+ *
+ * const MyConfigSchema = z.object({
+ *   apiKey: z.string().min(1),
+ *   timeout: z.number().default(5000),
+ *   debug: z.boolean().default(false),
+ * });
+ *
+ * const cardigantime = create({
+ *   defaults: {
+ *     configDirectory: './config',
+ *     configFile: 'myapp.yaml',
+ *   },
+ *   configShape: MyConfigSchema.shape,
+ * });
+ * ```
+ */
 export declare const create: <T extends z.ZodRawShape>(pOptions: {
     defaults: Pick<DefaultOptions, "configDirectory"> & Partial<Omit<DefaultOptions, "configDirectory">>;
     features?: Feature[];

package/dist/cardigantime.js

@@ -1,348 +1,53 @@
-'use strict';
+import { configure } from './configure.js';
+import { DEFAULT_FEATURES, DEFAULT_LOGGER, DEFAULT_OPTIONS } from './constants.js';
+import { read } from './read.js';
+import { validate } from './validate.js';
+export { ConfigSchema } from './types.js';
+export { ArgumentError } from './error/ArgumentError.js';
+export { ConfigurationError } from './error/ConfigurationError.js';
+export { FileSystemError } from './error/FileSystemError.js';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-const yaml = require('js-yaml');
-const path = require('path');
-const fs = require('fs');
-const glob = require('glob');
-const crypto = require('crypto');
-const zod = require('zod');
-
-function _interopNamespaceDefault(e) {
-    const n = Object.create(null, { [Symbol.toStringTag]: { value: 'Module' } });
-    if (e) {
-        for (const k in e) {
-            if (k !== 'default') {
-                const d = Object.getOwnPropertyDescriptor(e, k);
-                Object.defineProperty(n, k, d.get ? d : {
-                    enumerable: true,
-                    get: () => e[k]
-                });
-            }
-        }
-    }
-    n.default = e;
-    return Object.freeze(n);
-}
-
-const yaml__namespace = /*#__PURE__*/_interopNamespaceDefault(yaml);
-const fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
-
-const configure = async (command, options)=>{
-    let retCommand = command;
-    retCommand = retCommand.option('-c, --config-directory <configDirectory>', 'Config Directory', options.defaults.configDirectory);
-    return retCommand;
-};
-
-const DEFAULT_ENCODING = 'utf8';
-const DEFAULT_CONFIG_FILE = 'config.yaml';
-const DEFAULT_OPTIONS = {
-    configFile: DEFAULT_CONFIG_FILE,
-    isRequired: false,
-    encoding: DEFAULT_ENCODING
-};
-const DEFAULT_FEATURES = [
-    'config'
-];
-const DEFAULT_LOGGER = {
-    // eslint-disable-next-line no-console
-    debug: console.debug,
-    // eslint-disable-next-line no-console
-    info: console.info,
-    // eslint-disable-next-line no-console
-    warn: console.warn,
-    // eslint-disable-next-line no-console
-    error: console.error,
-    // eslint-disable-next-line no-console
-    verbose: console.log,
-    // eslint-disable-next-line no-console
-    silly: console.log
-};
-
-// eslint-disable-next-line no-restricted-imports
-const create$1 = (params)=>{
-    // eslint-disable-next-line no-console
-    const log = params.log || console.log;
-    const exists = async (path)=>{
-        try {
-            await fs__namespace.promises.stat(path);
-            return true;
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        } catch (error) {
-            return false;
-        }
-    };
-    const isDirectory = async (path)=>{
-        const stats = await fs__namespace.promises.stat(path);
-        if (!stats.isDirectory()) {
-            log(`${path} is not a directory`);
-            return false;
-        }
-        return true;
-    };
-    const isFile = async (path)=>{
-        const stats = await fs__namespace.promises.stat(path);
-        if (!stats.isFile()) {
-            log(`${path} is not a file`);
-            return false;
-        }
-        return true;
-    };
-    const isReadable = async (path)=>{
-        try {
-            await fs__namespace.promises.access(path, fs__namespace.constants.R_OK);
-        } catch (error) {
-            log(`${path} is not readable: %s %s`, error.message, error.stack);
-            return false;
-        }
-        return true;
-    };
-    const isWritable = async (path)=>{
-        try {
-            await fs__namespace.promises.access(path, fs__namespace.constants.W_OK);
-        } catch (error) {
-            log(`${path} is not writable: %s %s`, error.message, error.stack);
-            return false;
-        }
-        return true;
-    };
-    const isFileReadable = async (path)=>{
-        return await exists(path) && await isFile(path) && await isReadable(path);
-    };
-    const isDirectoryWritable = async (path)=>{
-        return await exists(path) && await isDirectory(path) && await isWritable(path);
-    };
-    const isDirectoryReadable = async (path)=>{
-        return await exists(path) && await isDirectory(path) && await isReadable(path);
-    };
-    const createDirectory = async (path)=>{
-        try {
-            await fs__namespace.promises.mkdir(path, {
-                recursive: true
-            });
-        } catch (mkdirError) {
-            throw new Error(`Failed to create output directory ${path}: ${mkdirError.message} ${mkdirError.stack}`);
-        }
-    };
-    const readFile = async (path, encoding)=>{
-        return await fs__namespace.promises.readFile(path, {
-            encoding: encoding
-        });
-    };
-    const writeFile = async (path, data, encoding)=>{
-        await fs__namespace.promises.writeFile(path, data, {
-            encoding: encoding
-        });
-    };
-    const forEachFileIn = async (directory, callback, options = {
-        pattern: '*.*'
-    })=>{
-        try {
-            const files = await glob.glob(options.pattern, {
-                cwd: directory,
-                nodir: true
-            });
-            for (const file of files){
-                await callback(path.join(directory, file));
-            }
-        } catch (err) {
-            throw new Error(`Failed to glob pattern ${options.pattern} in ${directory}: ${err.message}`);
-        }
-    };
-    const readStream = async (path)=>{
-        return fs__namespace.createReadStream(path);
-    };
-    const hashFile = async (path, length)=>{
-        const file = await readFile(path, 'utf8');
-        return crypto.createHash('sha256').update(file).digest('hex').slice(0, length);
-    };
-    const listFiles = async (directory)=>{
-        return await fs__namespace.promises.readdir(directory);
-    };
-    return {
-        exists,
-        isDirectory,
-        isFile,
-        isReadable,
-        isWritable,
-        isFileReadable,
-        isDirectoryWritable,
-        isDirectoryReadable,
-        createDirectory,
-        readFile,
-        readStream,
-        writeFile,
-        forEachFileIn,
-        hashFile,
-        listFiles
-    };
-};
-
-function clean(obj) {
-    return Object.fromEntries(Object.entries(obj).filter(([_, v])=>v !== undefined));
-}
-const read = async (args, options)=>{
-    var _options_defaults;
-    const logger = options.logger;
-    const storage = create$1({
-        log: logger.debug
-    });
-    const resolvedConfigDir = args.configDirectory || ((_options_defaults = options.defaults) === null || _options_defaults === void 0 ? void 0 : _options_defaults.configDirectory);
-    logger.debug(`Resolved config directory: ${resolvedConfigDir}`);
-    const configFile = path.join(resolvedConfigDir, options.defaults.configFile);
-    logger.debug(`Attempting to load config file for cardigantime: ${configFile}`);
-    let rawFileConfig = {};
-    try {
-        const yamlContent = await storage.readFile(configFile, options.defaults.encoding);
-        const parsedYaml = yaml__namespace.load(yamlContent);
-        if (parsedYaml !== null && typeof parsedYaml === 'object') {
-            rawFileConfig = parsedYaml;
-            logger.debug('Loaded Raw File Config for getValuesFromFile: \n\n%s\n\n', JSON.stringify(rawFileConfig, null, 2));
-        } else if (parsedYaml !== null) {
-            logger.warn(`Ignoring invalid configuration format in ${configFile} for cardigantime. Expected an object, got ${typeof parsedYaml}.`);
-        }
-    } catch (error) {
-        if (error.code === 'ENOENT' || /not found|no such file/i.test(error.message)) {
-            logger.debug(`Configuration file not found at ${configFile} for cardigantime. Returning empty object.`);
-        } else {
-            // Log error but don't throw, just return empty object as per the goal of just *getting* values
-            logger.error(`Failed to load or parse configuration from ${configFile} for getValuesFromFile: ${error.message}`);
-        }
-    }
-    const config = clean({
-        ...rawFileConfig,
-        ...{
-            configDirectory: resolvedConfigDir
-        }
-    });
-    return config;
-};
-
-// Base schema for core options
-const ConfigSchema = zod.z.object({
-    configDirectory: zod.z.string()
-});
-
-const listZodKeys = (schema, prefix = '')=>{
-    // Check if schema has unwrap method (which both ZodOptional and ZodNullable have)
-    if (schema._def && (schema._def.typeName === 'ZodOptional' || schema._def.typeName === 'ZodNullable')) {
-        // Use type assertion to handle the unwrap method
-        const unwrappable = schema;
-        return listZodKeys(unwrappable.unwrap(), prefix);
-    }
-    if (schema._def && schema._def.typeName === 'ZodArray') {
-        // Use type assertion to handle the element property
-        const arraySchema = schema;
-        return listZodKeys(arraySchema.element, prefix);
-    }
-    if (schema._def && schema._def.typeName === 'ZodObject') {
-        // Use type assertion to handle the shape property
-        const objectSchema = schema;
-        return Object.entries(objectSchema.shape).flatMap(([key, subschema])=>{
-            const fullKey = prefix ? `${prefix}.${key}` : key;
-            const nested = listZodKeys(subschema, fullKey);
-            return nested.length ? nested : fullKey;
-        });
-    }
-    return [];
-};
-const isPlainObject = (value)=>{
-    // Check if it's an object, not null, and not an array.
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-};
 /**
- * Generates a list of all keys within a JavaScript object, using dot notation for nested keys.
- * Mimics the behavior of listZodKeys but operates on plain objects.
- * For arrays, it inspects the first element that is a plain object to determine nested keys.
- * If an array contains no plain objects, or is empty, the key for the array itself is listed.
- *
- * @param obj The object to introspect.
- * @param prefix Internal use for recursion: the prefix for the current nesting level.
- * @returns An array of strings representing all keys in dot notation.
- */ const listObjectKeys = (obj, prefix = '')=>{
-    const keys = new Set(); // Use Set to automatically handle duplicates from array recursion
-    for(const key in obj){
-        // Ensure it's an own property, not from the prototype chain
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-            const value = obj[key];
-            const fullKey = prefix ? `${prefix}.${key}` : key;
-            if (Array.isArray(value)) {
-                // Find the first element that is a plain object to determine structure
-                const firstObjectElement = value.find(isPlainObject);
-                if (firstObjectElement) {
-                    // Recurse into the structure of the first object element found
-                    const nestedKeys = listObjectKeys(firstObjectElement, fullKey);
-                    nestedKeys.forEach((k)=>keys.add(k));
-                } else {
-                    // Array is empty or contains no plain objects, list the array key itself
-                    keys.add(fullKey);
-                }
-            } else if (isPlainObject(value)) {
-                // Recurse into nested plain objects
-                const nestedKeys = listObjectKeys(value, fullKey);
-                nestedKeys.forEach((k)=>keys.add(k));
-            } else {
-                // It's a primitive, null, or other non-plain object/array type
-                keys.add(fullKey);
-            }
-        }
-    }
-    return Array.from(keys); // Convert Set back to Array
-};
-const checkForExtraKeys = (mergedSources, fullSchema, logger)=>{
-    const allowedKeys = new Set(listZodKeys(fullSchema));
-    const actualKeys = listObjectKeys(mergedSources);
-    const extraKeys = actualKeys.filter((key)=>!allowedKeys.has(key));
-    if (extraKeys.length > 0) {
-        const allowedKeysString = Array.from(allowedKeys).join(', ');
-        const extraKeysString = extraKeys.join(', ');
-        const errorMessage = `Unknown configuration keys found: ${extraKeysString}. Allowed keys are: ${allowedKeysString}`;
-        logger.error(errorMessage);
-        throw new Error(`Configuration validation failed: Unknown keys found (${extraKeysString}). Check logs for details.`);
-    }
-};
-const validateConfigDirectory = async (configDirectory, isRequired)=>{
-    // eslint-disable-next-line no-console
-    const storage = create$1({
-        log: console.log
-    });
-    const exists = await storage.exists(configDirectory);
-    if (!exists) {
-        if (isRequired) {
-            throw new Error(`Config directory does not exist and is required: ${configDirectory}`);
-        }
-    } else if (exists) {
-        const isReadable = await storage.isDirectoryReadable(configDirectory);
-        if (!isReadable) {
-            throw new Error(`Config directory exists but is not readable: ${configDirectory}`);
-        }
-    }
-};
-const validate = async (config, options)=>{
-    const logger = options.logger;
-    if (options.features.includes('config') && config.configDirectory) {
-        await validateConfigDirectory(config.configDirectory, options.defaults.isRequired);
-    }
-    // Combine the base schema with the user-provided shape
-    const fullSchema = zod.z.object({
-        ...ConfigSchema.shape,
-        ...options.configShape
-    });
-    logger.debug('Full Schema: \n\n%s\n\n', JSON.stringify(listZodKeys(fullSchema), null, 2));
-    // Validate the merged sources against the full schema
-    const validationResult = fullSchema.safeParse(config);
-    // Check for extraneous keys
-    checkForExtraKeys(config, fullSchema, logger);
-    if (!validationResult.success) {
-        logger.error('Configuration validation failed: %s', JSON.stringify(validationResult.error.format(), null, 2));
-        throw new Error(`Configuration validation failed. Check logs for details.`);
-    }
-    return;
-};
-
-// Make create function generic
-const create = (pOptions)=>{
+ * Creates a new Cardigantime instance for configuration management.
+ * 
+ * Cardigantime handles the complete configuration lifecycle including:
+ * - Reading configuration from YAML files
+ * - Validating configuration against Zod schemas
+ * - Merging CLI arguments with file configuration and defaults
+ * - Providing type-safe configuration objects
+ * 
+ * @template T - The Zod schema shape type for your configuration
+ * @param pOptions - Configuration options for the Cardigantime instance
+ * @param pOptions.defaults - Default configuration settings
+ * @param pOptions.defaults.configDirectory - Directory to search for configuration files (required)
+ * @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.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)
+ * @returns A Cardigantime instance with methods for configure, read, validate, and setLogger
+ * 
+ * @example
+ * ```typescript
+ * import { create } from '@theunwalked/cardigantime';
+ * import { z } from 'zod';
+ * 
+ * const MyConfigSchema = z.object({
+ *   apiKey: z.string().min(1),
+ *   timeout: z.number().default(5000),
+ *   debug: z.boolean().default(false),
+ * });
+ * 
+ * const cardigantime = create({
+ *   defaults: {
+ *     configDirectory: './config',
+ *     configFile: 'myapp.yaml',
+ *   },
+ *   configShape: MyConfigSchema.shape,
+ * });
+ * ```
+ */ const create = (pOptions)=>{
     const defaults = {
         ...DEFAULT_OPTIONS,
         ...pOptions.defaults
@@ -368,6 +73,5 @@ const create = (pOptions)=>{
     };
 };
 
-exports.ConfigSchema = ConfigSchema;
-exports.create = create;
+export { create };
 //# sourceMappingURL=cardigantime.js.map