reactbridge-sdk 0.2.7 → 0.2.8

package/README.md

@@ -10,7 +10,8 @@ A flexible React SDK for building intelligent conversational interfaces with LLM
 🤖 **Intelligent Context** - Automatic context diffing and injection  
 ⚡ **Two-Step Orchestration** - Seamless action execution and feedback loop  
 📦 **TypeScript First** - Full type safety and IntelliSense support  
-📈 **Analytics Admin UI** - Widgets, reports, and dashboards for AI-generated insights
+📈 **Analytics Admin UI** - Widgets, reports, and dashboards for AI-generated insights  
+📊 **Business Intelligence Reports** - 5 comprehensive REST endpoints for analytics (Executive Dashboard, Supply Chain Risk, Execution Audit Trail, Portfolio Health, Data Quality & Automation)
 
 ## Installation
 
@@ -265,6 +266,89 @@ await api.updateDirectiveStatus(directiveId, 'executed');
 - Detailed components and hooks: [ANALYTICS_README.md](ANALYTICS_README.md)
 - Full dashboard guide: [ANALYTICS_DASHBOARD_README.md](ANALYTICS_DASHBOARD_README.md)
 
+## Business Intelligence Reports
+
+The SDK includes 5 comprehensive REST endpoints for investor-ready analytics with date range filtering and 1-hour caching.
+
+### Available Reports
+
+```tsx
+import {
+  ReactBridgeProvider,
+  ExecutiveDashboard,
+  SupplyChainRisk,
+  ExecutionAuditTrail,
+  PortfolioHealth,
+  DataQualityAutomation
+} from 'reactbridge-sdk';
+
+function ReportsPage() {
+  return (
+    <ReactBridgeProvider apiKey="your-api-key">
+      {/* High-level metrics and trends */}
+      <ExecutiveDashboard />
+
+      {/* Supply chain risk analysis */}
+      <SupplyChainRisk />
+
+      {/* Execution history and audit */}
+      <ExecutionAuditTrail />
+
+      {/* Portfolio metric health */}
+      <PortfolioHealth />
+
+      {/* Data quality & automation opportunities */}
+      <DataQualityAutomation />
+    </ReactBridgeProvider>
+  );
+}
+```
+
+### Reports via Hooks
+
+```tsx
+import { useReactBridgeContext } from 'reactbridge-sdk';
+
+function CustomReport() {
+  const { api } = useReactBridgeContext();
+
+  // Fetch Executive Dashboard
+  const dashboard = await api.getExecutiveDashboard({
+    startDate: '2026-01-06',
+    endDate: '2026-02-05'
+  });
+
+  // Fetch Supply Chain Risk
+  const risk = await api.getSupplyChainRisk();
+
+  // Fetch Execution Audit with filter
+  const audit = await api.getExecutionAuditTrail({
+    directiveType: 'inventory-rebalance'
+  });
+
+  // Fetch Portfolio Health
+  const health = await api.getPortfolioHealth();
+
+  // Fetch Data Quality Assessment
+  const quality = await api.getDataQualityAutomation();
+}
+```
+
+### Reports Documentation
+
+- Full API reference: [REPORTS_API.md](REPORTS_API.md)
+- Provider pattern guide: [REPORTS_PROVIDER_PATTERN.md](REPORTS_PROVIDER_PATTERN.md)
+
+### Authentication
+
+All reports use **X-API-Key** header authentication. Simply pass your API key to `ReactBridgeProvider` and it's automatically used by all endpoints:
+
+```tsx
+<ReactBridgeProvider apiKey="your-api-key-here">
+  <YourReportsApp />
+</ReactBridgeProvider>
+```
+
 ## Voice Input/Output
 
 The SDK supports voice input (Speech-to-Text) and voice output (Text-to-Speech) for a fully conversational experience.

package/dist/components/reports/DataQualityAutomation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataQualityAutomation.d.ts","sourceRoot":"","sources":["../../../src/components/reports/DataQualityAutomation.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAoUtE,CAAC"}
+{"version":3,"file":"DataQualityAutomation.d.ts","sourceRoot":"","sources":["../../../src/components/reports/DataQualityAutomation.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAqUtE,CAAC"}

package/dist/components/reports/DateRangeSelector.d.ts

@@ -1,6 +1,6 @@
 /**
  * DateRangeSelector Component
- * Button group for selecting predefined date ranges
+ * Select dropdown for date range selection
  */
 import React from "react";
 import { DateRangeOption } from "../../utils/date-range";

package/dist/components/reports/DateRangeSelector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateRangeSelector.d.ts","sourceRoot":"","sources":["../../../src/components/reports/DateRangeSelector.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAoB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,eAAe,CAAC;IAChC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAsD9D,CAAC"}
+{"version":3,"file":"DateRangeSelector.d.ts","sourceRoot":"","sources":["../../../src/components/reports/DateRangeSelector.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAoB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,eAAe,CAAC;IAChC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA0C9D,CAAC"}

package/dist/components/reports/ExecutionAuditTrail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionAuditTrail.d.ts","sourceRoot":"","sources":["../../../src/components/reports/ExecutionAuditTrail.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AAYxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAyNlE,CAAC"}
+{"version":3,"file":"ExecutionAuditTrail.d.ts","sourceRoot":"","sources":["../../../src/components/reports/ExecutionAuditTrail.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AAYxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA0NlE,CAAC"}

package/dist/components/reports/ExecutiveDashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutiveDashboard.d.ts","sourceRoot":"","sources":["../../../src/components/reports/ExecutiveDashboard.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAgLhE,CAAC"}
+{"version":3,"file":"ExecutiveDashboard.d.ts","sourceRoot":"","sources":["../../../src/components/reports/ExecutiveDashboard.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAoLhE,CAAC"}

package/dist/components/reports/PortfolioHealth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PortfolioHealth.d.ts","sourceRoot":"","sources":["../../../src/components/reports/PortfolioHealth.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA6P1D,CAAC"}
+{"version":3,"file":"PortfolioHealth.d.ts","sourceRoot":"","sources":["../../../src/components/reports/PortfolioHealth.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA8P1D,CAAC"}

package/dist/components/reports/ReportLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReportLayout.d.ts","sourceRoot":"","sources":["../../../src/components/reports/ReportLayout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,eAAe,CAAC;IACnC,iBAAiB,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAwFpD,CAAC"}
+{"version":3,"file":"ReportLayout.d.ts","sourceRoot":"","sources":["../../../src/components/reports/ReportLayout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,eAAe,CAAC;IACnC,iBAAiB,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA2FpD,CAAC"}

package/dist/components/reports/SupplyChainRisk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SupplyChainRisk.d.ts","sourceRoot":"","sources":["../../../src/components/reports/SupplyChainRisk.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAwV1D,CAAC"}
+{"version":3,"file":"SupplyChainRisk.d.ts","sourceRoot":"","sources":["../../../src/components/reports/SupplyChainRisk.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EACb,WAAW,GACX,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAyV1D,CAAC"}

package/dist/hooks/analytics/useReportData.d.ts

@@ -1,9 +1,11 @@
 /**
  * useReportData Hook
  * Fetches and manages report data with error handling
+ * Implements caching to prevent duplicate requests
  */
 export interface UseReportDataOptions {
     enabled?: boolean;
+    ttl?: number;
 }
 export interface UseReportDataReturn<T> {
     data: T | null;
@@ -13,10 +15,10 @@ export interface UseReportDataReturn<T> {
 }
 /**
  * Generic hook for fetching report data
- * Automatically uses the API from ReactBridgeProvider
+ * Implements caching and deduplication to prevent infinite requests
  * @param fetchFn - Async function to fetch report data
  * @param dependencies - Dependencies that trigger refetch when changed
- * @param options - Hook options (enabled flag)
+ * @param options - Hook options (enabled flag, cache TTL)
  */
 export declare function useReportData<T>(fetchFn: () => Promise<T>, dependencies?: React.DependencyList, options?: UseReportDataOptions): UseReportDataReturn<T>;
 //# sourceMappingURL=useReportData.d.ts.map

package/dist/hooks/analytics/useReportData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useReportData.d.ts","sourceRoot":"","sources":["../../../src/hooks/analytics/useReportData.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,YAAY,GAAE,KAAK,CAAC,cAAmB,EACvC,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAAC,CAAC,CAAC,CAkCxB"}
+{"version":3,"file":"useReportData.d.ts","sourceRoot":"","sources":["../../../src/hooks/analytics/useReportData.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,YAAY,GAAE,KAAK,CAAC,cAAmB,EACvC,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAAC,CAAC,CAAC,CAqFxB"}