@bernierllc/nevar-audit-viewer-ui

React components for viewing Nevar rule execution logs, condition evaluation traces, and audit log level configuration.

Installation

npm install @bernierllc/nevar-audit-viewer-ui

Usage

import {
  ExecutionLogTable,
  ExecutionLogDetail,
  ConditionTraceView,
  LogLevelConfigurator,
} from '@bernierllc/nevar-audit-viewer-ui';

function AuditDashboard({ logs, config, onConfigChange }) {
  const [selectedEntry, setSelectedEntry] = useState(null);

  return (
    <div>
      <LogLevelConfigurator config={config} onChange={onConfigChange} />

      <ExecutionLogTable
        data={logs}
        onPageChange={(page) => fetchLogs(page)}
        onRowClick={(entry) => setSelectedEntry(entry)}
      />

      {selectedEntry && (
        <>
          <ExecutionLogDetail
            entry={selectedEntry}
            onClose={() => setSelectedEntry(null)}
          />
          <ConditionTraceView
            conditionTree={selectedEntry.conditionTree}
            traces={selectedEntry.traces}
          />
        </>
      )}
    </div>
  );
}

API

ExecutionLogTable

Paginated, sortable, filterable table of execution log entries.

| Prop | Type | Description | |------|------|-------------| | data | PaginatedResult<ExecutionLogEntry> | Paginated execution log data. | | onPageChange | (page: number) => void | Called when the user navigates to a different page. | | onFiltersChange | (filters: ExecutionLogFilters) => void | Called when filter criteria change. | | onSortChange | (sort: SortConfig) => void | Called when sort column or direction changes. | | onRowClick | (entry: ExecutionLogEntry) => void | Called when a row is clicked. | | pageSize | number | Number of rows per page. |

ExecutionLogDetail

Expanded view of a single execution log entry showing payload, conditions, action results, and errors.

| Prop | Type | Description | |------|------|-------------| | entry | ExecutionLogEntry | The execution log entry to display. | | onClose | () => void | Called when the detail view is dismissed. |

ConditionTraceView

Tree visualization of condition evaluation results, showing which conditions matched or failed.

| Prop | Type | Description | |------|------|-------------| | conditionTree | ConditionGroup | The root condition group to visualize. | | traces | EvaluationTrace[] | Evaluation trace data for each condition. |

Also exports the buildConditionTree utility function for building an enriched ConditionNode tree from a ConditionGroup and traces.

LogLevelConfigurator

Editor for audit logger configuration with per-trigger, per-rule, and per-action log level overrides.

| Prop | Type | Description | |------|------|-------------| | config | AuditLoggerConfig | Current audit logger configuration. | | onChange | (config: AuditLoggerConfig) => void | Called when the configuration changes. |

Exported Types

• ExecutionLogFilters -- Filter state with triggerKey, status, dateFrom, dateTo.
• SortConfig -- Sort state with column and direction.
• ConditionNode -- Enriched condition node with matched status and children.
• LogLevelOverride -- Override entry with type ('trigger' | 'rule' | 'action'), key, and level.

Integration Documentation

Logger Integration

As a UI package, @bernierllc/nevar-audit-viewer-ui does not directly integrate with @bernierllc/logger. Logging is handled by the service-layer packages that power the data these components display.

NeverHub Integration

As a UI package, @bernierllc/nevar-audit-viewer-ui does not directly integrate with @bernierllc/neverhub-adapter. NeverHub registration is handled at the service layer.

License

Copyright (c) 2025 Bernier LLC. All rights reserved.