hazo_config 1.0.0 → 1.2.0

package/dist/components/config_editor.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { ConfigProvider } from '@/lib/types';
+/**
+ * Config editor component props
+ */
+export interface ConfigEditorProps {
+    /**
+     * The config provider instance
+     */
+    config_provider: ConfigProvider;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+    /**
+     * Callback when config is updated
+     */
+    on_update?: () => void;
+}
+/**
+ * Config editor component
+ * Provides interface for viewing and editing configuration with refresh and save capabilities
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const ConfigEditor: React.FC<ConfigEditorProps>;
+//# sourceMappingURL=config_editor.d.ts.map

package/dist/components/config_editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_editor.d.ts","sourceRoot":"","sources":["../../src/components/config_editor.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,eAAe,EAAE,cAAc,CAAA;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAmLpD,CAAA"}

package/dist/components/config_editor.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// Config editor component for managing configuration
+// Provides a more advanced interface for editing configuration values
+import { useState, useEffect } from 'react';
+import { cn } from '@/lib/utils';
+import { RefreshCw, Save } from 'lucide-react';
+/**
+ * Config editor component
+ * Provides interface for viewing and editing configuration with refresh and save capabilities
+ * @param props - Component props
+ * @returns React component
+ */
+export const ConfigEditor = ({ config_provider, className, on_update, }) => {
+    const [sections, set_sections] = useState({});
+    const [selected_section, set_selected_section] = useState(null);
+    const [new_key, set_new_key] = useState('');
+    const [new_value, set_new_value] = useState('');
+    /**
+     * Load configuration from provider
+     */
+    const load_config = () => {
+        const all_sections = {};
+        if ('getAllSections' in config_provider && typeof config_provider.getAllSections === 'function') {
+            const all = config_provider.getAllSections();
+            Object.assign(all_sections, all);
+        }
+        set_sections(all_sections);
+        if (!selected_section && Object.keys(all_sections).length > 0) {
+            set_selected_section(Object.keys(all_sections)[0]);
+        }
+    };
+    useEffect(() => {
+        load_config();
+    }, [config_provider]);
+    /**
+     * Handle refresh button click
+     */
+    const handle_refresh = () => {
+        config_provider.refresh();
+        load_config();
+        if (on_update) {
+            on_update();
+        }
+    };
+    /**
+     * Handle save button click
+     */
+    const handle_save = () => {
+        config_provider.save();
+        load_config();
+        if (on_update) {
+            on_update();
+        }
+    };
+    /**
+     * Add a new key-value pair to selected section
+     */
+    const handle_add_key = () => {
+        if (selected_section && new_key && new_value) {
+            config_provider.set(selected_section, new_key, new_value);
+            set_new_key('');
+            set_new_value('');
+            load_config();
+            if (on_update) {
+                on_update();
+            }
+        }
+    };
+    /**
+     * Update a config value
+     */
+    const handle_update_value = (section, key, value) => {
+        config_provider.set(section, key, value);
+        load_config();
+    };
+    const current_section_data = selected_section ? sections[selected_section] : null;
+    return (_jsxs("div", { className: cn('cls_config_editor space-y-4', className), children: [_jsxs("div", { className: "cls_config_editor_header flex items-center justify-between border-b pb-2", children: [_jsx("h2", { className: "text-xl font-semibold", children: "Configuration Editor" }), _jsxs("div", { className: "flex gap-2", children: [_jsxs("button", { onClick: handle_refresh, className: "px-3 py-1 border rounded hover:bg-muted flex items-center gap-2", "aria-label": "Refresh", children: [_jsx(RefreshCw, { size: 16 }), "Refresh"] }), _jsxs("button", { onClick: handle_save, className: "px-3 py-1 bg-primary text-primary-foreground rounded hover:bg-primary/90 flex items-center gap-2", "aria-label": "Save", children: [_jsx(Save, { size: 16 }), "Save"] })] })] }), _jsxs("div", { className: "cls_config_editor_content grid grid-cols-1 md:grid-cols-3 gap-4", children: [_jsxs("div", { className: "cls_config_sections_list border rounded p-4", children: [_jsx("h3", { className: "font-semibold mb-2", children: "Sections" }), _jsx("div", { className: "space-y-1", children: Object.keys(sections).map((section_name) => (_jsx("button", { onClick: () => set_selected_section(section_name), className: cn('w-full text-left px-2 py-1 rounded text-sm', selected_section === section_name
+                                        ? 'bg-primary text-primary-foreground'
+                                        : 'hover:bg-muted'), children: section_name }, section_name))) })] }), _jsx("div", { className: "cls_config_section_content md:col-span-2 border rounded p-4", children: selected_section ? (_jsxs(_Fragment, { children: [_jsx("h3", { className: "font-semibold mb-4", children: selected_section }), _jsxs("div", { className: "space-y-3", children: [current_section_data &&
+                                            Object.entries(current_section_data).map(([key, value]) => (_jsxs("div", { className: "cls_config_item", children: [_jsx("label", { className: "block text-sm font-medium mb-1", children: key }), _jsx("input", { type: "text", value: value, onChange: (e) => handle_update_value(selected_section, key, e.target.value), className: "w-full px-2 py-1 border rounded" })] }, key))), _jsxs("div", { className: "cls_add_new_key border-t pt-3 mt-3", children: [_jsx("h4", { className: "text-sm font-medium mb-2", children: "Add New Key" }), _jsxs("div", { className: "space-y-2", children: [_jsx("input", { type: "text", placeholder: "Key name", value: new_key, onChange: (e) => set_new_key(e.target.value), className: "w-full px-2 py-1 border rounded text-sm" }), _jsx("input", { type: "text", placeholder: "Value", value: new_value, onChange: (e) => set_new_value(e.target.value), className: "w-full px-2 py-1 border rounded text-sm" }), _jsx("button", { onClick: handle_add_key, className: "px-3 py-1 bg-primary text-primary-foreground rounded hover:bg-primary/90 text-sm", children: "Add Key" })] })] })] })] })) : (_jsx("div", { className: "text-center text-muted-foreground py-8", children: "Select a section to view/edit" })) })] })] }));
+};

package/dist/components/config_viewer.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { ConfigProvider } from '@/lib/types';
+/**
+ * Config viewer component props
+ */
+export interface ConfigViewerProps {
+    /**
+     * The config provider instance
+     */
+    config_provider: ConfigProvider;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+    /**
+     * Callback when config is updated
+     */
+    on_update?: () => void;
+}
+/**
+ * Config viewer component
+ * Displays configuration sections and allows viewing/editing values
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const ConfigViewer: React.FC<ConfigViewerProps>;
+//# sourceMappingURL=config_viewer.d.ts.map

package/dist/components/config_viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_viewer.d.ts","sourceRoot":"","sources":["../../src/components/config_viewer.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,eAAe,EAAE,cAAc,CAAA;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAwIpD,CAAA"}

package/dist/components/config_viewer.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Config viewer component for displaying configuration data
+// Displays configuration sections and values in a readable format
+import { useState, useEffect } from 'react';
+import { cn } from '@/lib/utils';
+import { Pencil, CheckCircle2, XCircle } from 'lucide-react';
+/**
+ * Config viewer component
+ * Displays configuration sections and allows viewing/editing values
+ * @param props - Component props
+ * @returns React component
+ */
+export const ConfigViewer = ({ config_provider, className, on_update, }) => {
+    const [sections, set_sections] = useState({});
+    const [editing, set_editing] = useState(null);
+    const [edit_value, set_edit_value] = useState('');
+    /**
+     * Load configuration from provider
+     */
+    const load_config = () => {
+        const all_sections = {};
+        // Try to get all sections - if provider has getAllSections, use it
+        if ('getAllSections' in config_provider && typeof config_provider.getAllSections === 'function') {
+            const all = config_provider.getAllSections();
+            Object.assign(all_sections, all);
+        }
+        else {
+            // Fallback: try common section names
+            const common_sections = ['database', 'logging', 'api', 'server', 'app'];
+            for (const section of common_sections) {
+                const section_data = config_provider.getSection(section);
+                if (section_data) {
+                    all_sections[section] = section_data;
+                }
+            }
+        }
+        set_sections(all_sections);
+    };
+    useEffect(() => {
+        load_config();
+    }, [config_provider]);
+    /**
+     * Start editing a config value
+     */
+    const start_edit = (section, key) => {
+        const value = config_provider.get(section, key) || '';
+        set_editing({ section, key });
+        set_edit_value(value);
+    };
+    /**
+     * Cancel editing
+     */
+    const cancel_edit = () => {
+        set_editing(null);
+        set_edit_value('');
+    };
+    /**
+     * Save edited value
+     */
+    const save_edit = () => {
+        if (editing) {
+            config_provider.set(editing.section, editing.key, edit_value);
+            config_provider.save();
+            load_config();
+            set_editing(null);
+            set_edit_value('');
+            if (on_update) {
+                on_update();
+            }
+        }
+    };
+    return (_jsx("div", { className: cn('cls_config_viewer space-y-4', className), children: Object.keys(sections).length === 0 ? (_jsx("div", { className: "p-4 text-center text-muted-foreground", children: "No configuration sections found" })) : (Object.entries(sections).map(([section_name, section_data]) => (_jsxs("div", { className: "cls_config_section border rounded-lg p-4", children: [_jsx("h3", { className: "text-lg font-semibold mb-3", children: section_name }), _jsx("div", { className: "space-y-2", children: Object.entries(section_data).map(([key, value]) => {
+                        const is_editing = editing?.section === section_name && editing?.key === key;
+                        return (_jsx("div", { className: "cls_config_item flex items-center gap-2", children: _jsxs("div", { className: "flex-1", children: [_jsx("div", { className: "text-sm font-medium text-muted-foreground", children: key }), is_editing ? (_jsxs("div", { className: "flex items-center gap-2 mt-1", children: [_jsx("input", { type: "text", value: edit_value, onChange: (e) => set_edit_value(e.target.value), className: "flex-1 px-2 py-1 border rounded text-sm", autoFocus: true }), _jsx("button", { onClick: save_edit, className: "text-green-600 hover:text-green-700", "aria-label": "Save", children: _jsx(CheckCircle2, { size: 20 }) }), _jsx("button", { onClick: cancel_edit, className: "text-red-600 hover:text-red-700", "aria-label": "Cancel", children: _jsx(XCircle, { size: 20 }) })] })) : (_jsxs("div", { className: "flex items-center gap-2 mt-1", children: [_jsx("div", { className: "flex-1 px-2 py-1 bg-muted rounded text-sm", children: value || '(empty)' }), _jsx("button", { onClick: () => start_edit(section_name, key), className: "text-blue-600 hover:text-blue-700", "aria-label": "Edit", children: _jsx(Pencil, { size: 18 }) })] }))] }) }, key));
+                    }) })] }, section_name)))) }));
+};

package/dist/components/example_component.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+/**
+ * Example component props interface
+ */
+export interface ExampleComponentProps {
+    /**
+     * The title to display
+     */
+    title?: string;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+}
+/**
+ * Example component for demonstrating the component library setup
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const ExampleComponent: React.FC<ExampleComponentProps>;
+//# sourceMappingURL=example_component.d.ts.map

package/dist/components/example_component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example_component.d.ts","sourceRoot":"","sources":["../../src/components/example_component.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAY5D,CAAA"}

package/dist/components/example_component.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '@/lib/utils';
+/**
+ * Example component for demonstrating the component library setup
+ * @param props - Component props
+ * @returns React component
+ */
+export const ExampleComponent = ({ title = 'Example Component', className, }) => {
+    return (_jsxs("div", { className: cn('cls_example_component p-4 border rounded-lg', className), children: [_jsx("h2", { className: "text-xl font-semibold", children: title }), _jsx("p", { className: "text-muted-foreground mt-2", children: "This is an example component for the config management library." })] }));
+};

package/dist/components/index.d.ts

@@ -0,0 +1,6 @@
+export { ExampleComponent } from './example_component';
+export { ConfigViewer } from './config_viewer';
+export { ConfigEditor } from './config_editor';
+export type { ConfigViewerProps } from './config_viewer';
+export type { ConfigEditorProps } from './config_editor';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/components/index.js

@@ -0,0 +1,5 @@
+// Component exports
+// Export all components from this file for easy importing
+export { ExampleComponent } from './example_component';
+export { ConfigViewer } from './config_viewer';
+export { ConfigEditor } from './config_editor';

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './components';
+export * from './lib/utils';
+export * from './lib';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,OAAO,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Main entry point for the component library
+// Export all components and utilities from this file
+export * from './components';
+export * from './lib/utils';
+export * from './lib';

package/dist/lib/config-loader.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Purpose: Main implementation of HazoConfig
+ *
+ * This file provides the HazoConfig class that implements the ConfigProvider
+ * interface. It handles reading and writing INI configuration files with
+ * in-memory caching, sync operations, and preservation of file formatting.
+ * Zero dependencies - only Node.js built-ins and the 'ini' package.
+ */
+import type { ConfigProvider, HazoConfigOptions } from './types';
+/**
+ * HazoConfig class
+ *
+ * Implements ConfigProvider interface for managing INI configuration files.
+ * Provides sync read/write operations with in-memory caching.
+ */
+export declare class HazoConfig implements ConfigProvider {
+    private filePath;
+    private logger;
+    private config;
+    /**
+     * Constructor
+     * @param options - Configuration options including filePath and optional logger
+     * @throws Error if file doesn't exist
+     */
+    constructor(options: HazoConfigOptions);
+    /**
+     * Get a configuration value by section and key
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @returns The configuration value, or undefined if not found
+     */
+    get(section: string, key: string): string | undefined;
+    /**
+     * Get an entire configuration section
+     * @param section - The configuration section name
+     * @returns A record of key-value pairs for the section, or undefined if section doesn't exist
+     */
+    getSection(section: string): Record<string, string> | undefined;
+    /**
+     * Set a configuration value
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @param value - The value to set
+     */
+    set(section: string, key: string, value: string): void;
+    /**
+     * Save the current configuration to disk
+     * Writes all changes immediately to the configuration file
+     */
+    save(): void;
+    /**
+     * Refresh the configuration from disk
+     * Reloads the configuration file and updates the in-memory cache
+     */
+    refresh(): void;
+    /**
+     * Get the file path being managed
+     * @returns The resolved file path
+     */
+    getFilePath(): string;
+    /**
+     * Get all configuration sections
+     * @returns A record of all sections and their key-value pairs
+     */
+    getAllSections(): Record<string, Record<string, string>>;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/lib/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/lib/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAU,MAAM,SAAS,CAAA;AAaxE;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAA6C;IAE3D;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAgBtC;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAI/D;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQtD;;;OAGG;IACH,IAAI,IAAI,IAAI;IAqBZ;;;OAGG;IACH,OAAO,IAAI,IAAI;IAuCf;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAQzD"}

package/dist/lib/config-loader.js

@@ -0,0 +1,177 @@
+/**
+ * Purpose: Main implementation of HazoConfig
+ *
+ * This file provides the HazoConfig class that implements the ConfigProvider
+ * interface. It handles reading and writing INI configuration files with
+ * in-memory caching, sync operations, and preservation of file formatting.
+ * Zero dependencies - only Node.js built-ins and the 'ini' package.
+ */
+import fs from 'fs';
+import path from 'path';
+import ini from 'ini';
+import { ConfigErrorCode as EC } from './types';
+/**
+ * No-op logger implementation (default when no logger provided)
+ */
+const no_op_logger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { }
+};
+/**
+ * HazoConfig class
+ *
+ * Implements ConfigProvider interface for managing INI configuration files.
+ * Provides sync read/write operations with in-memory caching.
+ */
+export class HazoConfig {
+    /**
+     * Constructor
+     * @param options - Configuration options including filePath and optional logger
+     * @throws Error if file doesn't exist
+     */
+    constructor(options) {
+        Object.defineProperty(this, "filePath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "logger", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+        this.filePath = path.resolve(options.filePath);
+        this.logger = options.logger || no_op_logger;
+        // Validate file exists
+        if (!fs.existsSync(this.filePath)) {
+            const error = new Error(`Configuration file not found: ${this.filePath}`);
+            error.code = EC.FILE_NOT_FOUND;
+            this.logger.error(`[HazoConfig] Configuration file not found: ${this.filePath}`);
+            throw error;
+        }
+        // Load initial configuration
+        this.refresh();
+    }
+    /**
+     * Get a configuration value by section and key
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @returns The configuration value, or undefined if not found
+     */
+    get(section, key) {
+        return this.config[section]?.[key];
+    }
+    /**
+     * Get an entire configuration section
+     * @param section - The configuration section name
+     * @returns A record of key-value pairs for the section, or undefined if section doesn't exist
+     */
+    getSection(section) {
+        return this.config[section] ? { ...this.config[section] } : undefined;
+    }
+    /**
+     * Set a configuration value
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @param value - The value to set
+     */
+    set(section, key, value) {
+        if (!this.config[section]) {
+            this.config[section] = {};
+        }
+        this.config[section][key] = value;
+        this.logger.info(`[HazoConfig] Set config value: ${section}.${key}`, { value });
+    }
+    /**
+     * Save the current configuration to disk
+     * Writes all changes immediately to the configuration file
+     */
+    save() {
+        try {
+            // Convert config object back to INI format
+            const iniContent = ini.stringify(this.config, {
+                section: '[',
+                whitespace: true
+            });
+            // Write to file
+            fs.writeFileSync(this.filePath, iniContent, 'utf-8');
+            this.logger.info(`[HazoConfig] Configuration saved to: ${this.filePath}`);
+        }
+        catch (error) {
+            const configError = new Error(`Failed to save configuration: ${error.message || String(error)}`);
+            configError.code = EC.WRITE_ERROR;
+            configError.originalError = error;
+            this.logger.error(`[HazoConfig] Failed to save configuration: ${this.filePath}`, { error: String(error) });
+            throw configError;
+        }
+    }
+    /**
+     * Refresh the configuration from disk
+     * Reloads the configuration file and updates the in-memory cache
+     */
+    refresh() {
+        try {
+            // Read file content
+            const content = fs.readFileSync(this.filePath, 'utf-8');
+            // Parse INI content
+            const parsed = ini.parse(content);
+            // Convert to our internal format (ensure all values are strings)
+            this.config = {};
+            for (const [section, values] of Object.entries(parsed)) {
+                if (typeof values === 'object' && values !== null) {
+                    this.config[section] = {};
+                    for (const [key, value] of Object.entries(values)) {
+                        this.config[section][key] = String(value);
+                    }
+                }
+            }
+            this.logger.info(`[HazoConfig] Configuration refreshed from: ${this.filePath}`, {
+                sections: Object.keys(this.config)
+            });
+        }
+        catch (error) {
+            // Handle file read errors
+            if (error.code === 'ENOENT') {
+                const configError = new Error(`Configuration file not found: ${this.filePath}`);
+                configError.code = EC.FILE_NOT_FOUND;
+                this.logger.error(`[HazoConfig] Configuration file not found: ${this.filePath}`);
+                throw configError;
+            }
+            // Handle parse errors
+            const configError = new Error(`Failed to parse configuration: ${error.message || String(error)}`);
+            configError.code = EC.PARSE_ERROR;
+            configError.originalError = error;
+            this.logger.error(`[HazoConfig] Failed to parse configuration: ${this.filePath}`, { error: String(error) });
+            throw configError;
+        }
+    }
+    /**
+     * Get the file path being managed
+     * @returns The resolved file path
+     */
+    getFilePath() {
+        return this.filePath;
+    }
+    /**
+     * Get all configuration sections
+     * @returns A record of all sections and their key-value pairs
+     */
+    getAllSections() {
+        // Return a deep copy to prevent external modification
+        const result = {};
+        for (const [section, values] of Object.entries(this.config)) {
+            result[section] = { ...values };
+        }
+        return result;
+    }
+}

package/dist/lib/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Purpose: Main export for the HazoConfig library.
+ *
+ * This file re-exports all public interfaces and classes for the HazoConfig
+ * configuration management utility. It serves as the primary entry point
+ * for consumers of the library.
+ */
+export { HazoConfig } from './config-loader';
+export { MockConfigProvider } from './mock_config_provider';
+export { ConfigErrorCode } from './types';
+export type { ConfigProvider, HazoConfigOptions, Logger, HazoConfigError } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,MAAM,EACN,eAAe,EAChB,MAAM,SAAS,CAAA"}

package/dist/lib/index.js

@@ -0,0 +1,10 @@
+/**
+ * Purpose: Main export for the HazoConfig library.
+ *
+ * This file re-exports all public interfaces and classes for the HazoConfig
+ * configuration management utility. It serves as the primary entry point
+ * for consumers of the library.
+ */
+export { HazoConfig } from './config-loader';
+export { MockConfigProvider } from './mock_config_provider';
+export { ConfigErrorCode } from './types';

package/dist/lib/mock_config_provider.d.ts

@@ -0,0 +1,52 @@
+import type { ConfigProvider } from './types';
+/**
+ * Mock config provider that stores configuration in memory
+ * Useful for testing and Storybook demonstrations where file system is not available
+ */
+export declare class MockConfigProvider implements ConfigProvider {
+    private config;
+    /**
+     * Constructor
+     * @param initial_config - Optional initial configuration data
+     */
+    constructor(initial_config?: Record<string, Record<string, string>>);
+    /**
+     * Get a configuration value by section and key
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @returns The configuration value, or undefined if not found
+     */
+    get(section: string, key: string): string | undefined;
+    /**
+     * Get an entire configuration section
+     * @param section - The configuration section name
+     * @returns A record of key-value pairs for the section, or undefined if section doesn't exist
+     */
+    getSection(section: string): Record<string, string> | undefined;
+    /**
+     * Set a configuration value
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @param value - The value to set
+     */
+    set(section: string, key: string, value: string): void;
+    /**
+     * Save the current configuration (no-op for mock, but maintains interface compatibility)
+     */
+    save(): void;
+    /**
+     * Refresh the configuration (no-op for mock, but maintains interface compatibility)
+     */
+    refresh(): void;
+    /**
+     * Get all configuration sections
+     * @returns A record of all sections and their key-value pairs
+     */
+    getAllSections(): Record<string, Record<string, string>>;
+    /**
+     * Reset the configuration to initial state or empty
+     * @param new_config - Optional new configuration to set
+     */
+    reset(new_config?: Record<string, Record<string, string>>): void;
+}
+//# sourceMappingURL=mock_config_provider.d.ts.map

package/dist/lib/mock_config_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock_config_provider.d.ts","sourceRoot":"","sources":["../../src/lib/mock_config_provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,MAAM,CAA6C;IAE3D;;;OAGG;gBACS,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAMnE;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAI/D;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOtD;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAQxD;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;CAOjE"}

package/dist/lib/mock_config_provider.js

@@ -0,0 +1,87 @@
+// Mock config provider for browser/Storybook testing
+// Implements ConfigProvider interface using in-memory storage instead of file system
+/**
+ * Mock config provider that stores configuration in memory
+ * Useful for testing and Storybook demonstrations where file system is not available
+ */
+export class MockConfigProvider {
+    /**
+     * Constructor
+     * @param initial_config - Optional initial configuration data
+     */
+    constructor(initial_config) {
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+        if (initial_config) {
+            this.config = JSON.parse(JSON.stringify(initial_config)); // Deep copy
+        }
+    }
+    /**
+     * Get a configuration value by section and key
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @returns The configuration value, or undefined if not found
+     */
+    get(section, key) {
+        return this.config[section]?.[key];
+    }
+    /**
+     * Get an entire configuration section
+     * @param section - The configuration section name
+     * @returns A record of key-value pairs for the section, or undefined if section doesn't exist
+     */
+    getSection(section) {
+        return this.config[section] ? { ...this.config[section] } : undefined;
+    }
+    /**
+     * Set a configuration value
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @param value - The value to set
+     */
+    set(section, key, value) {
+        if (!this.config[section]) {
+            this.config[section] = {};
+        }
+        this.config[section][key] = value;
+    }
+    /**
+     * Save the current configuration (no-op for mock, but maintains interface compatibility)
+     */
+    save() {
+        // No-op for mock provider
+    }
+    /**
+     * Refresh the configuration (no-op for mock, but maintains interface compatibility)
+     */
+    refresh() {
+        // No-op for mock provider
+    }
+    /**
+     * Get all configuration sections
+     * @returns A record of all sections and their key-value pairs
+     */
+    getAllSections() {
+        const result = {};
+        for (const [section, values] of Object.entries(this.config)) {
+            result[section] = { ...values };
+        }
+        return result;
+    }
+    /**
+     * Reset the configuration to initial state or empty
+     * @param new_config - Optional new configuration to set
+     */
+    reset(new_config) {
+        if (new_config) {
+            this.config = JSON.parse(JSON.stringify(new_config));
+        }
+        else {
+            this.config = {};
+        }
+    }
+}

package/dist/lib/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Purpose: Core interfaces and types for the HazoConfig component.
+ *
+ * This file defines the fundamental building blocks for creating a flexible and
+ * extensible configuration management utility. It includes interfaces for the
+ * ConfigProvider pattern, configuration options, and error types, ensuring
+ * loose coupling and reusability across different projects.
+ */
+/**
+ * Logger interface for dependency injection
+ * Matches the Logger interface from hazo_connect for consistency
+ */
+export interface Logger {
+    debug(message: string, data?: any): void;
+    info(message: string, data?: any): void;
+    warn(message: string, data?: any): void;
+    error(message: string, data?: any): void;
+}
+/**
+ * ConfigProvider interface
+ *
+ * Defines the contract for configuration providers that can be used
+ * by other components (like hazo_connect) to access configuration values.
+ * This allows for dependency injection and makes components testable.
+ */
+export interface ConfigProvider {
+    /**
+     * Get a configuration value by section and key
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @returns The configuration value, or undefined if not found
+     */
+    get(section: string, key: string): string | undefined;
+    /**
+     * Get an entire configuration section
+     * @param section - The configuration section name
+     * @returns A record of key-value pairs for the section, or undefined if section doesn't exist
+     */
+    getSection(section: string): Record<string, string> | undefined;
+    /**
+     * Set a configuration value
+     * @param section - The configuration section name
+     * @param key - The configuration key name
+     * @param value - The value to set
+     */
+    set(section: string, key: string, value: string): void;
+    /**
+     * Save the current configuration to disk
+     * Writes all changes immediately to the configuration file
+     */
+    save(): void;
+    /**
+     * Refresh the configuration from disk
+     * Reloads the configuration file and updates the in-memory cache
+     */
+    refresh(): void;
+}
+/**
+ * Options for initializing HazoConfig
+ */
+export interface HazoConfigOptions {
+    /**
+     * Path to the configuration file (required)
+     * Can be absolute or relative to process.cwd()
+     */
+    filePath: string;
+    /**
+     * Optional logger instance for logging operations
+     */
+    logger?: Logger;
+}
+/**
+ * Error codes for configuration operations
+ */
+export declare enum ConfigErrorCode {
+    FILE_NOT_FOUND = "HAZO_CONFIG_FILE_NOT_FOUND",
+    READ_ERROR = "HAZO_CONFIG_READ_ERROR",
+    WRITE_ERROR = "HAZO_CONFIG_WRITE_ERROR",
+    PARSE_ERROR = "HAZO_CONFIG_PARSE_ERROR",
+    VALIDATION_ERROR = "HAZO_CONFIG_VALIDATION_ERROR"
+}
+/**
+ * Standardized error response for configuration operations
+ */
+export interface HazoConfigError {
+    code: string;
+    message: string;
+    filePath?: string;
+    originalError?: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;IACxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;IACvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;IACvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;CACzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAErD;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;IAE/D;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtD;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAA;IAEZ;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,cAAc,+BAA+B;IAC7C,UAAU,2BAA2B;IACrC,WAAW,4BAA4B;IACvC,WAAW,4BAA4B;IACvC,gBAAgB,iCAAiC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,GAAG,CAAA;CACpB"}

package/dist/lib/types.js

@@ -0,0 +1,19 @@
+/**
+ * Purpose: Core interfaces and types for the HazoConfig component.
+ *
+ * This file defines the fundamental building blocks for creating a flexible and
+ * extensible configuration management utility. It includes interfaces for the
+ * ConfigProvider pattern, configuration options, and error types, ensuring
+ * loose coupling and reusability across different projects.
+ */
+/**
+ * Error codes for configuration operations
+ */
+export var ConfigErrorCode;
+(function (ConfigErrorCode) {
+    ConfigErrorCode["FILE_NOT_FOUND"] = "HAZO_CONFIG_FILE_NOT_FOUND";
+    ConfigErrorCode["READ_ERROR"] = "HAZO_CONFIG_READ_ERROR";
+    ConfigErrorCode["WRITE_ERROR"] = "HAZO_CONFIG_WRITE_ERROR";
+    ConfigErrorCode["PARSE_ERROR"] = "HAZO_CONFIG_PARSE_ERROR";
+    ConfigErrorCode["VALIDATION_ERROR"] = "HAZO_CONFIG_VALIDATION_ERROR";
+})(ConfigErrorCode || (ConfigErrorCode = {}));

package/dist/lib/utils.d.ts

@@ -0,0 +1,8 @@
+import { type ClassValue } from "clsx";
+/**
+ * Merges class names using clsx and tailwind-merge
+ * @param inputs - Class values to merge
+ * @returns Merged class string
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAA;AAG5C;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/lib/utils.js

@@ -0,0 +1,12 @@
+// Utility functions for the component library
+// Provides class name merging functionality using clsx and tailwind-merge
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+/**
+ * Merges class names using clsx and tailwind-merge
+ * @param inputs - Class values to merge
+ * @returns Merged class string
+ */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_config",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Config wrapper with error handling",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/components/config_editor.tsx

@@ -37,7 +37,6 @@ export const ConfigEditor: React.FC<ConfigEditorProps> = ({
 }) => {
   const [sections, set_sections] = useState<Record<string, Record<string, string>>>({})
   const [selected_section, set_selected_section] = useState<string | null>(null)
-  const [new_section_name, set_new_section_name] = useState<string>('')
   const [new_key, set_new_key] = useState<string>('')
   const [new_value, set_new_value] = useState<string>('')
 

package/src/lib/config-loader.ts

@@ -16,7 +16,8 @@ import { ConfigErrorCode as EC } from './types'
 /**
  * No-op logger implementation (default when no logger provided)
  */
-const noOpLogger: Logger = {
+const no_op_logger: Logger = {
+  debug: () => {},
   info: () => {},
   warn: () => {},
   error: () => {}
@@ -32,7 +33,6 @@ export class HazoConfig implements ConfigProvider {
   private filePath: string
   private logger: Logger
   private config: Record<string, Record<string, string>> = {}
-  private originalContent: string = ''
 
   /**
    * Constructor
@@ -41,7 +41,7 @@ export class HazoConfig implements ConfigProvider {
    */
   constructor(options: HazoConfigOptions) {
     this.filePath = path.resolve(options.filePath)
-    this.logger = options.logger || noOpLogger
+    this.logger = options.logger || no_op_logger
 
     // Validate file exists
     if (!fs.existsSync(this.filePath)) {
@@ -97,16 +97,12 @@ export class HazoConfig implements ConfigProvider {
       // Convert config object back to INI format
       const iniContent = ini.stringify(this.config, {
         section: '[',
-        whitespace: true,
-        newline: '\n'
+        whitespace: true
       })
 
       // Write to file
       fs.writeFileSync(this.filePath, iniContent, 'utf-8')
       
-      // Update original content for future reference
-      this.originalContent = iniContent
-      
       this.logger.info(`[HazoConfig] Configuration saved to: ${this.filePath}`)
     } catch (error: any) {
       const configError: any = new Error(`Failed to save configuration: ${error.message || String(error)}`)
@@ -125,8 +121,6 @@ export class HazoConfig implements ConfigProvider {
     try {
       // Read file content
       const content = fs.readFileSync(this.filePath, 'utf-8')
-      this.originalContent = content
-
       // Parse INI content
       const parsed = ini.parse(content)
       

package/src/lib/types.ts

@@ -12,6 +12,7 @@
  * Matches the Logger interface from hazo_connect for consistency
  */
 export interface Logger {
+  debug(message: string, data?: any): void
   info(message: string, data?: any): void
   warn(message: string, data?: any): void
   error(message: string, data?: any): void

package/tsconfig.build.json

@@ -5,7 +5,8 @@
     "declaration": true,
     "declarationMap": true,
     "outDir": "./dist",
-    "rootDir": "./src"
+    "rootDir": "./src",
+    "allowImportingTsExtensions": false
   },
   "include": ["src"],
   "exclude": ["**/*.stories.tsx", "**/*.test.tsx", "**/*.test.ts"]