react-aiops 0.1.9 → 0.1.10

package/dist/AIOPsDashboard.d.ts

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { DataQueryConfig } from './data/DataProvider';
+import { DataBindings } from './data/DataProvider';
 import { ComponentStatus } from './types';
 import { ServiceDialogMetric, ServiceDialogAlert } from './components/ServiceDialog';
 /**
@@ -47,10 +47,37 @@ export interface AIOPsDashboardProps {
      */
     dataEndpoint?: string;
     /**
-     * Map of query keys to PromQL expressions.
-     * Each key becomes accessible via `useQueryResult(key)` inside child components.
+     * Maps **service name → prop name → PromQL query**.
+     *
+     * Each binding is either a bare query string (uses the global
+     * `dataTransform`) or `{ query, transform }` for per-binding control.
+     *
+     * The package automatically injects resolved values as props into
+     * the matching child service component (matched by `name`).
+     *
+     * @example
+     * ```tsx
+     * dataBindings={{
+     *   "Service Alpha": {
+     *     cpuLoad: 'cpu_usage{instance="srv-01"}',
+     *     status: {
+     *       query: 'up{instance="srv-01"}',
+     *       transform: (v) => (v > 0 ? "online" : "offline"),
+     *     },
+     *   },
+     * }}
+     * ```
+     */
+    dataBindings?: DataBindings;
+    /**
+     * Global transform applied to every raw endpoint response before it is
+     * injected as a prop. Individual bindings can override this with their
+     * own `transform`.
+     *
+     * Defaults to a Prometheus-aware extractor that returns the scalar
+     * value from instant-vector or scalar responses.
      */
-    dataQueries?: DataQueryConfig;
+    dataTransform?: (raw: unknown) => unknown;
     /** Override the default 60 s polling interval (in milliseconds). */
     dataRefreshInterval?: number;
     /**
@@ -60,11 +87,5 @@ export interface AIOPsDashboardProps {
      */
     children: React.ReactNode;
 }
-/**
- * Full AIOps infrastructure dashboard.
- *
- * Renders a branded header, a 3D carousel of services, and a
- * controls footer. All interaction state is self-contained.
- */
-export default function AIOPsDashboard({ brandName, brandTag, services, backgroundImage, logoUrl, carouselSpeed: carouselSpeedProp, fontFamily, dataEndpoint, dataQueries, dataRefreshInterval, children, }: AIOPsDashboardProps): import("react/jsx-runtime").JSX.Element;
+export default function AIOPsDashboard(props: AIOPsDashboardProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AIOPsDashboard.d.ts.map

package/dist/AIOPsDashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIOPsDashboard.d.ts","sourceRoot":"","sources":["../src/AIOPsDashboard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AAGxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAgC,eAAe,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAM1F;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,eAAe,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAChC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EACnC,SAA0B,EAC1B,QAAuB,EACvB,QAAa,EACb,eAAe,EACf,OAAO,EACP,aAAa,EAAE,iBAAyB,EACxC,UAAU,EACV,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,QAAQ,GACX,EAAE,mBAAmB,2CA4KrB"}
+{"version":3,"file":"AIOPsDashboard.d.ts","sourceRoot":"","sources":["../src/AIOPsDashboard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAA4B,MAAM,OAAO,CAAC;AAQjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAgC,eAAe,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAM1F;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,eAAe,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAChC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAMD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,KAAK,EAAE,mBAAmB,2CAmBhE"}

package/dist/data/CredentialsModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CredentialsModal.d.ts","sourceRoot":"","sources":["../../src/data/CredentialsModal.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,UAAU,qBAAqB;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,qBAAqB,2CA0G3E"}
+{"version":3,"file":"CredentialsModal.d.ts","sourceRoot":"","sources":["../../src/data/CredentialsModal.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,UAAU,qBAAqB;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,qBAAqB,2CAkH3E"}

package/dist/data/DataProvider.d.ts

@@ -1,19 +1,26 @@
 import { default as React } from 'react';
-export interface DataQueryConfig {
-    [key: string]: string;
-}
-export interface DataProviderConfig {
-    endpoint: string;
-    queries: DataQueryConfig;
-    /** Polling interval in ms. Defaults to 60 000 (1 minute). */
-    refreshInterval?: number;
-}
+/**
+ * A single data binding: either a bare PromQL query string (uses the global
+ * transform) or an object with a per-binding `transform` override.
+ */
+export type DataBinding = string | {
+    query: string;
+    transform?: (raw: unknown) => unknown;
+};
+/**
+ * Maps **service name → prop name → PromQL binding**.
+ *
+ * The service name must match the `name` prop on the corresponding child
+ * component. Prop names are the component props you want overridden with
+ * live data (e.g. `cpuLoad`, `status`).
+ */
+export type DataBindings = Record<string, Record<string, DataBinding>>;
 export interface Credentials {
     accessKey: string;
     secretKey: string;
 }
 export interface DataContextValue {
-    /** Latest response data keyed by query key. */
+    /** Raw endpoint responses keyed by PromQL query string. */
     data: Record<string, unknown>;
     /** Whether a refresh cycle is currently in-flight. */
     isRefreshing: boolean;
@@ -26,15 +33,30 @@ export interface DataContextValue {
     /** Programmatically set credentials (used by the modal). */
     setCredentials: (creds: Credentials) => void;
 }
-/** Access the full data-provider state. Must be inside an `<AIOPsDashboard>` that has `dataEndpoint` set. */
+/** Access the full data-provider state. Throws when called outside a live-data dashboard. */
 export declare function useAIOpsData(): DataContextValue;
-/** Convenience hook — returns the latest response for a single query key. */
-export declare function useQueryResult(key: string): unknown;
+/** Non-throwing variant — returns `null` when no DataProvider is present. */
+export declare function useAIOpsDataOptional(): DataContextValue | null;
+/** Returns the raw endpoint response for a specific PromQL query string. */
+export declare function useQueryResult(queryString: string): unknown;
+/** Collect every unique PromQL expression from a bindings map. */
+export declare function extractUniqueQueries(bindings: DataBindings): string[];
+/**
+ * Default transform that handles the two most common Prometheus response
+ * shapes (instant-vector and scalar). Returns a number when possible,
+ * otherwise returns the raw value.
+ */
+export declare function defaultDataTransform(response: unknown): unknown;
+export interface DataProviderConfig {
+    endpoint: string;
+    queries: string[];
+    /** Polling interval in ms. Defaults to 60 000 (1 minute). */
+    refreshInterval?: number;
+}
 interface DataProviderProps {
     config: DataProviderConfig;
     children: React.ReactNode;
-    onRefreshStatusChange?: (error: string | null) => void;
 }
-export default function DataProvider({ config, children, onRefreshStatusChange }: DataProviderProps): import("react/jsx-runtime").JSX.Element;
+export default function DataProvider({ config, children }: DataProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=DataProvider.d.ts.map

package/dist/data/DataProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataProvider.d.ts","sourceRoot":"","sources":["../../src/data/DataProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8E,MAAM,OAAO,CAAC;AAOnG,MAAM,WAAW,eAAe;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;IACzB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7B,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD;AAQD,6GAA6G;AAC7G,wBAAgB,YAAY,IAAI,gBAAgB,CAI/C;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGnD;AAMD,UAAU,iBAAiB;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,EAAE,iBAAiB,2CA8FlG"}
+{"version":3,"file":"DataProvider.d.ts","sourceRoot":"","sources":["../../src/data/DataProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8E,MAAM,OAAO,CAAC;AAOnG;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,CAAC;AAE5F;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7B,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD;AAQD,6FAA6F;AAC7F,wBAAgB,YAAY,IAAI,gBAAgB,CAK/C;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,IAAI,gBAAgB,GAAG,IAAI,CAE9D;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG3D;AAMD,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAQrE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAyB/D;AAMD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,iBAAiB;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,iBAAiB,2CA0F3E"}

package/dist/data/index.d.ts

@@ -1,4 +1,4 @@
 export { default as DataProvider } from './DataProvider';
-export { useAIOpsData, useQueryResult } from './DataProvider';
-export type { DataQueryConfig, DataProviderConfig, Credentials, DataContextValue } from './DataProvider';
+export { useAIOpsData, useAIOpsDataOptional, useQueryResult, extractUniqueQueries, defaultDataTransform, } from './DataProvider';
+export type { DataBinding, DataBindings, DataProviderConfig, Credentials, DataContextValue, } from './DataProvider';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACH,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACR,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,gBAAgB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -5,6 +5,6 @@ export * from './services';
 export * from './types';
 export { STATUS_CFG, HOLO_CYAN, HOLO_BLUE, HOLO_SURFACE, HOLO_GLASS, makeFaceStyles } from './theme';
 export type { ComponentStatus, StatusCfg, FaceName, Base3DProps } from './theme';
-export { DataProvider, useAIOpsData, useQueryResult } from './data';
-export type { DataQueryConfig, DataProviderConfig, Credentials, DataContextValue } from './data';
+export { DataProvider, useAIOpsData, useAIOpsDataOptional, useQueryResult, defaultDataTransform, } from './data';
+export type { DataBinding, DataBindings, DataProviderConfig, Credentials, DataContextValue } from './data';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzE,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACrG,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzE,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACrG,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjF,OAAO,EACH,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACvB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC"}