hazo_config 1.3.1 → 1.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 pub12
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/components/config_editor.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { ConfigProvider } from '../lib/types';
+import type { ConfigProvider } from '../lib/types.js';
 /**
  * Config editor component props
  */

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

@@ -1 +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,cAAc,CAAA;AAGlD;;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"}
+{"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,iBAAiB,CAAA;AAGrD;;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

@@ -1,23 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigEditor = void 0;
-const jsx_runtime_1 = require("react/jsx-runtime");
+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
-const react_1 = require("react");
-const utils_1 = require("../lib/utils");
-const lucide_react_1 = require("lucide-react");
+import { useState, useEffect } from 'react';
+import { cn } from '../lib/utils.js';
+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
  */
-const ConfigEditor = ({ config_provider, className, on_update, }) => {
-    const [sections, set_sections] = (0, react_1.useState)({});
-    const [selected_section, set_selected_section] = (0, react_1.useState)(null);
-    const [new_key, set_new_key] = (0, react_1.useState)('');
-    const [new_value, set_new_value] = (0, react_1.useState)('');
+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
      */
@@ -32,7 +29,7 @@ const ConfigEditor = ({ config_provider, className, on_update, }) => {
             set_selected_section(Object.keys(all_sections)[0]);
         }
     };
-    (0, react_1.useEffect)(() => {
+    useEffect(() => {
         load_config();
     }, [config_provider]);
     /**
@@ -77,9 +74,8 @@ const ConfigEditor = ({ config_provider, className, on_update, }) => {
         load_config();
     };
     const current_section_data = selected_section ? sections[selected_section] : null;
-    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, utils_1.cn)('cls_config_editor space-y-4', className), children: [(0, jsx_runtime_1.jsxs)("div", { className: "cls_config_editor_header flex items-center justify-between border-b pb-2", children: [(0, jsx_runtime_1.jsx)("h2", { className: "text-xl font-semibold", children: "Configuration Editor" }), (0, jsx_runtime_1.jsxs)("div", { className: "flex gap-2", children: [(0, jsx_runtime_1.jsxs)("button", { onClick: handle_refresh, className: "px-3 py-1 border rounded hover:bg-muted flex items-center gap-2", "aria-label": "Refresh", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.RefreshCw, { size: 16 }), "Refresh"] }), (0, jsx_runtime_1.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: [(0, jsx_runtime_1.jsx)(lucide_react_1.Save, { size: 16 }), "Save"] })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "cls_config_editor_content grid grid-cols-1 md:grid-cols-3 gap-4", children: [(0, jsx_runtime_1.jsxs)("div", { className: "cls_config_sections_list border rounded p-4", children: [(0, jsx_runtime_1.jsx)("h3", { className: "font-semibold mb-2", children: "Sections" }), (0, jsx_runtime_1.jsx)("div", { className: "space-y-1", children: Object.keys(sections).map((section_name) => ((0, jsx_runtime_1.jsx)("button", { onClick: () => set_selected_section(section_name), className: (0, utils_1.cn)('w-full text-left px-2 py-1 rounded text-sm', selected_section === section_name
+    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))) })] }), (0, jsx_runtime_1.jsx)("div", { className: "cls_config_section_content md:col-span-2 border rounded p-4", children: selected_section ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("h3", { className: "font-semibold mb-4", children: selected_section }), (0, jsx_runtime_1.jsxs)("div", { className: "space-y-3", children: [current_section_data &&
-                                            Object.entries(current_section_data).map(([key, value]) => ((0, jsx_runtime_1.jsxs)("div", { className: "cls_config_item", children: [(0, jsx_runtime_1.jsx)("label", { className: "block text-sm font-medium mb-1", children: key }), (0, jsx_runtime_1.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))), (0, jsx_runtime_1.jsxs)("div", { className: "cls_add_new_key border-t pt-3 mt-3", children: [(0, jsx_runtime_1.jsx)("h4", { className: "text-sm font-medium mb-2", children: "Add New Key" }), (0, jsx_runtime_1.jsxs)("div", { className: "space-y-2", children: [(0, jsx_runtime_1.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" }), (0, jsx_runtime_1.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" }), (0, jsx_runtime_1.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" })] })] })] })] })) : ((0, jsx_runtime_1.jsx)("div", { className: "text-center text-muted-foreground py-8", children: "Select a section to view/edit" })) })] })] }));
+                                        : '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" })) })] })] }));
 };
-exports.ConfigEditor = ConfigEditor;

package/dist/components/config_viewer.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { ConfigProvider } from '../lib/types';
+import type { ConfigProvider } from '../lib/types.js';
 /**
  * Config viewer component props
  */

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

@@ -1 +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,cAAc,CAAA;AAGlD;;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"}
+{"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,iBAAiB,CAAA;AAGrD;;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

@@ -1,22 +1,19 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigViewer = void 0;
-const jsx_runtime_1 = require("react/jsx-runtime");
+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
-const react_1 = require("react");
-const utils_1 = require("../lib/utils");
-const lucide_react_1 = require("lucide-react");
+import { useState, useEffect } from 'react';
+import { cn } from '../lib/utils.js';
+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
  */
-const ConfigViewer = ({ config_provider, className, on_update, }) => {
-    const [sections, set_sections] = (0, react_1.useState)({});
-    const [editing, set_editing] = (0, react_1.useState)(null);
-    const [edit_value, set_edit_value] = (0, react_1.useState)('');
+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
      */
@@ -39,7 +36,7 @@ const ConfigViewer = ({ config_provider, className, on_update, }) => {
         }
         set_sections(all_sections);
     };
-    (0, react_1.useEffect)(() => {
+    useEffect(() => {
         load_config();
     }, [config_provider]);
     /**
@@ -72,9 +69,8 @@ const ConfigViewer = ({ config_provider, className, on_update, }) => {
             }
         }
     };
-    return ((0, jsx_runtime_1.jsx)("div", { className: (0, utils_1.cn)('cls_config_viewer space-y-4', className), children: Object.keys(sections).length === 0 ? ((0, jsx_runtime_1.jsx)("div", { className: "p-4 text-center text-muted-foreground", children: "No configuration sections found" })) : (Object.entries(sections).map(([section_name, section_data]) => ((0, jsx_runtime_1.jsxs)("div", { className: "cls_config_section border rounded-lg p-4", children: [(0, jsx_runtime_1.jsx)("h3", { className: "text-lg font-semibold mb-3", children: section_name }), (0, jsx_runtime_1.jsx)("div", { className: "space-y-2", children: Object.entries(section_data).map(([key, value]) => {
+    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 ((0, jsx_runtime_1.jsx)("div", { className: "cls_config_item flex items-center gap-2", children: (0, jsx_runtime_1.jsxs)("div", { className: "flex-1", children: [(0, jsx_runtime_1.jsx)("div", { className: "text-sm font-medium text-muted-foreground", children: key }), is_editing ? ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2 mt-1", children: [(0, jsx_runtime_1.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 }), (0, jsx_runtime_1.jsx)("button", { onClick: save_edit, className: "text-green-600 hover:text-green-700", "aria-label": "Save", children: (0, jsx_runtime_1.jsx)(lucide_react_1.CheckCircle2, { size: 20 }) }), (0, jsx_runtime_1.jsx)("button", { onClick: cancel_edit, className: "text-red-600 hover:text-red-700", "aria-label": "Cancel", children: (0, jsx_runtime_1.jsx)(lucide_react_1.XCircle, { size: 20 }) })] })) : ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2 mt-1", children: [(0, jsx_runtime_1.jsx)("div", { className: "flex-1 px-2 py-1 bg-muted rounded text-sm", children: value || '(empty)' }), (0, jsx_runtime_1.jsx)("button", { onClick: () => start_edit(section_name, key), className: "text-blue-600 hover:text-blue-700", "aria-label": "Edit", children: (0, jsx_runtime_1.jsx)(lucide_react_1.Pencil, { size: 18 }) })] }))] }) }, 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)))) }));
 };
-exports.ConfigViewer = ConfigViewer;

package/dist/components/example_component.js

@@ -1,14 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExampleComponent = void 0;
-const jsx_runtime_1 = require("react/jsx-runtime");
-const utils_1 = require("../lib/utils");
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../lib/utils.js';
 /**
  * Example component for demonstrating the component library setup
  * @param props - Component props
  * @returns React component
  */
-const ExampleComponent = ({ title = 'Example Component', className, }) => {
-    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, utils_1.cn)('cls_example_component p-4 border rounded-lg', className), children: [(0, jsx_runtime_1.jsx)("h2", { className: "text-xl font-semibold", children: title }), (0, jsx_runtime_1.jsx)("p", { className: "text-muted-foreground mt-2", children: "This is an example component for the config management library." })] }));
+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." })] }));
 };
-exports.ExampleComponent = ExampleComponent;

package/dist/components/index.js

@@ -1,11 +1,5 @@
-"use strict";
 // Component exports
 // Export all components from this file for easy importing
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigEditor = exports.ConfigViewer = exports.ExampleComponent = void 0;
-var example_component_js_1 = require("./example_component.js");
-Object.defineProperty(exports, "ExampleComponent", { enumerable: true, get: function () { return example_component_js_1.ExampleComponent; } });
-var config_viewer_js_1 = require("./config_viewer.js");
-Object.defineProperty(exports, "ConfigViewer", { enumerable: true, get: function () { return config_viewer_js_1.ConfigViewer; } });
-var config_editor_js_1 = require("./config_editor.js");
-Object.defineProperty(exports, "ConfigEditor", { enumerable: true, get: function () { return config_editor_js_1.ConfigEditor; } });
+export { ExampleComponent } from './example_component.js';
+export { ConfigViewer } from './config_viewer.js';
+export { ConfigEditor } from './config_editor.js';

package/dist/index.js

@@ -1,21 +1,5 @@
-"use strict";
 // Main entry point for the component library
 // Export all components and utilities from this file
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./components/index.js"), exports);
-__exportStar(require("./lib/utils.js"), exports);
-__exportStar(require("./lib/index.js"), exports);
+export * from './components/index.js';
+export * from './lib/utils.js';
+export * from './lib/index.js';

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

@@ -6,23 +6,31 @@
  * 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';
+import type { ConfigProvider, HazoConfigOptions } from './types.js';
 /**
  * HazoConfig class
  *
  * Implements ConfigProvider interface for managing INI configuration files.
- * Provides sync read/write operations with in-memory caching.
+ * Provides sync read/write operations with in-memory caching and automatic cache refresh.
  */
 export declare class HazoConfig implements ConfigProvider {
     private filePath;
     private logger;
     private config;
+    private cache_ttl_ms;
+    private disable_cache;
+    private last_cache_refresh;
     /**
      * Constructor
-     * @param options - Configuration options including filePath and optional logger
+     * @param options - Configuration options including filePath, optional logger, cache settings
      * @throws Error if file doesn't exist
      */
     constructor(options: HazoConfigOptions);
+    /**
+     * Check if cache needs to be refreshed and refresh if needed
+     * This method is called before read operations to ensure cache is up to date
+     */
+    private ensure_cache_fresh;
     /**
      * Get a configuration value by section and key
      * @param section - The configuration section name

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

@@ -1 +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"}
+{"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,YAAY,CAAA;AAa3E;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,kBAAkB,CAAY;IAEtC;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAkBtC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKrD;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAK/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;IA0Cf;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CASzD"}

package/dist/lib/config-loader.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Purpose: Main implementation of HazoConfig
  *
@@ -7,15 +6,10 @@
  * in-memory caching, sync operations, and preservation of file formatting.
  * Zero dependencies - only Node.js built-ins and the 'ini' package.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HazoConfig = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const ini_1 = __importDefault(require("ini"));
-const types_1 = require("./types");
+import fs from 'fs';
+import path from 'path';
+import ini from 'ini';
+import { ConfigErrorCode as EC } from './types.js';
 /**
  * No-op logger implementation (default when no logger provided)
  */
@@ -29,12 +23,12 @@ const no_op_logger = {
  * HazoConfig class
  *
  * Implements ConfigProvider interface for managing INI configuration files.
- * Provides sync read/write operations with in-memory caching.
+ * Provides sync read/write operations with in-memory caching and automatic cache refresh.
  */
-class HazoConfig {
+export class HazoConfig {
     /**
      * Constructor
-     * @param options - Configuration options including filePath and optional logger
+     * @param options - Configuration options including filePath, optional logger, cache settings
      * @throws Error if file doesn't exist
      */
     constructor(options) {
@@ -56,18 +50,60 @@ class HazoConfig {
             writable: true,
             value: {}
         });
-        this.filePath = path_1.default.resolve(options.filePath);
+        Object.defineProperty(this, "cache_ttl_ms", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "disable_cache", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "last_cache_refresh", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        this.filePath = path.resolve(options.filePath);
         this.logger = options.logger || no_op_logger;
+        this.cache_ttl_ms = options.cache_ttl_ms ?? 5000; // Default 5 seconds
+        this.disable_cache = options.disable_cache ?? false; // Default: caching enabled
         // Validate file exists
-        if (!fs_1.default.existsSync(this.filePath)) {
+        if (!fs.existsSync(this.filePath)) {
             const error = new Error(`Configuration file not found: ${this.filePath}`);
-            error.code = types_1.ConfigErrorCode.FILE_NOT_FOUND;
+            error.code = EC.FILE_NOT_FOUND;
             this.logger.error(`[HazoConfig] Configuration file not found: ${this.filePath}`);
             throw error;
         }
         // Load initial configuration
         this.refresh();
     }
+    /**
+     * Check if cache needs to be refreshed and refresh if needed
+     * This method is called before read operations to ensure cache is up to date
+     */
+    ensure_cache_fresh() {
+        if (this.disable_cache) {
+            // If caching is disabled, always refresh from disk
+            this.refresh();
+            return;
+        }
+        if (this.cache_ttl_ms === 0) {
+            // If TTL is 0, cache never expires (only manual refresh)
+            return;
+        }
+        const now = Date.now();
+        const cache_age = now - this.last_cache_refresh;
+        if (cache_age >= this.cache_ttl_ms) {
+            // Cache has expired, refresh from disk
+            this.logger.debug(`[HazoConfig] Cache expired (age: ${cache_age}ms, ttl: ${this.cache_ttl_ms}ms), refreshing from disk`);
+            this.refresh();
+        }
+    }
     /**
      * Get a configuration value by section and key
      * @param section - The configuration section name
@@ -75,6 +111,7 @@ class HazoConfig {
      * @returns The configuration value, or undefined if not found
      */
     get(section, key) {
+        this.ensure_cache_fresh();
         return this.config[section]?.[key];
     }
     /**
@@ -83,6 +120,7 @@ class HazoConfig {
      * @returns A record of key-value pairs for the section, or undefined if section doesn't exist
      */
     getSection(section) {
+        this.ensure_cache_fresh();
         return this.config[section] ? { ...this.config[section] } : undefined;
     }
     /**
@@ -105,17 +143,17 @@ class HazoConfig {
     save() {
         try {
             // Convert config object back to INI format
-            const iniContent = ini_1.default.stringify(this.config, {
+            const iniContent = ini.stringify(this.config, {
                 section: '[',
                 whitespace: true
             });
             // Write to file
-            fs_1.default.writeFileSync(this.filePath, iniContent, 'utf-8');
+            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 = types_1.ConfigErrorCode.WRITE_ERROR;
+            configError.code = EC.WRITE_ERROR;
             configError.originalError = error;
             this.logger.error(`[HazoConfig] Failed to save configuration: ${this.filePath}`, { error: String(error) });
             throw configError;
@@ -128,9 +166,9 @@ class HazoConfig {
     refresh() {
         try {
             // Read file content
-            const content = fs_1.default.readFileSync(this.filePath, 'utf-8');
+            const content = fs.readFileSync(this.filePath, 'utf-8');
             // Parse INI content
-            const parsed = ini_1.default.parse(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)) {
@@ -141,6 +179,8 @@ class HazoConfig {
                     }
                 }
             }
+            // Update cache timestamp
+            this.last_cache_refresh = Date.now();
             this.logger.info(`[HazoConfig] Configuration refreshed from: ${this.filePath}`, {
                 sections: Object.keys(this.config)
             });
@@ -149,13 +189,13 @@ class HazoConfig {
             // Handle file read errors
             if (error.code === 'ENOENT') {
                 const configError = new Error(`Configuration file not found: ${this.filePath}`);
-                configError.code = types_1.ConfigErrorCode.FILE_NOT_FOUND;
+                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 = types_1.ConfigErrorCode.PARSE_ERROR;
+            configError.code = EC.PARSE_ERROR;
             configError.originalError = error;
             this.logger.error(`[HazoConfig] Failed to parse configuration: ${this.filePath}`, { error: String(error) });
             throw configError;
@@ -173,6 +213,7 @@ class HazoConfig {
      * @returns A record of all sections and their key-value pairs
      */
     getAllSections() {
+        this.ensure_cache_fresh();
         // Return a deep copy to prevent external modification
         const result = {};
         for (const [section, values] of Object.entries(this.config)) {
@@ -181,4 +222,3 @@ class HazoConfig {
         return result;
     }
 }
-exports.HazoConfig = HazoConfig;

package/dist/lib/index.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Purpose: Main export for the HazoConfig library.
  *
@@ -6,11 +5,6 @@
  * configuration management utility. It serves as the primary entry point
  * for consumers of the library.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigErrorCode = exports.MockConfigProvider = exports.HazoConfig = void 0;
-var config_loader_js_1 = require("./config-loader.js");
-Object.defineProperty(exports, "HazoConfig", { enumerable: true, get: function () { return config_loader_js_1.HazoConfig; } });
-var mock_config_provider_js_1 = require("./mock_config_provider.js");
-Object.defineProperty(exports, "MockConfigProvider", { enumerable: true, get: function () { return mock_config_provider_js_1.MockConfigProvider; } });
-var types_js_1 = require("./types.js");
-Object.defineProperty(exports, "ConfigErrorCode", { enumerable: true, get: function () { return types_js_1.ConfigErrorCode; } });
+export { HazoConfig } from './config-loader.js';
+export { MockConfigProvider } from './mock_config_provider.js';
+export { ConfigErrorCode } from './types.js';

package/dist/lib/mock_config_provider.d.ts

@@ -1,4 +1,4 @@
-import type { ConfigProvider } from './types';
+import type { ConfigProvider } from './types.js';
 /**
  * Mock config provider that stores configuration in memory
  * Useful for testing and Storybook demonstrations where file system is not available

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

@@ -1 +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"}
+{"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,YAAY,CAAA;AAEhD;;;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

@@ -1,13 +1,10 @@
-"use strict";
 // Mock config provider for browser/Storybook testing
 // Implements ConfigProvider interface using in-memory storage instead of file system
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MockConfigProvider = void 0;
 /**
  * Mock config provider that stores configuration in memory
  * Useful for testing and Storybook demonstrations where file system is not available
  */
-class MockConfigProvider {
+export class MockConfigProvider {
     /**
      * Constructor
      * @param initial_config - Optional initial configuration data
@@ -88,4 +85,3 @@ class MockConfigProvider {
         }
     }
 }
-exports.MockConfigProvider = MockConfigProvider;

package/dist/lib/types.d.ts

@@ -68,6 +68,18 @@ export interface HazoConfigOptions {
      * Optional logger instance for logging operations
      */
     logger?: Logger;
+    /**
+     * Cache time-to-live in milliseconds (default: 5000ms)
+     * When cache expires, configuration will be automatically refreshed from disk
+     * Set to 0 to disable automatic cache expiration (cache will only refresh on manual refresh() call)
+     */
+    cache_ttl_ms?: number;
+    /**
+     * Disable caching entirely (default: false)
+     * When true, every get() and getSection() call will read from disk
+     * When false, values are cached in memory and refreshed based on cache_ttl_ms
+     */
+    disable_cache?: boolean;
 }
 /**
  * Error codes for configuration operations

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

@@ -1 +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"}
+{"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;IAEf;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;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

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Purpose: Core interfaces and types for the HazoConfig component.
  *
@@ -7,16 +6,14 @@
  * ConfigProvider pattern, configuration options, and error types, ensuring
  * loose coupling and reusability across different projects.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigErrorCode = void 0;
 /**
  * Error codes for configuration operations
  */
-var ConfigErrorCode;
+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 || (exports.ConfigErrorCode = ConfigErrorCode = {}));
+})(ConfigErrorCode || (ConfigErrorCode = {}));

package/dist/lib/utils.js

@@ -1,15 +1,12 @@
-"use strict";
 // Utility functions for the component library
 // Provides class name merging functionality using clsx and tailwind-merge
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cn = cn;
-const clsx_1 = require("clsx");
-const tailwind_merge_1 = require("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
  */
-function cn(...inputs) {
-    return (0, tailwind_merge_1.twMerge)((0, clsx_1.clsx)(inputs));
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
 }

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "hazo_config",
-  "version": "1.3.1",
+  "version": "1.4.1",
   "description": "Config wrapper with error handling",
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/components/config_editor.stories.tsx

@@ -2,8 +2,8 @@
 // Demonstrates the config editor component with mock config provider
 
 import type { Meta, StoryObj } from '@storybook/react'
-import { ConfigEditor } from './config_editor'
-import { MockConfigProvider } from '../lib/mock_config_provider'
+import { ConfigEditor } from './config_editor.js'
+import { MockConfigProvider } from '../lib/mock_config_provider.js'
 
 /**
  * Sample configuration data for testing

package/src/components/config_editor.tsx

@@ -2,8 +2,8 @@
 // Provides a more advanced interface for editing configuration values
 
 import React, { useState, useEffect } from 'react'
-import { cn } from '../lib/utils'
-import type { ConfigProvider } from '../lib/types'
+import { cn } from '../lib/utils.js'
+import type { ConfigProvider } from '../lib/types.js'
 import { RefreshCw, Save } from 'lucide-react'
 
 /**

package/src/components/config_viewer.stories.tsx

@@ -2,8 +2,8 @@
 // Demonstrates the config viewer component with mock config provider
 
 import type { Meta, StoryObj } from '@storybook/react'
-import { ConfigViewer } from './config_viewer'
-import { MockConfigProvider } from '../lib/mock_config_provider'
+import { ConfigViewer } from './config_viewer.js'
+import { MockConfigProvider } from '../lib/mock_config_provider.js'
 
 /**
  * Sample configuration data for testing

package/src/components/config_viewer.tsx

@@ -2,8 +2,8 @@
 // Displays configuration sections and values in a readable format
 
 import React, { useState, useEffect } from 'react'
-import { cn } from '../lib/utils'
-import type { ConfigProvider } from '../lib/types'
+import { cn } from '../lib/utils.js'
+import type { ConfigProvider } from '../lib/types.js'
 import { Pencil, CheckCircle2, XCircle } from 'lucide-react'
 
 /**

package/src/components/example_component.stories.tsx

@@ -2,7 +2,7 @@
 // Demonstrates how to create stories for components
 
 import type { Meta, StoryObj } from '@storybook/react'
-import { ExampleComponent } from './example_component'
+import { ExampleComponent } from './example_component.js'
 
 /**
  * Meta configuration for ExampleComponent stories

package/src/components/example_component.tsx

@@ -2,7 +2,7 @@
 // This is a placeholder component to demonstrate the setup
 
 import React from 'react'
-import { cn } from '../lib/utils'
+import { cn } from '../lib/utils.js'
 
 /**
  * Example component props interface

package/src/lib/config-loader.ts

@@ -10,8 +10,8 @@
 import fs from 'fs'
 import path from 'path'
 import ini from 'ini'
-import type { ConfigProvider, HazoConfigOptions, Logger } from './types'
-import { ConfigErrorCode as EC } from './types'
+import type { ConfigProvider, HazoConfigOptions, Logger } from './types.js'
+import { ConfigErrorCode as EC } from './types.js'
 
 /**
  * No-op logger implementation (default when no logger provided)
@@ -27,21 +27,26 @@ const no_op_logger: Logger = {
  * HazoConfig class
  * 
  * Implements ConfigProvider interface for managing INI configuration files.
- * Provides sync read/write operations with in-memory caching.
+ * Provides sync read/write operations with in-memory caching and automatic cache refresh.
  */
 export class HazoConfig implements ConfigProvider {
   private filePath: string
   private logger: Logger
   private config: Record<string, Record<string, string>> = {}
+  private cache_ttl_ms: number
+  private disable_cache: boolean
+  private last_cache_refresh: number = 0
 
   /**
    * Constructor
-   * @param options - Configuration options including filePath and optional logger
+   * @param options - Configuration options including filePath, optional logger, cache settings
    * @throws Error if file doesn't exist
    */
   constructor(options: HazoConfigOptions) {
     this.filePath = path.resolve(options.filePath)
     this.logger = options.logger || no_op_logger
+    this.cache_ttl_ms = options.cache_ttl_ms ?? 5000 // Default 5 seconds
+    this.disable_cache = options.disable_cache ?? false // Default: caching enabled
 
     // Validate file exists
     if (!fs.existsSync(this.filePath)) {
@@ -55,6 +60,32 @@ export class HazoConfig implements ConfigProvider {
     this.refresh()
   }
 
+  /**
+   * Check if cache needs to be refreshed and refresh if needed
+   * This method is called before read operations to ensure cache is up to date
+   */
+  private ensure_cache_fresh(): void {
+    if (this.disable_cache) {
+      // If caching is disabled, always refresh from disk
+      this.refresh()
+      return
+    }
+
+    if (this.cache_ttl_ms === 0) {
+      // If TTL is 0, cache never expires (only manual refresh)
+      return
+    }
+
+    const now = Date.now()
+    const cache_age = now - this.last_cache_refresh
+
+    if (cache_age >= this.cache_ttl_ms) {
+      // Cache has expired, refresh from disk
+      this.logger.debug(`[HazoConfig] Cache expired (age: ${cache_age}ms, ttl: ${this.cache_ttl_ms}ms), refreshing from disk`)
+      this.refresh()
+    }
+  }
+
   /**
    * Get a configuration value by section and key
    * @param section - The configuration section name
@@ -62,6 +93,7 @@ export class HazoConfig implements ConfigProvider {
    * @returns The configuration value, or undefined if not found
    */
   get(section: string, key: string): string | undefined {
+    this.ensure_cache_fresh()
     return this.config[section]?.[key]
   }
 
@@ -71,6 +103,7 @@ export class HazoConfig implements ConfigProvider {
    * @returns A record of key-value pairs for the section, or undefined if section doesn't exist
    */
   getSection(section: string): Record<string, string> | undefined {
+    this.ensure_cache_fresh()
     return this.config[section] ? { ...this.config[section] } : undefined
   }
 
@@ -135,6 +168,9 @@ export class HazoConfig implements ConfigProvider {
         }
       }
 
+      // Update cache timestamp
+      this.last_cache_refresh = Date.now()
+
       this.logger.info(`[HazoConfig] Configuration refreshed from: ${this.filePath}`, {
         sections: Object.keys(this.config)
       })
@@ -169,6 +205,7 @@ export class HazoConfig implements ConfigProvider {
    * @returns A record of all sections and their key-value pairs
    */
   getAllSections(): Record<string, Record<string, string>> {
+    this.ensure_cache_fresh()
     // Return a deep copy to prevent external modification
     const result: Record<string, Record<string, string>> = {}
     for (const [section, values] of Object.entries(this.config)) {

package/src/lib/mock_config_provider.ts

@@ -1,7 +1,7 @@
 // Mock config provider for browser/Storybook testing
 // Implements ConfigProvider interface using in-memory storage instead of file system
 
-import type { ConfigProvider } from './types'
+import type { ConfigProvider } from './types.js'
 
 /**
  * Mock config provider that stores configuration in memory

package/src/lib/types.ts

@@ -76,6 +76,20 @@ export interface HazoConfigOptions {
    * Optional logger instance for logging operations
    */
   logger?: Logger
+
+  /**
+   * Cache time-to-live in milliseconds (default: 5000ms)
+   * When cache expires, configuration will be automatically refreshed from disk
+   * Set to 0 to disable automatic cache expiration (cache will only refresh on manual refresh() call)
+   */
+  cache_ttl_ms?: number
+
+  /**
+   * Disable caching entirely (default: false)
+   * When true, every get() and getSection() call will read from disk
+   * When false, values are cached in memory and refreshed based on cache_ttl_ms
+   */
+  disable_cache?: boolean
 }
 
 /**

package/tsconfig.build.json

@@ -2,13 +2,15 @@
   "extends": "./tsconfig.json",
   "compilerOptions": {
     "noEmit": false,
-    "module": "Node16",
+    "module": "ESNext",
     "declaration": true,
     "declarationMap": true,
     "outDir": "./dist",
     "rootDir": "./src",
     "allowImportingTsExtensions": false,
-    "moduleResolution": "Node16"
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true
   },
   "include": ["src"],
   "exclude": ["**/*.stories.tsx", "**/*.test.tsx", "**/*.test.ts"]