hazo_config 2.0.2 → 2.1.1

package/CHANGE_LOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## 2.1.1
+- chore: add `engines` field (`node >= 18.0.0`) and `prepublishOnly` script
+- chore: widen React peer deps to support React 18 and 19
+- chore: add CHANGE_LOG.md, SETUP_CHECKLIST.md, AGENTS.md, config/ sample, design/ architecture
+- chore: clean up test-app duplicate transitive dependencies
+- chore: update .npmignore for new dev files
+
+## 2.1.0
+- feat: add JSON import/export to AppConfigListEditor
+- Export utility functions: `validate_import_data`, `merge_items`, `export_items_to_json`, `generate_export_filename`
+
+## 2.0.2
+- feat: add AppConfigListEditor component with shadcn/ui
+- Generic CRUD list editor for arrays of structured objects (tags, document types, etc.)
+- Supports field types: text, textarea, color_swatch, select, number, toggle
+
+## 2.0.1
+- chore: add test-app build artifacts to .gitignore
+
+## 2.0.0
+- **BREAKING**: Renamed `org_id` to `scope_id` in `AppConfigItem` and `AppConfigContext`
+- **BREAKING**: Split `config_value` into `config_value_text` and `config_value_json`
+- **BREAKING**: Added `config_type` field (`'general'` | `'json'`)
+- feat: add database-backed AppConfig component with JSON editing support
+- feat: add `useAppConfig` hook for async database operations
+- See `MIGRATION_V2.md` for upgrade guide
+
+## 1.4.2
+- fix: separate server/client exports to prevent Next.js bundling errors
+- Added `hazo_config/server` entry point with `server-only` guard
+
+## 1.4.1
+- fix: update JS output issues
+
+## 1.4.0
+- fix: add missing files to package.json
+- fix: ES module exports with explicit .js extensions
+- Added package development rules
+
+## 1.0.0
+- Initial release
+- HazoConfig class with INI file support, TTL-based caching
+- ConfigViewer and ConfigEditor React components
+- MockConfigProvider for testing
+- Sensitive field masking (auto-detection of passwords, tokens, keys)

package/README.md

@@ -270,6 +270,18 @@ The `AppConfigListEditor` is a generic, reusable CRUD list editor for arrays of
 - Save status indicators (saving/saved/error)
 - Custom item rendering (indicator, preview, full row override)
 - Field validation with inline error messages
+- **JSON import/export** — export items as `.json` file, import from file with validation and duplicate skipping
+
+#### JSON Import/Export
+
+The list editor includes built-in Export and Import buttons in the section bar. Export downloads the current items as a formatted JSON file. Import opens a file picker, validates the JSON against column definitions, and merges new items into the list (skipping duplicates by ID).
+
+Utility functions are also exported for programmatic use:
+
+```typescript
+import { validate_import_data, merge_items, export_items_to_json, generate_export_filename } from 'hazo_config'
+import type { ImportResult } from 'hazo_config'
+```
 
 ## Development
 

package/SETUP_CHECKLIST.md

@@ -0,0 +1,132 @@
+# Setup Checklist
+
+Step-by-step setup for consuming apps using hazo_config.
+
+## 1. Install
+
+```bash
+npm install hazo_config
+```
+
+## 2. Tailwind CSS Setup
+
+### Tailwind v4
+Add `@source` directive in your globals.css to ensure Tailwind compiles classes from the package:
+
+```css
+@import "tailwindcss";
+@source "../node_modules/hazo_config/dist";
+```
+
+### Tailwind v3
+Add the dist directory to your `tailwind.config.js` content array:
+
+```js
+module.exports = {
+  content: [
+    './src/**/*.{js,ts,jsx,tsx}',
+    './node_modules/hazo_config/dist/**/*.{js,ts,jsx,tsx}',
+  ],
+}
+```
+
+## 3. CSS Custom Properties (Optional)
+
+Add these CSS variables if you want themed styling:
+
+```css
+:root {
+  --hazo-config-bg: #ffffff;
+  --hazo-config-border: #e2e8f0;
+  --hazo-config-text: #1a202c;
+  --hazo-config-muted: #718096;
+}
+```
+
+## 4. Import Components
+
+### Client-side (components, browser)
+```typescript
+import { ConfigViewer, ConfigEditor, AppConfig, MockConfigProvider } from 'hazo_config'
+```
+
+### Server-side (API routes, server components)
+```typescript
+import { HazoConfig } from 'hazo_config/server'
+```
+
+## 5. INI File Config (if using HazoConfig)
+
+Create your config file:
+```ini
+[database]
+host = localhost
+port = 5432
+
+[app]
+name = My Application
+debug = false
+```
+
+Initialize in server code:
+```typescript
+import { HazoConfig } from 'hazo_config/server'
+
+const config = new HazoConfig({
+  filePath: './config/app_config.ini',
+  create_if_missing: true,
+  cache_ttl_ms: 5000,
+})
+```
+
+## 6. Database Config (if using AppConfig)
+
+Create the `hazo_app_config` table in your database:
+
+### PostgreSQL
+```sql
+CREATE TABLE IF NOT EXISTS hazo_app_config (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  scope_id UUID,
+  user_id UUID,
+  config_section TEXT NOT NULL,
+  config_name TEXT NOT NULL,
+  config_value_text TEXT DEFAULT '',
+  config_value_json JSONB DEFAULT '{}',
+  config_type TEXT NOT NULL DEFAULT 'general',
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  changed_at TIMESTAMPTZ DEFAULT NOW()
+);
+```
+
+### SQLite
+```sql
+CREATE TABLE IF NOT EXISTS hazo_app_config (
+  id TEXT PRIMARY KEY,
+  scope_id TEXT,
+  user_id TEXT,
+  config_section TEXT NOT NULL,
+  config_name TEXT NOT NULL,
+  config_value_text TEXT DEFAULT '',
+  config_value_json TEXT DEFAULT '{}',
+  config_type TEXT NOT NULL DEFAULT 'general',
+  created_at TEXT DEFAULT (datetime('now')),
+  changed_at TEXT DEFAULT (datetime('now'))
+);
+```
+
+## 7. Next.js Configuration
+
+Add to `next.config.js`:
+```javascript
+const nextConfig = {
+  transpilePackages: ['hazo_config'],
+}
+```
+
+## 8. Verify
+
+- [ ] `import { ConfigViewer } from 'hazo_config'` resolves without errors
+- [ ] `import { HazoConfig } from 'hazo_config/server'` works in server code
+- [ ] Tailwind classes from hazo_config render correctly (check backgrounds, borders)
+- [ ] Sensitive fields are masked in ConfigViewer/ConfigEditor

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

@@ -1 +1 @@
-{"version":3,"file":"app_config_list_editor.d.ts","sourceRoot":"","sources":["../../../src/components/app_config_list_editor/app_config_list_editor.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,wBAAwB,EAAqC,MAAM,YAAY,CAAA;AAQ7F;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACrE,KAAK,EACL,eAAe,EACf,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,WAAW,EACX,aAAqB,EACrB,gBAAoB,EACpB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,wBAAgC,EAChC,SAAS,EACT,WAAoB,GACrB,EAAE,wBAAwB,CAAC,CAAC,CAAC,2CAsP7B"}
+{"version":3,"file":"app_config_list_editor.d.ts","sourceRoot":"","sources":["../../../src/components/app_config_list_editor/app_config_list_editor.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,wBAAwB,EAAqC,MAAM,YAAY,CAAA;AAS7F;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACrE,KAAK,EACL,eAAe,EACf,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,WAAW,EACX,aAAqB,EACrB,gBAAoB,EACpB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,wBAAgC,EAChC,SAAS,EACT,WAAoB,GACrB,EAAE,wBAAwB,CAAC,CAAC,CAAC,2CAgQ7B"}

package/dist/components/app_config_list_editor/app_config_list_editor.js

@@ -10,6 +10,7 @@ import { SearchBar } from './components/search_bar.js';
 import { EmptyState } from './components/empty_state.js';
 import { DeleteDialog } from './components/delete_dialog.js';
 import { SaveStatusIndicator } from './components/save_status_indicator.js';
+import { ImportExportButtons } from './components/import_export_buttons.js';
 /**
  * AppConfigListEditor - A polished CRUD list editor for config item arrays.
  * Purely callback-based: no API calls, no database access.
@@ -122,7 +123,7 @@ export function AppConfigListEditor({ items, on_items_change, columns, id_field,
         }
         return String(delete_state.item[id_field] ?? '');
     }, [delete_state, columns, id_field]);
-    return (_jsxs("div", { className: cn('cls_list_editor', className), children: [(title || description) && (_jsxs("div", { className: "cls_list_editor_header mb-6", children: [title && (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx("h2", { className: "text-2xl font-bold text-gray-900", children: title }), _jsx(SaveStatusIndicator, { status: save_status })] })), description && (_jsx("p", { className: "text-sm text-gray-500 mt-1", children: description }))] })), _jsxs("div", { className: "cls_list_editor_section_bar flex items-center justify-between mb-3", children: [_jsx("div", { className: "flex items-center gap-2", children: _jsx("span", { className: "text-xs font-semibold uppercase tracking-wider text-gray-500", children: section_label }) }), _jsxs("button", { type: "button", onClick: handle_add, disabled: is_max_reached, className: cn('inline-flex items-center gap-1.5 px-3 py-1.5 text-sm font-medium rounded-full transition-colors', is_max_reached
-                            ? 'bg-gray-100 text-gray-400 cursor-not-allowed'
-                            : 'bg-violet-600 hover:bg-violet-700 text-white'), title: is_max_reached ? `Maximum of ${max_items} items reached` : undefined, children: [_jsx(Plus, { className: "w-4 h-4" }), "Add"] })] }), show_search && (_jsx("div", { className: "mb-3", children: _jsx(SearchBar, { value: search_term, on_change: set_search_term, item_count: filtered_items.length, item_label: item_label }) })), _jsx("div", { className: "cls_list_editor_card rounded-xl border border-gray-200 bg-white overflow-hidden", children: items.length === 0 ? (_jsx(EmptyState, { item_label: item_label, on_add: handle_add })) : filtered_items.length === 0 ? (_jsxs("div", { className: "py-8 text-center text-sm text-gray-500", children: ["No ", item_label, " matching \u201C", search_term, "\u201D"] })) : (_jsx("div", { className: "divide-y divide-gray-100", children: filtered_items.map((item, index) => (_jsx(ListItemRow, { item: item, index: index, columns: columns, render_item: render_item, render_item_indicator: render_item_indicator, on_edit: () => handle_edit(item), on_delete: () => handle_delete_request(item) }, String(item[id_field])))) })) }), is_max_reached && (_jsxs("p", { className: "text-xs text-gray-400 mt-2", children: ["Maximum of ", max_items, " ", item_label, " reached."] })), edit_state && (_jsx(EditModal, { open: true, mode: edit_state.mode, item: edit_state.item, columns: columns, id_field: id_field, auto_id_from: auto_id_from, id_editable_after_create: id_editable_after_create, existing_ids: existing_ids, item_type_label: item_type_label, render_preview: render_preview, on_save: handle_save, on_cancel: handle_cancel_edit })), delete_state && (_jsx(DeleteDialog, { open: true, item_name: delete_item_name, message: delete_message, on_confirm: handle_delete_confirm, on_cancel: handle_cancel_delete }))] }));
+    return (_jsxs("div", { className: cn('cls_list_editor', className), children: [(title || description) && (_jsxs("div", { className: "cls_list_editor_header mb-6", children: [title && (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx("h2", { className: "text-2xl font-bold text-gray-900", children: title }), _jsx(SaveStatusIndicator, { status: save_status })] })), description && (_jsx("p", { className: "text-sm text-gray-500 mt-1", children: description }))] })), _jsxs("div", { className: "cls_list_editor_section_bar flex items-center justify-between mb-3", children: [_jsx("div", { className: "flex items-center gap-2", children: _jsx("span", { className: "text-xs font-semibold uppercase tracking-wider text-gray-500", children: section_label }) }), _jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx(ImportExportButtons, { items: items, on_items_change: on_items_change, columns: columns, id_field: id_field, title: title, max_items: max_items }), _jsxs("button", { type: "button", onClick: handle_add, disabled: is_max_reached, className: cn('inline-flex items-center gap-1.5 px-3 py-1.5 text-sm font-medium rounded-full transition-colors', is_max_reached
+                                    ? 'bg-gray-100 text-gray-400 cursor-not-allowed'
+                                    : 'bg-violet-600 hover:bg-violet-700 text-white'), title: is_max_reached ? `Maximum of ${max_items} items reached` : undefined, children: [_jsx(Plus, { className: "w-4 h-4" }), "Add"] })] })] }), show_search && (_jsx("div", { className: "mb-3", children: _jsx(SearchBar, { value: search_term, on_change: set_search_term, item_count: filtered_items.length, item_label: item_label }) })), _jsx("div", { className: "cls_list_editor_card rounded-xl border border-gray-200 bg-white overflow-hidden", children: items.length === 0 ? (_jsx(EmptyState, { item_label: item_label, on_add: handle_add })) : filtered_items.length === 0 ? (_jsxs("div", { className: "py-8 text-center text-sm text-gray-500", children: ["No ", item_label, " matching \u201C", search_term, "\u201D"] })) : (_jsx("div", { className: "divide-y divide-gray-100", children: filtered_items.map((item, index) => (_jsx(ListItemRow, { item: item, index: index, columns: columns, render_item: render_item, render_item_indicator: render_item_indicator, on_edit: () => handle_edit(item), on_delete: () => handle_delete_request(item) }, String(item[id_field])))) })) }), is_max_reached && (_jsxs("p", { className: "text-xs text-gray-400 mt-2", children: ["Maximum of ", max_items, " ", item_label, " reached."] })), edit_state && (_jsx(EditModal, { open: true, mode: edit_state.mode, item: edit_state.item, columns: columns, id_field: id_field, auto_id_from: auto_id_from, id_editable_after_create: id_editable_after_create, existing_ids: existing_ids, item_type_label: item_type_label, render_preview: render_preview, on_save: handle_save, on_cancel: handle_cancel_edit })), delete_state && (_jsx(DeleteDialog, { open: true, item_name: delete_item_name, message: delete_message, on_confirm: handle_delete_confirm, on_cancel: handle_cancel_delete }))] }));
 }

package/dist/components/app_config_list_editor/components/import_export_buttons.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnDef } from '../types.js';
+interface ImportExportButtonsProps<T extends Record<string, unknown>> {
+    items: T[];
+    on_items_change: (items: T[]) => void;
+    columns: ColumnDef<T>[];
+    id_field: keyof T & string;
+    title?: string;
+    max_items?: number;
+}
+export declare function ImportExportButtons<T extends Record<string, unknown>>({ items, on_items_change, columns, id_field, title, max_items, }: ImportExportButtonsProps<T>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=import_export_buttons.d.ts.map

package/dist/components/app_config_list_editor/components/import_export_buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import_export_buttons.d.ts","sourceRoot":"","sources":["../../../../src/components/app_config_list_editor/components/import_export_buttons.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAQ5C,UAAU,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,eAAe,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IACrC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACrE,KAAK,EACL,eAAe,EACf,OAAO,EACP,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE,wBAAwB,CAAC,CAAC,CAAC,2CA0H7B"}

package/dist/components/app_config_list_editor/components/import_export_buttons.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Import/Export buttons for AppConfigListEditor
+// Provides JSON export (download) and import (file picker) with transient status messages
+import { useRef, useState, useCallback, useEffect } from 'react';
+import { Download, Upload } from 'lucide-react';
+import { cn } from '../../../lib/utils.js';
+import { validate_import_data, merge_items, export_items_to_json, generate_export_filename, } from '../utils/json_import_export.js';
+export function ImportExportButtons({ items, on_items_change, columns, id_field, title, max_items, }) {
+    const file_input_ref = useRef(null);
+    const [status_message, set_status_message] = useState(null);
+    // Auto-fade status message after 3 seconds
+    useEffect(() => {
+        if (!status_message)
+            return;
+        const timer = setTimeout(() => set_status_message(null), 3000);
+        return () => clearTimeout(timer);
+    }, [status_message]);
+    const handle_export = useCallback(() => {
+        const filename = generate_export_filename(title);
+        export_items_to_json(items, filename);
+    }, [items, title]);
+    const handle_import_click = useCallback(() => {
+        // Reset input so the same file can be re-imported
+        if (file_input_ref.current) {
+            file_input_ref.current.value = '';
+        }
+        file_input_ref.current?.click();
+    }, []);
+    const handle_file_selected = useCallback((event) => {
+        const file = event.target.files?.[0];
+        if (!file)
+            return;
+        const reader = new FileReader();
+        reader.onload = (e) => {
+            const text = e.target?.result;
+            if (typeof text !== 'string') {
+                set_status_message({ text: 'Failed to read file', is_error: true });
+                return;
+            }
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                set_status_message({ text: 'Invalid JSON file', is_error: true });
+                return;
+            }
+            const { valid_items, errors } = validate_import_data(data, columns, id_field);
+            if (valid_items.length === 0) {
+                const msg = errors.length > 0 ? errors[0] : 'No valid items found';
+                set_status_message({ text: msg, is_error: true });
+                return;
+            }
+            const result = merge_items(items, valid_items, id_field, max_items);
+            on_items_change(result.merged_items);
+            const parts = [];
+            if (result.added_count > 0) {
+                parts.push(`Added ${result.added_count}`);
+            }
+            if (result.skipped_count > 0) {
+                parts.push(`${result.skipped_count} skipped`);
+            }
+            if (errors.length > 0) {
+                parts.push(`${errors.length} invalid`);
+            }
+            set_status_message({
+                text: parts.join(', '),
+                is_error: result.added_count === 0,
+            });
+        };
+        reader.readAsText(file);
+    }, [items, columns, id_field, max_items, on_items_change]);
+    return (_jsxs("div", { className: "cls_import_export flex items-center gap-1.5", children: [status_message && (_jsx("span", { className: cn('cls_import_status text-xs transition-opacity duration-300', status_message.is_error ? 'text-red-600' : 'text-green-600'), children: status_message.text })), _jsxs("button", { type: "button", onClick: handle_export, className: "inline-flex items-center gap-1 px-2 py-1.5 text-xs font-medium text-gray-500 hover:text-gray-700 hover:bg-gray-100 rounded-full transition-colors", title: "Export as JSON", children: [_jsx(Download, { className: "w-3.5 h-3.5" }), "Export"] }), _jsxs("button", { type: "button", onClick: handle_import_click, className: "inline-flex items-center gap-1 px-2 py-1.5 text-xs font-medium text-gray-500 hover:text-gray-700 hover:bg-gray-100 rounded-full transition-colors", title: "Import from JSON", children: [_jsx(Upload, { className: "w-3.5 h-3.5" }), "Import"] }), _jsx("input", { ref: file_input_ref, type: "file", accept: ".json", onChange: handle_file_selected, className: "hidden" })] }));
+}

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

@@ -1,3 +1,4 @@
 export { AppConfigListEditor } from './app_config_list_editor.js';
-export type { AppConfigListEditorProps, ColumnDef } from './types.js';
+export type { AppConfigListEditorProps, ColumnDef, ImportResult } from './types.js';
+export { validate_import_data, merge_items, export_items_to_json, generate_export_filename, } from './utils/json_import_export.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/app_config_list_editor/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/app_config_list_editor/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAA"}

package/dist/components/app_config_list_editor/index.js

@@ -1,2 +1,3 @@
 // Public exports for AppConfigListEditor
 export { AppConfigListEditor } from './app_config_list_editor.js';
+export { validate_import_data, merge_items, export_items_to_json, generate_export_filename, } from './utils/json_import_export.js';

package/dist/components/app_config_list_editor/types.d.ts

@@ -84,6 +84,15 @@ export interface EditModalState<T> {
 export interface DeleteDialogState<T> {
     item: T;
 }
+/**
+ * Result of a JSON import merge operation
+ */
+export interface ImportResult<T> {
+    merged_items: T[];
+    added_count: number;
+    skipped_count: number;
+    errors: string[];
+}
 /**
  * Slugify a string for auto-ID generation.
  * Converts to lowercase, replaces non-alphanumeric chars with underscores,

package/dist/components/app_config_list_editor/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/app_config_list_editor/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/app_config_list_editor/types.ts"],"names":[],"mappings":"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"}

package/dist/components/app_config_list_editor/utils/json_import_export.d.ts

@@ -0,0 +1,26 @@
+import type { ColumnDef, ImportResult } from '../types.js';
+export type { ColumnDef, ImportResult };
+/**
+ * Validate parsed JSON data against column definitions.
+ * Returns valid items and a list of error messages.
+ */
+export declare function validate_import_data<T extends Record<string, unknown>>(data: unknown, columns: ColumnDef<T>[], id_field: keyof T & string): {
+    valid_items: T[];
+    errors: string[];
+};
+/**
+ * Merge incoming items with existing items.
+ * Skips items whose ID already exists in the existing list.
+ * Respects max_items cap.
+ */
+export declare function merge_items<T extends Record<string, unknown>>(existing: T[], incoming: T[], id_field: keyof T & string, max_items?: number): ImportResult<T>;
+/**
+ * Trigger a browser download of items as a JSON file.
+ */
+export declare function export_items_to_json<T>(items: T[], filename: string): void;
+/**
+ * Generate a snake_case filename from a title string.
+ * e.g. "Classification Tags" -> "classification_tags.json"
+ */
+export declare function generate_export_filename(title?: string): string;
+//# sourceMappingURL=json_import_export.d.ts.map

package/dist/components/app_config_list_editor/utils/json_import_export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json_import_export.d.ts","sourceRoot":"","sources":["../../../../src/components/app_config_list_editor/utils/json_import_export.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;AAEvC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EACvB,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,GACzB;IAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAwDxC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,QAAQ,EAAE,CAAC,EAAE,EACb,QAAQ,EAAE,CAAC,EAAE,EACb,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,EAC1B,SAAS,CAAC,EAAE,MAAM,GACjB,YAAY,CAAC,CAAC,CAAC,CA0BjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAW1E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/D"}

package/dist/components/app_config_list_editor/utils/json_import_export.js

@@ -0,0 +1,112 @@
+// JSON import/export utilities for AppConfigListEditor
+// Pure functions for validating, merging, and exporting config item arrays
+/**
+ * Validate parsed JSON data against column definitions.
+ * Returns valid items and a list of error messages.
+ */
+export function validate_import_data(data, columns, id_field) {
+    const errors = [];
+    const valid_items = [];
+    if (!Array.isArray(data)) {
+        return { valid_items: [], errors: ['Expected a JSON array'] };
+    }
+    if (data.length === 0) {
+        return { valid_items: [], errors: ['JSON array is empty'] };
+    }
+    for (let i = 0; i < data.length; i++) {
+        const item = data[i];
+        const item_errors = [];
+        if (item === null || typeof item !== 'object' || Array.isArray(item)) {
+            errors.push(`Item ${i + 1}: not a valid object`);
+            continue;
+        }
+        const record = item;
+        // Check id_field exists and is non-empty
+        if (!(id_field in record) || record[id_field] === '' || record[id_field] === null || record[id_field] === undefined) {
+            item_errors.push(`missing required field "${id_field}"`);
+        }
+        // Check required fields and basic type compatibility
+        for (const col of columns) {
+            const val = record[col.field];
+            if (col.required && (val === undefined || val === null || val === '')) {
+                item_errors.push(`missing required field "${col.field}"`);
+                continue;
+            }
+            if (val === undefined || val === null)
+                continue;
+            // Basic type checks
+            if (col.type === 'number' && typeof val !== 'number') {
+                item_errors.push(`"${col.field}" should be a number`);
+            }
+            if (col.type === 'toggle' && typeof val !== 'boolean') {
+                item_errors.push(`"${col.field}" should be a boolean`);
+            }
+        }
+        if (item_errors.length > 0) {
+            errors.push(`Item ${i + 1}: ${item_errors.join(', ')}`);
+        }
+        else {
+            valid_items.push(record);
+        }
+    }
+    return { valid_items, errors };
+}
+/**
+ * Merge incoming items with existing items.
+ * Skips items whose ID already exists in the existing list.
+ * Respects max_items cap.
+ */
+export function merge_items(existing, incoming, id_field, max_items) {
+    const existing_ids = new Set(existing.map((item) => String(item[id_field])));
+    let skipped_count = 0;
+    const to_add = [];
+    for (const item of incoming) {
+        const id = String(item[id_field]);
+        if (existing_ids.has(id)) {
+            skipped_count++;
+            continue;
+        }
+        // Respect max_items cap
+        if (max_items !== undefined && max_items !== null && existing.length + to_add.length >= max_items) {
+            skipped_count++;
+            continue;
+        }
+        to_add.push(item);
+        existing_ids.add(id);
+    }
+    return {
+        merged_items: [...existing, ...to_add],
+        added_count: to_add.length,
+        skipped_count,
+        errors: [],
+    };
+}
+/**
+ * Trigger a browser download of items as a JSON file.
+ */
+export function export_items_to_json(items, filename) {
+    const json = JSON.stringify(items, null, 2);
+    const blob = new Blob([json], { type: 'application/json' });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+}
+/**
+ * Generate a snake_case filename from a title string.
+ * e.g. "Classification Tags" -> "classification_tags.json"
+ */
+export function generate_export_filename(title) {
+    if (!title)
+        return 'config_items.json';
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .replace(/_+/g, '_');
+    return `${slug}.json`;
+}

package/dist/components/index.d.ts

@@ -9,5 +9,6 @@ export type { UseConfigSectionsResult } from './use_config_sections.js';
 export { useAppConfig } from './use_app_config.js';
 export type { UseAppConfigResult } from '../lib/app_config_types.js';
 export { AppConfigListEditor } from './app_config_list_editor/index.js';
-export type { AppConfigListEditorProps, ColumnDef } from './app_config_list_editor/index.js';
+export type { AppConfigListEditorProps, ColumnDef, ImportResult } from './app_config_list_editor/index.js';
+export { validate_import_data, merge_items, export_items_to_json, generate_export_filename, } from './app_config_list_editor/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAGhE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,0BAA0B,EAC3B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAGpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AACvE,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAGhE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,0BAA0B,EAC3B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAGpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AACvE,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAC1G,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,mCAAmC,CAAA"}

package/dist/components/index.js

@@ -8,3 +8,4 @@ export { useConfigSections, is_sensitive_field, mask_value, DEFAULT_SENSITIVE_PA
 export { useAppConfig } from './use_app_config.js';
 // AppConfigListEditor exports
 export { AppConfigListEditor } from './app_config_list_editor/index.js';
+export { validate_import_data, merge_items, export_items_to_json, generate_export_filename, } from './app_config_list_editor/index.js';

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "hazo_config",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "description": "Config wrapper with error handling",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGE_LOG.md",
+    "SETUP_CHECKLIST.md"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -25,6 +30,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
     "storybook": "npx storybook dev -p 6006",
     "build-storybook": "npx storybook build",
     "test": "vitest run",
@@ -51,6 +57,9 @@
     "url": "https://github.com/pub12/hazo_config/issues"
   },
   "homepage": "https://github.com/pub12/hazo_config#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-dialog": "^1.1.15",
@@ -89,8 +98,8 @@
     "vitest": "^1.6.1"
   },
   "peerDependencies": {
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
     "tailwindcss": "^3.0.0"
   },
   "peerDependenciesMeta": {

package/MIGRATION_V2.md

@@ -1,531 +0,0 @@
-# Migration Guide: hazo_config v1 → v2
-
-## Breaking Changes Summary
-
-Version 2.0.0 introduces a major schema change to support JSON configuration values and replace `org_id` with `scope_id`. This is a **BREAKING CHANGE** requiring code updates and database migration.
-
-## What Changed
-
-### 1. Database Schema
-
-**Old Schema:**
-```sql
-CREATE TABLE hazo_app_config (
-  id TEXT PRIMARY KEY,
-  org_id TEXT,
-  user_id TEXT,
-  config_section TEXT NOT NULL,
-  config_name TEXT NOT NULL,
-  config_value TEXT NOT NULL,
-  created_at TEXT,
-  changed_at TEXT
-)
-```
-
-**New Schema:**
-```sql
-CREATE TABLE hazo_app_config (
-  id TEXT PRIMARY KEY,
-  scope_id TEXT,                           -- ← CHANGED: org_id → scope_id
-  user_id TEXT,
-  config_section TEXT NOT NULL,
-  config_name TEXT NOT NULL,
-  config_value_text TEXT,                  -- ← NEW: for general type
-  config_value_json TEXT,                  -- ← NEW: for json type (JSONB in PostgreSQL)
-  config_type TEXT NOT NULL,               -- ← NEW: 'general' or 'json'
-  created_at TEXT,
-  changed_at TEXT,
-  CHECK (
-    (config_type = 'general' AND config_value_text IS NOT NULL AND config_value_json IS NULL) OR
-    (config_type = 'json' AND config_value_json IS NOT NULL AND config_value_text IS NULL)
-  )
-)
-```
-
-### 2. Type Definitions
-
-**Removed:**
-- `ConfigLevel` type ('org' | 'user')
-
-**Added:**
-- `ConfigType` type ('json' | 'general')
-
-**Changed Interface:**
-```typescript
-// OLD
-interface AppConfigItem {
-  org_id: string | null
-  config_value: string
-}
-
-// NEW
-interface AppConfigItem {
-  scope_id: string | null        // ← org_id renamed
-  config_value_text: string      // ← new field
-  config_value_json: object      // ← new field
-  config_type: ConfigType        // ← new field
-}
-
-// OLD
-interface AppConfigContext {
-  org_id: string
-  user_id?: string
-}
-
-// NEW
-interface AppConfigContext {
-  scope_id: string              // ← org_id renamed
-  user_id?: string
-}
-```
-
-### 3. Component API Changes
-
-**AppConfig Component:**
-```typescript
-// OLD
-<AppConfig
-  level="org"              // ← REMOVED
-  context={{ org_id: '...' }}
-  fetch_config={fetch_config}
-  save_config={save_config}
-  delete_config={delete_config}
-/>
-
-// NEW
-<AppConfig
-  title="Scope Settings"    // ← Now required (no default from level)
-  context={{ scope_id: '...' }}
-  fetch_config={fetch_config}
-  save_config={save_config}
-  delete_config={delete_config}
-/>
-```
-
-**Hook Signature:**
-```typescript
-// OLD
-useAppConfig(
-  level: ConfigLevel,
-  context: AppConfigContext,
-  fetch_config: (level, context) => Promise<AppConfigItem[]>,
-  save_config: (item) => Promise<void>,
-  delete_config: (section, name, level, context) => Promise<void>
-)
-
-// NEW
-useAppConfig(
-  context: AppConfigContext,
-  fetch_config: (context) => Promise<AppConfigItem[]>,
-  save_config: (item) => Promise<void>,
-  delete_config: (section, name, context) => Promise<void>
-)
-```
-
-**Hook Return Value:**
-```typescript
-// OLD
-sections: Record<string, Record<string, string>>
-set_value: (section, key, value: string) => Promise<void>
-
-// NEW
-sections: Record<string, Record<string, AppConfigItem>>  // Full items
-set_value: (section, key, value: string | object, type: ConfigType) => Promise<void>
-change_type: (section, key, new_type: ConfigType) => Promise<void>  // NEW
-```
-
-### 4. Server Action Changes
-
-**Fetch Config:**
-```typescript
-// OLD
-async function fetch_config(
-  level: ConfigLevel,
-  context: AppConfigContext
-): Promise<AppConfigItem[]>
-
-// NEW
-async function fetch_config(
-  context: AppConfigContext
-): Promise<AppConfigItem[]>
-```
-
-**Save Config:**
-```typescript
-// OLD
-const item = {
-  org_id: context.org_id,
-  user_id: level === 'user' ? context.user_id : null,
-  config_value: value
-}
-
-// NEW
-const item = {
-  scope_id: context.scope_id,
-  user_id: context.user_id ?? null,
-  config_value_text: type === 'general' ? value : '',
-  config_value_json: type === 'json' ? value : {},
-  config_type: type
-}
-```
-
-**Delete Config:**
-```typescript
-// OLD
-async function delete_config(
-  section: string,
-  name: string,
-  level: ConfigLevel,
-  context: AppConfigContext
-)
-
-// NEW
-async function delete_config(
-  section: string,
-  name: string,
-  context: AppConfigContext
-)
-```
-
-## Migration Steps
-
-### 1. Database Migration
-
-**PostgreSQL:**
-```sql
--- Add new columns
-ALTER TABLE hazo_app_config
-  ADD COLUMN scope_id TEXT,
-  ADD COLUMN config_value_text TEXT,
-  ADD COLUMN config_value_json JSONB,
-  ADD COLUMN config_type TEXT;
-
--- Migrate existing data
-UPDATE hazo_app_config SET
-  scope_id = org_id,
-  config_value_text = config_value,
-  config_value_json = '{}'::jsonb,
-  config_type = 'general';
-
--- Drop old columns
-ALTER TABLE hazo_app_config
-  DROP COLUMN org_id,
-  DROP COLUMN config_value;
-
--- Add constraints
-ALTER TABLE hazo_app_config
-  ALTER COLUMN config_type SET NOT NULL,
-  ADD CONSTRAINT check_type_values CHECK (config_type IN ('json', 'general')),
-  ADD CONSTRAINT check_value_exclusivity CHECK (
-    (config_type = 'general' AND config_value_text IS NOT NULL AND config_value_json IS NULL) OR
-    (config_type = 'json' AND config_value_json IS NOT NULL AND config_value_text IS NULL)
-  );
-
--- Update indexes
-DROP INDEX IF EXISTS idx_hazo_app_config_org;
-DROP INDEX IF EXISTS idx_hazo_app_config_unique;
-
-CREATE INDEX idx_hazo_app_config_scope ON hazo_app_config(scope_id);
-CREATE UNIQUE INDEX idx_hazo_app_config_unique ON hazo_app_config(scope_id, user_id, config_section, config_name);
-```
-
-**SQLite:**
-```sql
--- SQLite doesn't support dropping columns, so recreate the table
-CREATE TABLE hazo_app_config_new (
-  id TEXT PRIMARY KEY,
-  scope_id TEXT,
-  user_id TEXT,
-  config_section TEXT NOT NULL,
-  config_name TEXT NOT NULL,
-  config_value_text TEXT,
-  config_value_json TEXT,
-  config_type TEXT NOT NULL CHECK (config_type IN ('json', 'general')),
-  created_at TEXT DEFAULT (datetime('now')),
-  changed_at TEXT,
-  CHECK (
-    (config_type = 'general' AND config_value_text IS NOT NULL AND config_value_json IS NULL) OR
-    (config_type = 'json' AND config_value_json IS NOT NULL AND config_value_text IS NULL)
-  )
-);
-
--- Migrate data
-INSERT INTO hazo_app_config_new (id, scope_id, user_id, config_section, config_name, config_value_text, config_value_json, config_type, created_at, changed_at)
-SELECT id, org_id, user_id, config_section, config_name, config_value, NULL, 'general', created_at, changed_at
-FROM hazo_app_config;
-
--- Replace old table
-DROP TABLE hazo_app_config;
-ALTER TABLE hazo_app_config_new RENAME TO hazo_app_config;
-
--- Recreate indexes
-CREATE INDEX idx_hazo_app_config_scope ON hazo_app_config(scope_id);
-CREATE INDEX idx_hazo_app_config_user ON hazo_app_config(user_id);
-CREATE UNIQUE INDEX idx_hazo_app_config_unique ON hazo_app_config(scope_id, user_id, config_section, config_name);
-```
-
-### 2. Code Migration
-
-**Update Component Usage:**
-```typescript
-// OLD
-import { AppConfig } from 'hazo_config/components'
-
-<AppConfig
-  level="org"
-  context={{ org_id: DEMO_ORG_ID }}
-  fetch_config={fetch_config}
-  save_config={save_config}
-  delete_config={delete_config}
-/>
-
-// NEW
-import { AppConfig } from 'hazo_config/components'
-
-<AppConfig
-  title="Scope Settings"
-  context={{ scope_id: DEMO_SCOPE_ID }}
-  fetch_config={fetch_config}
-  save_config={save_config}
-  delete_config={delete_config}
-/>
-```
-
-**Update Server Actions:**
-```typescript
-// OLD
-export async function fetch_config(
-  level: ConfigLevel,
-  context: AppConfigContext
-): Promise<AppConfigItem[]> {
-  const query = new QueryBuilder()
-    .from('hazo_app_config')
-    .where('org_id', 'eq', context.org_id)
-
-  if (level === 'org') {
-    query.where('user_id', 'is', null)
-  } else {
-    query.where('user_id', 'eq', context.user_id)
-  }
-
-  return await hazo.query(query)
-}
-
-// NEW
-export async function fetch_config(
-  context: AppConfigContext
-): Promise<AppConfigItem[]> {
-  const query = new QueryBuilder()
-    .from('hazo_app_config')
-    .where('scope_id', 'eq', context.scope_id)
-
-  if (context.user_id) {
-    query.where('user_id', 'eq', context.user_id)
-  } else {
-    query.where('user_id', 'is', null)
-  }
-
-  const result = await hazo.query(query)
-
-  // Parse JSON for SQLite (stored as TEXT)
-  return result.map(item => ({
-    ...item,
-    config_value_json: item.config_value_json
-      ? JSON.parse(item.config_value_json)
-      : {}
-  }))
-}
-
-export async function save_config(
-  item: Omit<AppConfigItem, 'id' | 'created_at' | 'changed_at'>
-): Promise<void> {
-  // Validate mutual exclusivity
-  if (item.config_type === 'general' && !item.config_value_text) {
-    throw new Error('General type requires config_value_text')
-  }
-  if (item.config_type === 'json' && !item.config_value_json) {
-    throw new Error('JSON type requires config_value_json')
-  }
-
-  // For SQLite: stringify JSON
-  const db_data = {
-    config_value_text: item.config_type === 'general' ? item.config_value_text : null,
-    config_value_json: item.config_type === 'json'
-      ? JSON.stringify(item.config_value_json)
-      : null,
-    config_type: item.config_type,
-  }
-
-  // ... rest of save logic
-}
-
-export async function delete_config(
-  section: string,
-  name: string,
-  context: AppConfigContext
-): Promise<void> {
-  const query = new QueryBuilder()
-    .from('hazo_app_config')
-    .where('scope_id', 'eq', context.scope_id)
-    .where('config_section', 'eq', section)
-    .where('config_name', 'eq', name)
-
-  if (context.user_id) {
-    query.where('user_id', 'eq', context.user_id)
-  } else {
-    query.where('user_id', 'is', null)
-  }
-
-  await hazo.query(query, 'DELETE')
-}
-```
-
-**Update Hook Usage:**
-```typescript
-// OLD
-const {
-  sections,
-  set_value,
-  delete_value
-} = useAppConfig('org', context, fetch_config, save_config, delete_config)
-
-// Access value
-const value = sections.general.company_name  // string
-
-// Set value
-await set_value('general', 'company_name', 'New Name')
-
-// NEW
-const {
-  sections,
-  set_value,
-  delete_value,
-  change_type
-} = useAppConfig(context, fetch_config, save_config, delete_config)
-
-// Access value
-const item = sections.general.company_name  // AppConfigItem
-const value = item.config_type === 'json'
-  ? item.config_value_json
-  : item.config_value_text
-
-// Set general value
-await set_value('general', 'company_name', 'New Name', 'general')
-
-// Set JSON value
-await set_value('features', 'flags', { beta: true }, 'json')
-
-// Change type
-await change_type('general', 'company_name', 'json')
-```
-
-### 3. Import Updates
-
-**Type Imports:**
-```typescript
-// OLD
-import type { ConfigLevel, AppConfigItem } from 'hazo_config'
-
-// NEW
-import type { ConfigType, AppConfigItem } from 'hazo_config'
-```
-
-## New Features in v2
-
-### 1. JSON Configuration Values
-
-You can now store structured configuration as JSON:
-
-```typescript
-await set_value('features', 'enabled_features', {
-  analytics: true,
-  notifications: false,
-  api_access: true
-}, 'json')
-
-await set_value('branding', 'theme_config', {
-  dark_mode: true,
-  accent_color: '#3B82F6',
-  font: 'Inter'
-}, 'json')
-```
-
-### 2. Type Conversion
-
-Convert between general and JSON types:
-
-```typescript
-// Convert text to JSON
-await change_type('general', 'settings', 'json')
-// Will try JSON.parse(), fallback to { value: text }
-
-// Convert JSON to text
-await change_type('features', 'flags', 'general')
-// Will JSON.stringify() the object
-```
-
-### 3. UI Enhancements
-
-- Type badge showing 'json' or 'general'
-- JSON editor with syntax validation
-- Type change button with confirmation
-- Type selector when adding new keys
-
-## Testing Migration
-
-Before migrating production:
-
-1. **Backup your database**
-2. **Test migration on a copy:**
-   ```bash
-   # PostgreSQL
-   pg_dump production_db > backup.sql
-   createdb test_db
-   psql test_db < backup.sql
-   # Run migration scripts on test_db
-   ```
-
-3. **Update and test your application:**
-   ```bash
-   npm install hazo_config@^2.0.0
-   npm run build
-   npm test
-   ```
-
-4. **Verify data integrity:**
-   - All `config_value` migrated to `config_value_text`
-   - All items have `config_type = 'general'`
-   - All items have `scope_id` matching old `org_id`
-   - Unique constraints still enforced
-
-## Rollback Plan
-
-If you need to rollback:
-
-```sql
--- PostgreSQL
-ALTER TABLE hazo_app_config
-  ADD COLUMN org_id TEXT,
-  ADD COLUMN config_value TEXT;
-
-UPDATE hazo_app_config SET
-  org_id = scope_id,
-  config_value = COALESCE(config_value_text, config_value_json::text);
-
-ALTER TABLE hazo_app_config
-  DROP COLUMN scope_id,
-  DROP COLUMN config_value_text,
-  DROP COLUMN config_value_json,
-  DROP COLUMN config_type;
-```
-
-## Support
-
-For migration assistance:
-- File an issue: https://github.com/pub12/hazo_config/issues
-- Email: support@example.com
-
-## Version History
-
-- **v2.0.0**: Schema migration (scope_id, JSON support)
-- **v1.4.2**: Last version before breaking changes