hazo_ihelp 2.0.9 → 2.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Logger Utility for hazo_ihelp
+ *
+ * Default behavior: delegates to hazo_core's createLogger('hazo_ihelp'), which
+ * auto-injects correlationId, env, and writes structured JSON via hazo_logs.
+ * Consumers can still override with set_logger() — useful for browser-only
+ * loggers or app-specific instrumentation.
+ */
+export interface Logger {
+    info: (message: string, data?: Record<string, unknown>) => void;
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+}
+/**
+ * Set the logger instance to use throughout hazo_ihelp.
+ * Pass `undefined` to reset to the hazo_core default.
+ */
+export declare function set_logger(logger: Logger | undefined): void;
+/**
+ * Get the current logger instance — defaults to hazo_core's createLogger
+ * on first access if no consumer override has been set.
+ */
+export declare function get_logger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE;AAmBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAKnC"}

package/dist/utils/logger.js

@@ -0,0 +1,42 @@
+/**
+ * Logger Utility for hazo_ihelp
+ *
+ * Default behavior: delegates to hazo_core's createLogger('hazo_ihelp'), which
+ * auto-injects correlationId, env, and writes structured JSON via hazo_logs.
+ * Consumers can still override with set_logger() — useful for browser-only
+ * loggers or app-specific instrumentation.
+ */
+import { createLogger } from 'hazo_core';
+const console_logger = {
+    info: (m, d) => (d ? console.log(`[hazo_ihelp] ${m}`, d) : console.log(`[hazo_ihelp] ${m}`)),
+    debug: (m, d) => (d ? console.debug(`[hazo_ihelp] ${m}`, d) : console.debug(`[hazo_ihelp] ${m}`)),
+    warn: (m, d) => (d ? console.warn(`[hazo_ihelp] ${m}`, d) : console.warn(`[hazo_ihelp] ${m}`)),
+    error: (m, d) => (d ? console.error(`[hazo_ihelp] ${m}`, d) : console.error(`[hazo_ihelp] ${m}`)),
+};
+function build_default_logger() {
+    try {
+        return createLogger('hazo_ihelp');
+    }
+    catch {
+        return console_logger;
+    }
+}
+let current_logger = null;
+/**
+ * Set the logger instance to use throughout hazo_ihelp.
+ * Pass `undefined` to reset to the hazo_core default.
+ */
+export function set_logger(logger) {
+    current_logger = logger ?? null;
+}
+/**
+ * Get the current logger instance — defaults to hazo_core's createLogger
+ * on first access if no consumer override has been set.
+ */
+export function get_logger() {
+    if (!current_logger) {
+        current_logger = build_default_logger();
+    }
+    return current_logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,cAAc,GAAW;IAC7B,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACjG,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC9F,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;CAClG,CAAC;AAEF,SAAS,oBAAoB;IAC3B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,CAAsB,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC;AAED,IAAI,cAAc,GAAkB,IAAI,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAA0B;IACnD,cAAc,GAAG,MAAM,IAAI,IAAI,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,oBAAoB,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_ihelp",
-  "version": "2.0.9",
+  "version": "2.1.0",
   "type": "module",
   "main": "./dist/index.client.js",
   "module": "./dist/index.client.js",
@@ -29,9 +29,11 @@
   },
   "files": [
     "dist",
-    "migrations",
-    "config",
-    "README.md"
+    "config/hazo_ihelp_config.ini.sample",
+    "db_setup_postgres.sql",
+    "db_setup_sqlite.sql",
+    "README.md",
+    "SETUP_CHECKLIST.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -69,31 +71,61 @@
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "fuse.js": "^7.0.0",
-    "hazo_auth": "^5.1.30",
-    "hazo_chat": "^5.2.2",
-    "hazo_config": "^2.1.0",
-    "hazo_files": "^1.4.4",
-    "hazo_llm_api": "^1.2.10",
-    "hazo_logs": "^1.0.10",
-    "hazo_notes": "^1.1.5",
-    "lucide-react": "^0.344.0",
+    "lucide-react": "^0.553.0",
     "react-day-picker": "^9.14.0",
     "react-icons": "^5.6.0",
     "react-resizable-panels": "^4.7.6",
     "sonner": "^2.0.7",
-    "tailwind-merge": "^2.5.4"
+    "tailwind-merge": "^3.5.0",
+    "zod": "^3.23.8"
   },
   "peerDependencies": {
-    "hazo_connect": "^2.3.1",
-    "next": ">=14.0.0",
-    "react": "^18||^19",
-    "react-dom": "^18||^19",
-    "tailwindcss": ">=3.0.0"
+    "hazo_auth": "^9.0.0",
+    "hazo_chat": "^6.0.0",
+    "hazo_config": "^2.1.5",
+    "hazo_connect": "^3.0.0",
+    "hazo_core": "^1.0.0",
+    "hazo_files": "^3.0.0",
+    "hazo_llm_api": "^2.0.0",
+    "hazo_logs": "^2.0.0",
+    "hazo_notes": "^2.0.0",
+    "hazo_ui": "^3.1.0",
+    "next": "^14.0.0 || ^16.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "tailwindcss": "^4.2.4"
   },
   "peerDependenciesMeta": {
+    "hazo_auth": {
+      "optional": true
+    },
+    "hazo_chat": {
+      "optional": true
+    },
+    "hazo_config": {
+      "optional": true
+    },
     "hazo_connect": {
       "optional": true
     },
+    "hazo_core": {
+      "optional": false
+    },
+    "hazo_files": {
+      "optional": true
+    },
+    "hazo_llm_api": {
+      "optional": true
+    },
+    "hazo_logs": {
+      "optional": true
+    },
+    "hazo_notes": {
+      "optional": true
+    },
+    "hazo_ui": {
+      "optional": false
+    },
     "next": {
       "optional": true
     },
@@ -102,10 +134,21 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^20.10.0",
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
-    "typescript": "^5.3.0"
+    "@types/node": "^20.14.10",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "hazo_auth": "^9.0.0",
+    "hazo_chat": "^6.0.0",
+    "hazo_config": "^2.1.6",
+    "hazo_connect": "^3.0.0",
+    "hazo_core": "^1.0.0",
+    "hazo_files": "^3.0.0",
+    "hazo_llm_api": "^2.0.0",
+    "hazo_logs": "^2.0.1",
+    "hazo_notes": "^2.0.0",
+    "hazo_ui": "^3.1.0",
+    "next": "^16.0.10",
+    "typescript": "^5.7.2"
   },
   "author": "Pubs Abayasiri",
   "license": "MIT",

package/config/hazo_ihelp_config.ini

@@ -1,9 +0,0 @@
-[image_upload]
-max_file_size_mb = 5
-allowed_types = image/jpeg, image/png, image/gif, image/webp, image/svg+xml, image/avif
-upload_dir = test-app/public/ihelp/images
-upload_url_prefix = /ihelp/images
-resize_enabled = true
-resize_max_width = 1200
-resize_max_height = 1200
-resize_quality = 80

package/dist/utils/cn.d.ts

@@ -1,3 +0,0 @@
-import { type ClassValue } from 'clsx';
-export declare function cn(...inputs: ClassValue[]): string;
-//# sourceMappingURL=cn.d.ts.map

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

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

package/dist/utils/cn.js

@@ -1,6 +0,0 @@
-import { clsx } from 'clsx';
-import { twMerge } from 'tailwind-merge';
-export function cn(...inputs) {
-    return twMerge(clsx(inputs));
-}
-//# sourceMappingURL=cn.js.map

package/dist/utils/cn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/migrations/001_create_ihelp_tables.sql

@@ -1,109 +0,0 @@
--- hazo_ihelp database schema
--- Simplified 2-table design: topics with embedded tags/contexts as JSON
---
--- ═══════════════════════════════════════════════════════════════════════════════
--- SQLite Version
--- ═══════════════════════════════════════════════════════════════════════════════
--- SQLite stores UUIDs as TEXT and JSON as TEXT. No native UUID or JSONB type.
---
--- CREATE TABLE IF NOT EXISTS hazo_ihelp_topics (
---   id TEXT PRIMARY KEY,                          -- UUID as text
---   parent_id TEXT,                               -- UUID ref → hazo_ihelp_topics(id)
---   scope_id TEXT,                                -- UUID, NULL = global
---   category TEXT NOT NULL DEFAULT 'General',
---   title TEXT NOT NULL,
---   description TEXT,
---   content TEXT,                                 -- Rich HTML from Tiptap editor
---   icon TEXT,                                    -- Lucide icon name
---   sort_order INTEGER NOT NULL DEFAULT 0,
---   is_published INTEGER NOT NULL DEFAULT 1,      -- SQLite boolean (0/1)
---   tags TEXT NOT NULL DEFAULT '[]',              -- JSON array: [{label, variant, icon}]
---   contexts TEXT NOT NULL DEFAULT '[]',          -- JSON array: [{key, priority}]
---   created_at TEXT NOT NULL DEFAULT (datetime('now')),
---   changed_at TEXT,
---   FOREIGN KEY (parent_id) REFERENCES hazo_ihelp_topics(id) ON DELETE SET NULL
--- );
---
--- CREATE INDEX IF NOT EXISTS idx_hazo_ihelp_topics_scope ON hazo_ihelp_topics(scope_id);
--- CREATE INDEX IF NOT EXISTS idx_hazo_ihelp_topics_parent ON hazo_ihelp_topics(parent_id);
---
--- CREATE TABLE IF NOT EXISTS hazo_config (
---   id TEXT PRIMARY KEY,                          -- UUID as text
---   config_key TEXT NOT NULL,
---   config_value TEXT NOT NULL,                   -- JSON string
---   scope_id TEXT,                                -- UUID, NULL = global
---   created_at TEXT NOT NULL DEFAULT (datetime('now')),
---   changed_at TEXT,
---   UNIQUE(config_key, scope_id)
--- );
---
--- CREATE INDEX IF NOT EXISTS idx_hazo_config_key ON hazo_config(config_key);
---
--- ═══════════════════════════════════════════════════════════════════════════════
--- PostgreSQL Version
--- ═══════════════════════════════════════════════════════════════════════════════
--- PostgreSQL uses native UUID, JSONB, BOOLEAN, and TIMESTAMPTZ types.
--- Requires: CREATE EXTENSION IF NOT EXISTS "pgcrypto"; (for gen_random_uuid)
-
-CREATE TABLE IF NOT EXISTS hazo_ihelp_topics (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  parent_id UUID REFERENCES hazo_ihelp_topics(id) ON DELETE SET NULL,
-  scope_id UUID,                                -- NULL = global, UUID = org-specific
-  category TEXT NOT NULL DEFAULT 'General',
-  title TEXT NOT NULL,
-  description TEXT,                             -- Short summary for search cards
-  content TEXT,                                 -- Rich HTML content from Tiptap editor
-  icon TEXT,                                    -- Lucide icon name
-  sort_order INTEGER NOT NULL DEFAULT 0,
-  is_published BOOLEAN NOT NULL DEFAULT TRUE,
-  tags JSONB NOT NULL DEFAULT '[]',             -- [{label, variant, icon}]
-  contexts JSONB NOT NULL DEFAULT '[]',         -- [{key, priority}]
-  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-  changed_at TIMESTAMPTZ
-);
-
-CREATE INDEX IF NOT EXISTS idx_hazo_ihelp_topics_scope ON hazo_ihelp_topics(scope_id);
-CREATE INDEX IF NOT EXISTS idx_hazo_ihelp_topics_parent ON hazo_ihelp_topics(parent_id);
-CREATE INDEX IF NOT EXISTS idx_hazo_ihelp_topics_tags ON hazo_ihelp_topics USING GIN (tags);
-CREATE INDEX IF NOT EXISTS idx_hazo_ihelp_topics_contexts ON hazo_ihelp_topics USING GIN (contexts);
-
-CREATE TABLE IF NOT EXISTS hazo_config (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  config_key TEXT NOT NULL,
-  config_value TEXT NOT NULL,                   -- JSON string
-  scope_id UUID,                                -- NULL = global, UUID = org-specific
-  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-  changed_at TIMESTAMPTZ,
-  UNIQUE(config_key, scope_id)
-);
-
-CREATE INDEX IF NOT EXISTS idx_hazo_config_key ON hazo_config(config_key);
-
--- ═══════════════════════════════════════════════════════════════════════════════
--- JSON Column Shapes
--- ═══════════════════════════════════════════════════════════════════════════════
---
--- tags: [
---   { "label": "Receipt Required", "variant": "warning", "icon": "AlertTriangle" },
---   { "label": "Pre-filled", "variant": "success", "icon": "Check" }
--- ]
---
--- contexts: [
---   { "key": "deductions.work_from_home", "priority": 0 },
---   { "key": "onboarding.step3", "priority": 1 }
--- ]
---
--- ═══════════════════════════════════════════════════════════════════════════════
--- PostgreSQL Context Key Query Examples
--- ═══════════════════════════════════════════════════════════════════════════════
---
--- Find topics mapped to a context key:
---   SELECT * FROM hazo_ihelp_topics
---   WHERE contexts @> '[{"key": "deductions.work_from_home"}]'
---   ORDER BY (SELECT MIN((ctx->>'priority')::int)
---             FROM jsonb_array_elements(contexts) ctx
---             WHERE ctx->>'key' = 'deductions.work_from_home');
---
--- Find topics with a specific tag label:
---   SELECT * FROM hazo_ihelp_topics
---   WHERE tags @> '[{"label": "Pre-filled"}]';