hazo_ihelp 2.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,595 @@
+/**
+ * Type definitions for hazo_ihelp package.
+ *
+ * hazo_ihelp is a contextual popup help system that supports hierarchical
+ * topics, multi-tenant scoping, rich HTML content, and keyboard-driven search.
+ */
+import type React from 'react';
+/**
+ * A help topic stored in the ihelp_topics table.
+ *
+ * Topics can be nested (via parent_id), scoped to an organisation (via
+ * scope_id), and enriched with tags and context mappings that are joined in
+ * at query time.
+ */
+export interface IhelpTopic {
+    /** Primary key — UUID generated by the database. */
+    id: string;
+    /**
+     * Parent topic UUID for hierarchical nesting.
+     * NULL indicates this is a root-level topic.
+     */
+    parent_id: string | null;
+    /**
+     * Organisation / tenant UUID for multi-tenant scoping.
+     * NULL means the topic is globally visible to all tenants.
+     */
+    scope_id: string | null;
+    /**
+     * High-level grouping label for the topic.
+     * Examples: "Deductions", "Benefits", "Onboarding".
+     */
+    category: string;
+    /** Human-readable title displayed in search results and detail views. */
+    title: string;
+    /**
+     * Short plain-text summary shown on search result cards.
+     * NULL if no description has been authored.
+     */
+    description: string | null;
+    /**
+     * Rich HTML body authored in the Tiptap editor.
+     * NULL until content has been saved.
+     */
+    content: string | null;
+    /**
+     * Lucide icon name rendered alongside the topic title.
+     * NULL if no icon has been selected.
+     */
+    icon: string | null;
+    /** Ascending integer used to order sibling topics within a category. */
+    sort_order: number;
+    /**
+     * Whether this topic is visible to end-users.
+     * Unpublished topics are only accessible in the editor.
+     */
+    is_published: boolean;
+    /** ISO-8601 timestamp of when the topic row was created. */
+    created_at: string;
+    /**
+     * ISO-8601 timestamp of the most recent update.
+     * NULL if the topic has never been edited after creation.
+     */
+    changed_at: string | null;
+    /**
+     * Tags joined from the ihelp_tags table.
+     * Empty array when no tags are associated.
+     */
+    tags: IhelpTag[];
+    /**
+     * Flat list of context keys denormalized from ihelp_context_map.
+     * Empty array when the topic has no context mappings.
+     * Example values: ["deductions.work_from_home", "benefits.dental"]
+     */
+    context_keys: string[];
+    /**
+     * Child topics populated when building a tree for rendering.
+     * Absent (undefined) in flat list responses.
+     */
+    children?: IhelpTopic[];
+}
+/**
+ * A decorative or informational badge attached to a topic.
+ * Stored in the ihelp_tags table with a foreign key to ihelp_topics.
+ */
+export interface IhelpTag {
+    /** Primary key — UUID generated by the database. */
+    id: string;
+    /** UUID of the parent topic this tag belongs to. */
+    topic_id: string;
+    /**
+     * Display text rendered inside the badge.
+     * Examples: "Receipt Required", "Tip", "New".
+     */
+    label: string;
+    /**
+     * Visual style variant applied to the badge.
+     * Maps to a colour scheme: default (grey), success (green),
+     * warning (amber), info (blue).
+     */
+    variant: 'default' | 'success' | 'warning' | 'info';
+    /**
+     * Optional Lucide icon name rendered inside the badge.
+     * NULL if no icon is desired.
+     */
+    icon: string | null;
+}
+/**
+ * A mapping between a topic and a dot-notation context key.
+ * Stored in the ihelp_context_map table.
+ *
+ * Context mappings allow the IhelpIcon component to surface the most
+ * relevant topics for a given location in the host application.
+ */
+export interface IhelpContextMapping {
+    /** Primary key — UUID generated by the database. */
+    id: string;
+    /** UUID of the topic being mapped. */
+    topic_id: string;
+    /**
+     * Dot-notation key identifying a location in the host application.
+     * Example: "deductions.work_from_home", "payroll.leave_accrual".
+     */
+    context_key: string;
+    /**
+     * Ascending integer used to rank topics when multiple are mapped
+     * to the same context key. Lower values appear first.
+     */
+    priority: number;
+}
+/** Row in the hazo_config key-value table. */
+export interface HazoConfigRow {
+    id: string;
+    config_key: string;
+    /** JSON string — parse before use. */
+    config_value: string;
+    scope_id: string | null;
+    created_at: string;
+    changed_at: string | null;
+}
+/** A single context-key option stored in the "context_keys" config entry. */
+export interface ContextKeyOption {
+    key: string;
+    label: string;
+}
+/**
+ * Payload accepted by the POST /ihelp/topics and PATCH /ihelp/topics/:id
+ * endpoints when creating or updating a topic.
+ *
+ * All fields except title are optional so the same type covers both full
+ * creates and partial updates (use Partial<IhelpTopicInput> for updates).
+ */
+export interface IhelpTopicInput {
+    /**
+     * UUID of the desired parent topic.
+     * Omit or pass null to create / move a topic to the root level.
+     */
+    parent_id?: string | null;
+    /**
+     * Organisation UUID for scoping.
+     * Omit or pass null to make the topic globally visible.
+     */
+    scope_id?: string | null;
+    /**
+     * High-level grouping label.
+     * Examples: "Deductions", "Benefits".
+     */
+    category?: string;
+    /** Human-readable title — required when creating a new topic. */
+    title: string;
+    /**
+     * Short plain-text summary for search cards.
+     * Omit or pass null to clear an existing description.
+     */
+    description?: string | null;
+    /**
+     * Rich HTML body from the Tiptap editor.
+     * Omit or pass null to clear existing content.
+     */
+    content?: string | null;
+    /**
+     * Lucide icon name.
+     * Omit or pass null to remove the icon.
+     */
+    icon?: string | null;
+    /**
+     * Ascending integer controlling display order among siblings.
+     * Defaults to 0 when omitted.
+     */
+    sort_order?: number;
+    /**
+     * Whether to make this topic visible to end-users immediately.
+     * Defaults to false when omitted.
+     */
+    is_published?: boolean;
+    /**
+     * Tags to attach to the topic.
+     * When provided on an update, existing tags are replaced in full.
+     */
+    tags?: IhelpTagInput[];
+    /**
+     * Dot-notation context keys to map to this topic.
+     * When provided on an update, existing mappings are replaced in full.
+     */
+    context_keys?: string[];
+}
+/**
+ * Payload for creating or replacing a tag on a topic.
+ * The topic_id is supplied by the API route, not this input type.
+ */
+export interface IhelpTagInput {
+    /**
+     * Display text rendered inside the badge.
+     * Examples: "Receipt Required", "Tip".
+     */
+    label: string;
+    /**
+     * Visual style variant for the badge.
+     * Defaults to 'default' when omitted.
+     */
+    variant?: 'default' | 'success' | 'warning' | 'info';
+    /**
+     * Optional Lucide icon name rendered inside the badge.
+     * Omit or pass null for a text-only badge.
+     */
+    icon?: string | null;
+}
+/**
+ * Envelope returned by all ihelp API endpoints.
+ *
+ * On success, data contains the requested or mutated resource.
+ * On failure, error contains a human-readable message and data is absent.
+ *
+ * @template T - Shape of the data payload; defaults to unknown.
+ */
+export interface IhelpApiResponse<T = unknown> {
+    /** true when the operation completed without error. */
+    success: boolean;
+    /**
+     * The returned resource or collection.
+     * Absent when success is false.
+     */
+    data?: T;
+    /**
+     * Human-readable error message.
+     * Absent when success is true.
+     */
+    error?: string;
+}
+/**
+ * Configuration for the image upload feature.
+ * Read from config/hazo_ihelp_config.ini [image_upload] section.
+ */
+export interface IhelpImageUploadConfig {
+    max_file_size_mb: number;
+    allowed_types: string[];
+    upload_dir: string;
+    upload_url_prefix: string;
+    resize_enabled: boolean;
+    resize_max_width: number;
+    resize_max_height: number;
+    resize_quality: number;
+}
+/**
+ * Response payload from the image upload endpoint.
+ */
+export interface IhelpImageUploadResponse {
+    url: string;
+    filename: string;
+    size: number;
+    width?: number;
+    height?: number;
+}
+/**
+ * Options passed to createIhelpHandler when registering the API route in a
+ * Next.js (or other framework) application.
+ *
+ * Mirrors the handler factory pattern used by hazo_notes
+ * (createNotesHandler) so that consuming apps configure the package in a
+ * consistent way.
+ */
+export interface CreateIhelpHandlerOptions {
+    /**
+     * Factory function (sync or async) that returns a configured database
+     * connection from hazo_connect.
+     *
+     * Called once per request so connection-pooling concerns are owned by
+     * the consuming application.
+     */
+    getHazoConnect: () => Promise<any> | any;
+    /**
+     * Optional factory function that returns a logger instance.
+     * When omitted, the handler falls back to console.
+     */
+    getLogger?: () => any;
+}
+/**
+ * Customisable colour tokens for the ihelp dialog.
+ *
+ * Each value should be a valid CSS colour string (hex, rgb, hsl, oklch, etc.).
+ * Any omitted key falls back to the host application's CSS custom properties
+ * (--background, --foreground, etc.) or sensible defaults.
+ */
+export interface IhelpTheme {
+    /** Dialog / panel background colour. */
+    background?: string;
+    /** Primary text colour. */
+    foreground?: string;
+    /** Muted / secondary text colour. */
+    muted_foreground?: string;
+    /** Border colour. */
+    border?: string;
+    /** Accent / hover background colour. */
+    accent?: string;
+    /** Selected item highlight colour. */
+    accent_foreground?: string;
+    /** Primary accent colour (links, active indicators). */
+    primary?: string;
+    /** Primary accent text on primary bg. */
+    primary_foreground?: string;
+}
+/**
+ * Customisable UI labels / strings for the ihelp dialog.
+ *
+ * Useful for localisation or branding.
+ */
+export interface IhelpLabels {
+    /** Placeholder text for the search input. Default: "Search help topics..." */
+    search_placeholder?: string;
+    /** Title shown in the dialog header / accessibility label. Default: "Help" */
+    dialog_title?: string;
+    /** Prefix shown above the detail title. Default: "More Info:" */
+    more_info_prefix?: string;
+    /** Heading for the related-topics section. Default: "Related topics" */
+    related_topics?: string;
+    /** Text shown when loading topics. Default: "Loading..." */
+    loading?: string;
+    /** Text when search yields nothing. Default: "No results found" */
+    no_results?: string;
+    /** Text when no topics exist. Default: "No topics available" */
+    no_topics?: string;
+    /** Prompt when no topic is selected. Default: "Select a topic to view details" */
+    select_prompt?: string;
+    /** Browse-all tooltip text. Default: "Browse all topics" */
+    browse_all?: string;
+    /** Context banner prefix. Default: "Showing help for:" */
+    showing_help_for?: string;
+}
+/**
+ * Props for the IhelpProvider context component.
+ *
+ * Wrap your application (or a subtree) with IhelpProvider to give all
+ * child components access to topics, search state, and keyboard shortcuts.
+ */
+export interface IhelpProviderProps {
+    /** React subtree that will have access to the ihelp context. */
+    children: React.ReactNode;
+    /**
+     * Base URL prefix for all ihelp API requests.
+     * Defaults to '/api/ihelp' when omitted.
+     */
+    api_base_url?: string;
+    /**
+     * Organisation UUID passed as a query parameter on every API request.
+     * NULL or omitted for globally-scoped topics only.
+     */
+    scope_id?: string | null;
+    /**
+     * Keyboard shortcut string (KeyboardEvent key or modifier combo) used
+     * to open the search dialog.
+     * Defaults to 'mod+k' when omitted.
+     */
+    search_shortcut?: string;
+    /**
+     * Whether to register the keyboard shortcut listener.
+     * Defaults to true when omitted.
+     */
+    enable_shortcuts?: boolean;
+    /**
+     * Base URL for topic images/assets. Images in content reference paths
+     * relative to this base. When scope_id is set, the full path becomes
+     * `{asset_base_url}/{scope_id}/filename.png`. For global (no scope),
+     * it is `{asset_base_url}/global/filename.png`.
+     *
+     * Example: '/api/ihelp/assets' or 'https://cdn.example.com/help-images'
+     */
+    asset_base_url?: string;
+    /**
+     * Colour overrides for the ihelp dialog.
+     * See IhelpTheme for available tokens.
+     */
+    theme?: IhelpTheme;
+    /**
+     * UI label / string overrides for localisation or branding.
+     * See IhelpLabels for available keys.
+     */
+    labels?: IhelpLabels;
+}
+/**
+ * Props for the IhelpIcon trigger component.
+ *
+ * Renders a small icon button that opens the search dialog pre-filtered
+ * to topics matching the given context key.
+ */
+export interface IhelpIconProps {
+    /**
+     * Dot-notation key identifying the current location in the host
+     * application (e.g. "deductions.work_from_home").
+     * Used to look up relevant topics from ihelp_context_map.
+     */
+    context_key: string;
+    /**
+     * Icon render size in pixels.
+     * Defaults to 16 when omitted.
+     */
+    size?: number;
+    /** Optional additional CSS class names applied to the icon button. */
+    className?: string;
+}
+/**
+ * Props for the IhelpSearchDialog component.
+ *
+ * The dialog supports three opening modes: context home (scoped to a
+ * context_key), free-text search, and browse-all.
+ */
+export interface IhelpSearchDialogProps {
+    /**
+     * Controlled open state.
+     * When omitted the dialog manages its own open state.
+     */
+    open?: boolean;
+    /**
+     * Callback fired when the dialog requests an open-state change.
+     * Required when open is controlled from outside.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Pre-seeds the dialog in CONTEXT HOME state for the given key.
+     * When omitted the dialog opens in browse or search state.
+     */
+    initial_context_key?: string;
+    /** Optional additional CSS class names applied to the dialog content. */
+    className?: string;
+}
+/**
+ * Props for the IhelpDetailPanel component.
+ *
+ * Renders the full content of a single topic including its rich HTML body,
+ * tags, and child topic links.
+ */
+export interface IhelpDetailPanelProps {
+    /** The topic whose details are being rendered. */
+    topic: IhelpTopic;
+    /**
+     * Callback fired when the user activates a link to a child or related
+     * topic inside the panel. The consuming component should navigate to the
+     * given topic_id.
+     */
+    onNavigate?: (topic_id: string) => void;
+    /** Optional additional CSS class names applied to the panel container. */
+    className?: string;
+}
+/**
+ * Props for the IhelpEditor component.
+ *
+ * Full CRUD interface for managing topics, rendered as an admin panel.
+ */
+export interface IhelpEditorProps {
+    /**
+     * Organisation UUID used to filter and scope new topics in the editor.
+     * NULL or omitted to operate on globally-scoped topics.
+     */
+    scope_id?: string | null;
+    /** Optional additional CSS class names applied to the editor container. */
+    className?: string;
+    /** URL of the image upload endpoint, e.g. "/api/ihelp/upload". Enables image toolbar button when set. */
+    upload_url?: string;
+    /** URL of the config API endpoint, e.g. "/api/ihelp/config". Enables context key dropdown when set. */
+    config_api_url?: string;
+}
+/**
+ * Discriminated union representing the current view inside the search dialog.
+ *
+ * - context_home: Showing topics mapped to a specific context key.
+ * - search: Showing free-text search results for a query string.
+ * - browse: Showing all published topics grouped by category.
+ * - detail: Showing the full content of a single topic.
+ */
+export type IhelpNavState = {
+    /** Display topics relevant to the given application context. */
+    view: 'context_home';
+    /** Dot-notation context key passed from the triggering IhelpIcon. */
+    context_key: string;
+} | {
+    /** Display free-text search results. */
+    view: 'search';
+    /** Current search query string (may be empty). */
+    query: string;
+} | {
+    /** Display all published topics grouped by category. */
+    view: 'browse';
+} | {
+    /** Display the full detail panel for a single topic. */
+    view: 'detail';
+    /** UUID of the topic being displayed. */
+    topic_id: string;
+};
+/**
+ * Return value of the useIhelp hook.
+ *
+ * Provides a flat list of topics fetched from the API along with loading
+ * and error state.
+ */
+export interface UseIhelpResult {
+    /** All topics returned by the most recent fetch. Empty array while loading. */
+    topics: IhelpTopic[];
+    /** True while the initial or refetch request is in-flight. */
+    loading: boolean;
+    /**
+     * Error message if the last fetch failed.
+     * NULL when no error has occurred.
+     */
+    error: string | null;
+    /** Trigger a fresh fetch of topics from the API. */
+    refetch: () => void;
+}
+/**
+ * Return value of the useIhelpSearch hook.
+ *
+ * Manages search query state and returns filtered results derived from a
+ * cached list of all topics.
+ */
+export interface UseIhelpSearchResult {
+    /** Current search query string. */
+    query: string;
+    /**
+     * Update the search query.
+     * Passing an empty string resets the filter.
+     */
+    set_query: (q: string) => void;
+    /**
+     * Topics matching the current query.
+     * Contains all topics when query is empty.
+     */
+    results: IhelpTopic[];
+    /** Unfiltered list of all topics available for search. */
+    all_topics: IhelpTopic[];
+    /** True while the underlying topic list is being fetched. */
+    loading: boolean;
+    /**
+     * Error message if the topic fetch failed.
+     * NULL when no error has occurred.
+     */
+    error: string | null;
+}
+/**
+ * Return value of the useIhelpEditor hook.
+ *
+ * Provides full CRUD operations for topics in addition to the standard
+ * fetch state from UseIhelpResult.
+ */
+export interface UseIhelpEditorResult {
+    /** All topics returned by the most recent fetch. Empty array while loading. */
+    topics: IhelpTopic[];
+    /** True while the initial or refetch request is in-flight. */
+    loading: boolean;
+    /**
+     * Error message if the last operation failed.
+     * NULL when no error has occurred.
+     */
+    error: string | null;
+    /**
+     * Create a new topic from the given input and return the persisted record.
+     *
+     * @param input - Topic fields to create.
+     * @returns The newly created IhelpTopic with server-assigned id and timestamps.
+     */
+    create_topic: (input: IhelpTopicInput) => Promise<IhelpTopic>;
+    /**
+     * Update an existing topic by id and return the updated record.
+     *
+     * @param id - UUID of the topic to update.
+     * @param input - Partial set of fields to overwrite.
+     * @returns The updated IhelpTopic with refreshed changed_at timestamp.
+     */
+    update_topic: (id: string, input: Partial<IhelpTopicInput>) => Promise<IhelpTopic>;
+    /**
+     * Permanently delete a topic and its associated tags and context mappings.
+     *
+     * @param id - UUID of the topic to delete.
+     */
+    delete_topic: (id: string) => Promise<void>;
+    /** Trigger a fresh fetch of topics from the API. */
+    refetch: () => void;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for hazo_ihelp package.
+ *
+ * hazo_ihelp is a contextual popup help system that supports hierarchical
+ * topics, multi-tenant scoping, rich HTML content, and keyboard-driven search.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/cn.d.ts

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1 @@
+{"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"}