@burdenoff/microfe-bigconsole 2026.930.2 → 2026.1001.2

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

@@ -0,0 +1,1373 @@
+import { MicrofrontendRootProps } from '@burdenoff/fe-libs/shared/types';
+import { ConditionalRule } from '../components/widgets/utils/conditionalFormat';
+import { CellChart } from '../components/widgets/table/TableCell';
+
+export type { ConditionalRule, ConditionalStyle, ConditionalOperator, ConditionalIcon, SemanticIntent, } from '../components/widgets/utils/conditionalFormat';
+/**
+ * A reference / threshold line or band drawn on a cartesian chart
+ * (targets, control limits, SLAs). Color is a semantic intent.
+ */
+export interface ChartReferenceLine {
+    /** Axis the value is measured against. */
+    axis?: 'x' | 'y';
+    /** Single value → line. Provide `value2` as well for a shaded band. */
+    value: number;
+    /** Upper bound for a band (ReferenceArea between `value` and `value2`). */
+    value2?: number;
+    /** Label rendered next to the line/band. */
+    label?: string;
+    /** Semantic color intent (success/warning/danger/info/neutral). */
+    color?: import('../components/widgets/utils/conditionalFormat').SemanticIntent;
+    /** Dashed stroke for lines. */
+    dashed?: boolean;
+}
+/**
+ * Per-series descriptor for combo / dual-axis charts. Lets a single chart mix
+ * bars and lines and bind series to a left or right Y-axis.
+ */
+export interface ChartSeriesConfig {
+    /** Data field name for this series. */
+    field: string;
+    /** Display name (legend/tooltip). */
+    label?: string;
+    /** Render this series as a bar or a line. */
+    type?: 'bar' | 'line';
+    /** Bind to the left (primary) or right (secondary) Y-axis. */
+    axis?: 'left' | 'right';
+    /** Semantic-token CSS var or chart palette color override. */
+    color?: string;
+}
+/**
+ * BigConsole microfrontend root props
+ * Extends standard MicrofrontendRootProps with required auth
+ */
+export interface BigConsoleRootProps extends MicrofrontendRootProps {
+    /**
+     * API Gateway URL (used when connecting via gateway in workspaces-app)
+     * Will append /workspaces/graphql to this URL
+     */
+    apiGatewayUrl?: string;
+    /**
+     * Direct GraphQL URL (used for standalone bigconsole-app)
+     * When provided, connects directly to this URL without gateway prefix
+     */
+    graphqlUrl?: string;
+    /**
+     * Authentication token (required for BigConsole)
+     */
+    authToken: string;
+    /**
+     * Workspace-scoped JWT token. The gateway requires both authToken
+     * (Authorization) and workspaceToken (X-Workspace-Authorization)
+     * for workspace-scoped operations.
+     */
+    workspaceToken?: string;
+}
+/**
+ * BigConsole admin microfrontend root props.
+ *
+ * Used when the admin surface is mounted inside the platform admin-app.
+ * Inherits the same host-shell contract as the main BigConsole root.
+ */
+export type AdminRootProps = BigConsoleRootProps;
+export type WidgetType = 'kpi_card_comparison' | 'metric_card' | 'chart' | 'funnel_chart' | 'table' | 'pivot_table' | 'gauge' | 'progress' | 'list' | 'form' | 'text' | 'iframe' | 'map' | 'heatmap' | 'calendar' | 'kanban' | 'timeline' | 'retention' | 'custom';
+export type NavigationMode = 'SAME_WINDOW' | 'NEW_TAB' | 'MODAL' | 'IN_PLACE';
+export interface WidgetPosition {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface WidgetPositionInput {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ResponsivePosition {
+    /** Column span at xs breakpoint (0-640px) */
+    xs: number;
+    /** Column span at sm breakpoint (640-768px) */
+    sm: number;
+    /** Column span at md breakpoint (768-1024px) */
+    md: number;
+    /** Column span at lg breakpoint (1024-1536px) */
+    lg: number;
+    /**
+     * Column span at xl breakpoint (1536px+).
+     * Optional: when absent, the layout falls back to the `lg` span so that
+     * existing dashboards (which only define xs/sm/md/lg) are unaffected.
+     */
+    xl?: number;
+}
+export interface ResponsivePositionInput {
+    xs?: number;
+    sm?: number;
+    md?: number;
+    lg?: number;
+    /** Column span at xl breakpoint (1536px+). Falls back to `lg` when omitted. */
+    xl?: number;
+}
+export interface WidgetDrilldown {
+    id: string;
+    sourceWidgetId: string;
+    /** Target dashboard; may be the widget's own dashboard when targetPageId is set (BOFF-7625) */
+    targetDashboardId: string;
+    /** Page of the target dashboard to open; null/absent means its first page (BOFF-7625) */
+    targetPageId?: string | null;
+    parameterMapping: Record<string, unknown>;
+    navigationMode: NavigationMode;
+    enabled: boolean;
+    /** Whether to pass global filters to target dashboard */
+    passGlobalFilters?: boolean;
+    /** Maximum drilldown depth allowed (default: 3) */
+    maxDepth?: number;
+    metadata?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateDrilldownInput {
+    sourceWidgetId: string;
+    targetDashboardId: string;
+    /** Page of the target dashboard (BOFF-7625) */
+    targetPageId?: string | null;
+    parameterMapping: Record<string, unknown>;
+    navigationMode?: NavigationMode;
+    /** Whether to pass global filters to target dashboard */
+    passGlobalFilters?: boolean;
+    /** Maximum drilldown depth allowed (default: 3) */
+    maxDepth?: number;
+}
+export interface UpdateDrilldownInput {
+    id: string;
+    targetDashboardId?: string;
+    /** Page of the target dashboard; null clears it (first page) (BOFF-7625) */
+    targetPageId?: string | null;
+    parameterMapping?: Record<string, unknown>;
+    navigationMode?: NavigationMode;
+    enabled?: boolean;
+    /** Whether to pass global filters to target dashboard */
+    passGlobalFilters?: boolean;
+    /** Maximum drilldown depth allowed (default: 3) */
+    maxDepth?: number;
+}
+export interface WidgetTranslation {
+    id: string;
+    widgetId: string;
+    locale: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WidgetTranslationInput {
+    locale: string;
+    title: string;
+}
+export type RendererType = 'BIGCONSOLE' | 'ADAPTIVE_CARD' | 'BLOCKKIT' | 'CUSTOM';
+export interface Widget {
+    id: string;
+    pageId: string;
+    dashboardId?: string;
+    type: WidgetType;
+    title: string;
+    description?: string;
+    renderer?: RendererType;
+    template?: Record<string, unknown> | null;
+    dataSourceId?: string | null;
+    dataPath?: string | null;
+    dataSinkId?: string | null;
+    datasetId?: string | null;
+    parserId?: string | null;
+    parserRules?: string | null;
+    config: Record<string, unknown>;
+    position: WidgetPosition;
+    positionX: number;
+    positionY: number;
+    positionWidth: number;
+    positionHeight: number;
+    positionResponsive?: ResponsivePosition | null;
+    rowOrder?: number | null;
+    refreshInterval?: number | null;
+    lastRefreshedAt?: string | null;
+    cacheTTL?: number | null;
+    metadata?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    drilldown?: WidgetDrilldown | null;
+    drilldowns?: WidgetDrilldown[];
+    translations?: WidgetTranslation[];
+    actions?: WidgetAction[];
+    data?: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export type ActionType = 'BUTTON' | 'LINK' | 'MENU_ITEM' | 'EMIT_EVENT' | 'NAVIGATE' | 'CUSTOM';
+export type ActionStyle = 'PRIMARY' | 'SECONDARY' | 'DANGER' | 'WARNING' | 'SUCCESS' | 'GHOST' | 'LINK';
+export interface ActionConfirmation {
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+export interface WidgetAction {
+    id: string;
+    widgetId: string;
+    name: string;
+    label: string;
+    type: ActionType;
+    style: ActionStyle;
+    icon?: string | null;
+    confirmation?: ActionConfirmation | null;
+    disabled: boolean;
+    hidden: boolean;
+    order: number;
+    metadata?: Record<string, unknown> | null;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface CreateWidgetInput {
+    pageId: string;
+    type: WidgetType;
+    title: string;
+    dataSourceId?: string;
+    dataPath?: string;
+    config: Record<string, unknown>;
+    position: WidgetPositionInput;
+    positionResponsive?: ResponsivePositionInput;
+    rowOrder?: number;
+    refreshInterval?: number;
+    metadata?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    translations?: WidgetTranslationInput[];
+}
+export interface UpdateWidgetInput {
+    id: string;
+    title?: string;
+    dataSourceId?: string | null;
+    dataPath?: string | null;
+    config?: Record<string, unknown>;
+    position?: WidgetPositionInput;
+    positionResponsive?: ResponsivePositionInput;
+    rowOrder?: number;
+    refreshInterval?: number | null;
+    metadata?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    translations?: WidgetTranslationInput[];
+}
+export interface WidgetData {
+    raw: Record<string, unknown>;
+    processed: Record<string, unknown>;
+    fetchedAt: string;
+    cached: boolean;
+    error?: string | null;
+}
+export interface WidgetTypeInfo {
+    type: WidgetType;
+    name: string;
+    description: string;
+    icon: string;
+    category: WidgetCategory;
+    defaultConfig: Record<string, unknown>;
+    minWidth: number;
+    minHeight: number;
+    maxWidth: number;
+    maxHeight: number;
+}
+export type WidgetCategory = 'KPI' | 'Visualization' | 'Data' | 'Content' | 'Temporal' | 'Custom' | 'Installed';
+export interface MetricCardConfig {
+    /**
+     * Numeric style. `'auto'` defers to the payload's `isCurrency`; every other
+     * value is an explicit user choice and always wins over the payload.
+     */
+    format: 'auto' | 'currency' | 'percentage' | 'number' | 'decimal' | 'compact';
+    decimalPlaces: number;
+    showTrend: boolean;
+    showSparkline: boolean;
+    currencySymbol?: string;
+    trendDirection?: 'up' | 'down' | 'flat';
+    thresholds?: {
+        warning?: number;
+        danger?: number;
+    };
+    subtitle?: string;
+    prefix?: string;
+    suffix?: string;
+    comparisonLabel?: string;
+    showComparison?: boolean;
+    positiveIsGood?: boolean;
+    /** Field name to extract value from data object (e.g., "totalSales") */
+    valueField?: string;
+    /** Field name for previous value comparison (e.g., "previousSales") */
+    previousValueField?: string;
+    /** Conditional formatting rules applied to the metric value */
+    conditionalRules?: ConditionalRule[];
+}
+export interface ChartConfig {
+    chartType: 'line' | 'bar' | 'area' | 'pie' | 'doughnut' | 'scatter' | 'heatmap' | 'funnel' | 'combo' | 'waterfall';
+    showLegend: boolean;
+    legendPosition: 'top' | 'bottom' | 'left' | 'right';
+    showGrid: boolean;
+    showTooltip: boolean;
+    xAxisLabel?: string;
+    yAxisLabel?: string;
+    colors?: string[];
+    stacked?: boolean;
+    smooth?: boolean;
+    /** Field to use for X-axis values */
+    xAxisField?: string;
+    /** Curve interpolation type for line/area charts */
+    curveType?: 'monotone' | 'linear' | 'step' | 'natural';
+    /** Field to use for values (pie/funnel charts) */
+    valueField?: string;
+    /** Field to use for labels (pie/funnel charts) */
+    labelField?: string;
+    /** Display pie chart as donut */
+    showAsDonut?: boolean;
+    /** Show data point markers on line/area charts */
+    showDataPoints?: boolean;
+    /** Labels for multiple series */
+    seriesLabels?: string[];
+    /** Inner radius for doughnut/pie charts */
+    innerRadius?: number;
+    /** Outer radius for doughnut/pie charts */
+    outerRadius?: number;
+    /** Cross-filter mappings for Phase 2 cross-filtering */
+    crossFilterMappings?: Array<{
+        sourceField: string;
+        targetFilterId: string;
+    }>;
+    /** Selected numeric fields to display as chart series */
+    selectedFields?: string[];
+    /** Reference / threshold lines & bands (targets, control limits, SLAs) */
+    referenceLines?: ChartReferenceLine[];
+    /** Per-series config for combo / dual-axis charts (bar+line, 2 Y-axes) */
+    series?: ChartSeriesConfig[];
+    /** Enable a secondary (right) Y-axis for series bound to `axis: 'right'` */
+    dualAxis?: boolean;
+    /** Label for the secondary (right) Y-axis */
+    yAxisRightLabel?: string;
+    /** Conditional formatting rules applied to series values */
+    conditionalRules?: ConditionalRule[];
+}
+export interface TableConfig {
+    pageSize: number;
+    sortable: boolean;
+    filterable: boolean;
+    columns: TableColumnConfig[];
+    stickyHeader: boolean;
+    rowActions?: boolean;
+    exportable?: boolean;
+    /** Show search input */
+    showSearch?: boolean;
+    /** Show pagination controls */
+    showPagination?: boolean;
+    /** Show export button */
+    showExport?: boolean;
+    /** Display alternating row colors */
+    stripedRows?: boolean;
+    /** Default column to sort by */
+    defaultSortColumn?: string;
+    /** Default sort direction */
+    defaultSortDirection?: 'asc' | 'desc';
+    /** Cross-filter mappings for Phase 2 cross-filtering */
+    crossFilterMappings?: Array<{
+        sourceField: string;
+        targetFilterId: string;
+    }>;
+    /** Enable cross-filtering without explicit mappings (Phase 2) */
+    enableCrossFilter?: boolean;
+    /** Conditional formatting rules applied across all rows/cells */
+    conditionalRules?: ConditionalRule[];
+    /**
+     * Row-level conditional formatting. Each rule tests a `field` on the whole
+     * row (e.g. an `overTarget` breach flag or a `boardingMins` threshold) and,
+     * when matched, tints the entire `<tr>` — background fill + an optional
+     * left-edge accent bar — using a semantic intent (success/warning/danger).
+     * This is the "breach rows render red" escalation surface; rules are
+     * last-wins (order general → specific). Semantic intents only, never hex.
+     */
+    rowRules?: ConditionalRule[];
+    /** Show a footer row with per-column totals/aggregates */
+    showTotals?: boolean;
+    /** Window large datasets (row virtualization) instead of rendering every row */
+    virtualized?: boolean;
+    /** Fixed row height in px used by virtualization (default 44) */
+    rowHeight?: number;
+    /** Number of leading columns to freeze (sticky-left) when scrolling horizontally */
+    frozenColumns?: number;
+}
+export interface TableColumnConfig {
+    key?: string;
+    label?: string;
+    visible?: boolean;
+    width?: number;
+    sortable?: boolean;
+    filterable?: boolean;
+    format?: 'text' | 'number' | 'currency' | 'date' | 'percentage' | 'badge' | 'link';
+    /**
+     * URL template for `link`-formatted columns. `{value}` substitutes the cell
+     * value; any other `{field}` substitutes that field from the same row
+     * (e.g. `"{Url}"` or `"https://github.com/Algoshred/{Repo}/pull/{value}"`).
+     * `value` is reserved (always the cell value, shadowing a column named
+     * `value`). A missing or blank field degrades to plain text. Add `|encode`
+     * to a token (`{value|encode}`) to `encodeURIComponent` that substitution.
+     * Only http(s) resolves to a navigable anchor. When omitted, a cell whose
+     * value is itself an http(s) URL auto-links.
+     */
+    linkPattern?: string;
+    /** Data field name (alternative to key) */
+    field?: string;
+    /** Column header text (alternative to label) */
+    header?: string;
+    /** Text alignment */
+    align?: 'left' | 'center' | 'right';
+    /** Per-column conditional formatting rules (override table-level rules) */
+    conditionalRules?: ConditionalRule[];
+    /** Aggregate to show in the totals footer for this column */
+    total?: 'sum' | 'avg' | 'min' | 'max' | 'count' | 'none';
+    /**
+     * Render the cell as a mini in-cell chart instead of a value. `sparkline`
+     * expects the cell value to be an array of numbers (or `{value}` objects).
+     * Type is the canonical `CellChart` from TableCell (single source of truth).
+     */
+    cellChart?: CellChart;
+}
+export interface ColumnDefinition {
+    key: string;
+    header: string;
+    sortable?: boolean;
+    width?: string;
+    align?: string;
+}
+export interface GaugeConfig {
+    variant: 'circular' | 'linear';
+    min: number;
+    max: number;
+    units?: string;
+    unit?: string;
+    thresholds: GaugeThreshold[];
+    showValue: boolean;
+    showLabels: boolean;
+    /** Value format type */
+    format?: 'number' | 'currency' | 'percentage' | 'decimal';
+    /** Number of decimal places */
+    decimals?: number;
+    /** Show threshold zones */
+    showZones?: boolean;
+    /** Gauge size */
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface GaugeThreshold {
+    value: number;
+    color: string;
+    label?: string;
+}
+export interface ProgressConfig {
+    showPercentage: boolean;
+    showValue: boolean;
+    target?: number;
+    milestones?: ProgressMilestone[];
+    colorStages?: ProgressColorStage[];
+    max?: number;
+    barHeight?: number;
+    format?: 'number' | 'percentage' | 'currency' | 'compact';
+    colorMode?: 'auto' | 'fixed' | 'gradient' | 'dynamic' | 'success' | 'warning' | 'error';
+    showMax?: boolean;
+}
+export interface ProgressMilestone {
+    value?: number;
+    label: string;
+    position?: number;
+}
+export interface ProgressColorStage {
+    maxValue: number;
+    color: 'success' | 'warning' | 'danger' | 'info';
+}
+export interface ListConfig {
+    showMetadata: boolean;
+    showActions: boolean;
+    showBadges: boolean;
+    maxItems?: number;
+    itemClickable: boolean;
+    /** Field to use for item title */
+    titleField?: string;
+    /** Field to use for item subtitle */
+    subtitleField?: string;
+    /** Field to use for item value */
+    valueField?: string;
+    /** Field to use for badge content */
+    badgeField?: string;
+    /** Show total count */
+    showCount?: boolean;
+    /** Show search input */
+    showSearch?: boolean;
+    /** Show "View All" link */
+    showViewAll?: boolean;
+    /** Show item icon */
+    showIcon?: boolean;
+}
+export interface KPIConfig {
+    comparisons: KPIComparison[];
+    showSparklines: boolean;
+    layout: 'horizontal' | 'vertical' | 'grid';
+    /** Value format type */
+    format?: 'currency' | 'percentage' | 'number' | 'decimal';
+    /** Whether positive change is good (affects color) */
+    positiveIsGood?: boolean;
+    /** Conditional formatting rules applied to each KPI value */
+    conditionalRules?: ConditionalRule[];
+    /**
+     * Maximum number of KPI cards to render. Applies uniformly to every data
+     * shape (kpis array, row array, object). Unset means no limit; any KPIs
+     * beyond the limit are reported in a "+N more" footer rather than dropped
+     * silently.
+     */
+    maxKpis?: number;
+}
+export interface KPIComparison {
+    label: string;
+    field: string;
+    format: 'percentage' | 'absolute' | 'delta';
+}
+export interface FunnelConfig {
+    showLabels: boolean;
+    showValues: boolean;
+    showPercentages: boolean;
+    orientation: 'vertical' | 'horizontal';
+}
+export interface HeatmapConfig {
+    xAxisField: string;
+    yAxisField: string;
+    valueField: string;
+    colorScale: string[];
+    showValues: boolean;
+    /** Color scheme name */
+    colorScheme?: string;
+    /** Number of decimal places */
+    decimals?: number;
+    /** Show color legend */
+    showLegend?: boolean;
+}
+export interface RetentionConfig {
+    cohortField: string;
+    periodField: string;
+    valueField: string;
+    periodType: 'day' | 'week' | 'month';
+    showPercentages: boolean;
+    /** Number of decimal places */
+    decimals?: number;
+    /** Show averages row/column */
+    showAverages?: boolean;
+    /** Show color legend */
+    showLegend?: boolean;
+}
+export interface AdaptiveCardConfig {
+    template: Record<string, unknown>;
+    dataBinding?: Record<string, string>;
+}
+export interface CustomWidgetConfig {
+    componentId: string;
+    props?: Record<string, unknown>;
+    /** Description of the custom widget */
+    description?: string;
+}
+export interface PivotTableConfig {
+    /** Fields to group by rows */
+    rows: string[];
+    /** Fields to group by columns */
+    columns: string[];
+    /** Fields to aggregate with their aggregation functions */
+    values: PivotValueField[];
+    /** Show row totals */
+    showRowTotals: boolean;
+    /** Show column totals */
+    showColumnTotals: boolean;
+    /** Show grand total */
+    showGrandTotal: boolean;
+    /** Allow row expansion/collapse */
+    expandable: boolean;
+    /** Number format */
+    numberFormat: 'number' | 'currency' | 'percentage';
+    /** Decimal places */
+    decimalPlaces: number;
+}
+export interface PivotValueField {
+    field: string;
+    aggregation: 'sum' | 'count' | 'average' | 'min' | 'max';
+    label?: string;
+}
+export type FormFieldType = 'text' | 'number' | 'email' | 'password' | 'tel' | 'url' | 'textarea' | 'select' | 'checkbox' | 'radio' | 'date' | 'datetime' | 'time' | 'hidden';
+export interface FormFieldOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface FormValidationRule {
+    type: 'required' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'email' | 'custom';
+    value?: string | number;
+    message: string;
+}
+export interface FormFieldConfig {
+    name: string;
+    label: string;
+    type: FormFieldType;
+    placeholder?: string;
+    defaultValue?: unknown;
+    required?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    helpText?: string;
+    options?: FormFieldOption[];
+    validation?: FormValidationRule[];
+    min?: number | string;
+    max?: number | string;
+    step?: number;
+    rows?: number;
+    pattern?: string;
+}
+export interface FormConfig {
+    /** Form fields */
+    fields: FormFieldConfig[];
+    /** Layout type */
+    layout: 'vertical' | 'horizontal' | 'grid';
+    /** Grid columns (for grid layout) */
+    columns?: number;
+    /** Submit button label */
+    submitLabel?: string;
+    /** Reset button label */
+    resetLabel?: string;
+    /** Show reset button */
+    showReset?: boolean;
+    /** Action name to emit on submit */
+    submitAction?: string;
+    /** Success message after submit */
+    successMessage?: string;
+    /** Validate on field blur */
+    validateOnBlur?: boolean;
+    /** Validate on field change */
+    validateOnChange?: boolean;
+}
+/**
+ * Who can reach a dashboard by link (`Dashboard.visibility`, DashboardVisibility).
+ * Distinct from per-person shares: this is the general-access level.
+ */
+export type DashboardVisibility = 'PRIVATE' | 'WORKSPACE' | 'PUBLIC';
+export interface Dashboard {
+    id: string;
+    workspaceId: string;
+    name: string;
+    /** Alias for name - some components use title */
+    title?: string;
+    description?: string;
+    slug: string;
+    isPublished: boolean;
+    isTemplate: boolean;
+    /** General access level. Undefined when the source query did not select it. */
+    visibility?: DashboardVisibility;
+    layoutConfig: DashboardLayoutConfig;
+    theme?: DashboardTheme;
+    pages: DashboardPage[];
+    translations: DashboardTranslation[];
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DashboardLayoutConfig {
+    columns: number;
+    rowHeight: number;
+    gap: number;
+    margin: number[];
+    containerPadding: number[];
+}
+export interface DashboardTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    borderRadius?: number;
+}
+export interface DashboardPage {
+    id: string;
+    dashboardId?: string;
+    name?: string;
+    /** Alias for name - used in some components */
+    title?: string;
+    slug?: string;
+    order?: number;
+    /** Alias for order - used in some components */
+    index?: number;
+    layoutConfig?: Record<string, unknown>;
+    widgets?: Widget[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface DashboardTranslation {
+    id: string;
+    dashboardId: string;
+    locale: string;
+    name: string;
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateDashboardInput {
+    workspaceId: string;
+    name: string;
+    description?: string;
+    layoutConfig?: DashboardLayoutConfig;
+    theme?: DashboardTheme;
+}
+export interface UpdateDashboardInput {
+    id: string;
+    name?: string;
+    description?: string;
+    isPublished?: boolean;
+    layoutConfig?: DashboardLayoutConfig;
+    theme?: DashboardTheme;
+}
+export type DataSourceType = 'REST_API' | 'GRAPHQL' | 'SQL' | 'WEBSOCKET' | 'MOCK' | 'DATASINK';
+export interface WidgetBindingSource {
+    kind: DataSourceType;
+    /** Managed DataSink/connection reference. Never store credentials here. */
+    ref?: string;
+}
+export interface WidgetBinding {
+    source: WidgetBindingSource;
+    parserId?: string;
+    fields: Record<string, string>;
+}
+export type WidgetBindingStatus = 'unbound' | 'loading' | 'bound' | 'no_data' | 'parser_error' | 'field_mismatch';
+export interface WidgetBindingValidation {
+    status: Extract<WidgetBindingStatus, 'unbound' | 'bound' | 'field_mismatch'>;
+    missingFields: string[];
+}
+export interface DataSource {
+    id: string;
+    workspaceId: string;
+    name: string;
+    type: DataSourceType;
+    connectionConfig: Record<string, unknown>;
+    authConfig?: Record<string, unknown>;
+    query: string;
+    queryParams?: Record<string, unknown>;
+    cacheTTL: number;
+    isActive: boolean;
+    lastTestedAt?: string;
+    testStatus?: 'success' | 'failure' | 'pending';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateDataSourceInput {
+    workspaceId: string;
+    name: string;
+    type: DataSourceType;
+    connectionConfig: Record<string, unknown>;
+    authConfig?: Record<string, unknown>;
+    query: string;
+    queryParams?: Record<string, unknown>;
+    cacheTTL?: number;
+}
+export interface UpdateDataSourceInput {
+    id: string;
+    name?: string;
+    connectionConfig?: Record<string, unknown>;
+    authConfig?: Record<string, unknown>;
+    query?: string;
+    queryParams?: Record<string, unknown>;
+    cacheTTL?: number;
+    isActive?: boolean;
+}
+export type InsightType = 'anomaly' | 'trend' | 'prediction' | 'recommendation';
+export interface AIInsight {
+    id: string;
+    dashboardId: string;
+    type: InsightType;
+    title: string;
+    description: string;
+    confidence: number;
+    data?: Record<string, unknown>;
+    createdAt: string;
+}
+export interface PageInfo {
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    startCursor?: string;
+    endCursor?: string;
+}
+export interface WidgetConnection {
+    edges: WidgetEdge[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+export interface WidgetEdge {
+    cursor: string;
+    node: Widget;
+}
+export interface WidgetUIState {
+    isLoading: boolean;
+    isError: boolean;
+    isEmpty: boolean;
+    isEditing: boolean;
+    isSelected: boolean;
+    isDragging: boolean;
+    isResizing: boolean;
+}
+export interface DashboardUIState {
+    isEditMode: boolean;
+    selectedWidgetId: string | null;
+    configPanelOpen: boolean;
+    addWidgetDialogOpen: boolean;
+    previewMode: boolean;
+}
+export interface GridLayoutItem {
+    i: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    minW?: number;
+    minH?: number;
+    maxW?: number;
+    maxH?: number;
+    static?: boolean;
+    isDraggable?: boolean;
+    isResizable?: boolean;
+}
+export type GridLayout = GridLayoutItem[];
+/** Data sink status values */
+export type DataSinkStatus = 'ready' | 'error' | 'stale' | 'refreshing';
+/** Data sink setup state tracking */
+export type DataSinkSetupState = 'workflow_pending' | 'workflow_running' | 'workflow_completed' | 'configuration_pending' | 'completed';
+/** Data sink refresh type */
+export type DataSinkRefreshType = 'manual' | 'scheduled' | 'on_demand';
+/** Refresh schedule configuration */
+export interface RefreshSchedule {
+    cron: string;
+    timezone: string;
+}
+/** Data sink refresh configuration */
+export interface DataSinkRefreshConfig {
+    type: DataSinkRefreshType;
+    schedule?: RefreshSchedule | null;
+}
+/** Data sink data statistics */
+export interface DataSinkDataStats {
+    dataSizeBytes: number;
+    hash: string | null;
+}
+/** Data sink export configuration */
+export interface DataSinkExport {
+    id: string;
+    name: string;
+    format: 'pdf' | 'csv' | 'excel';
+    schedule?: RefreshSchedule | null;
+    recipients: string[];
+    template?: string | null;
+    enabled: boolean;
+}
+/** Alert throttle configuration */
+export interface AlertThrottle {
+    enabled: boolean;
+    windowMinutes: number;
+    maxAlertsPerWindow: number;
+}
+/** Alert severity levels */
+export type AlertSeverity = 'low' | 'medium' | 'high' | 'critical';
+/** Data sink alert configuration */
+export interface DataSinkAlert {
+    id: string;
+    name: string;
+    condition: string;
+    severity: AlertSeverity;
+    channels: string[];
+    recipients: string[];
+    throttle?: AlertThrottle | null;
+    enabled: boolean;
+}
+/** Data sink quota configuration */
+export interface DataSinkQuota {
+    maxDataSize: number;
+    maxRetentionDays: number;
+    alertThreshold: number;
+    alertRecipients?: string[];
+}
+/** Complete DataSink entity */
+export interface DataSink {
+    id: string;
+    workspaceId: string;
+    tenantId: string;
+    name: string | null;
+    description: string | null;
+    key: string;
+    /** @deprecated Use workflowLinks relation */
+    fluidGridsWorkflowId: string | null;
+    fluidGridsWorkflowExecutionId: string | null;
+    config: Record<string, unknown> | null;
+    data: Record<string, unknown>;
+    dataStats: DataSinkDataStats | null;
+    lastRefreshedAt: string;
+    lastRefreshedBy: string | null;
+    expiresAt: string | null;
+    nextRefreshAt: string | null;
+    ttl: number;
+    version: number;
+    sizeBytes: number;
+    isActive: boolean;
+    fieldMaskingEnabled: boolean;
+    fieldMaskingRules: Record<string, unknown> | null;
+    status: DataSinkStatus;
+    statusChangedAt: string | null;
+    statusChangedBy: string | null;
+    setupState: DataSinkSetupState;
+    refresh: DataSinkRefreshConfig | null;
+    exports: DataSinkExport[] | null;
+    alerts: DataSinkAlert[] | null;
+    quota: DataSinkQuota | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy: string;
+    deletedAt: string | null;
+    deletedBy: string | null;
+    /** Linked workflows (v2.1) */
+    workflowLinks?: DataSinkWorkflowLink[];
+    /** Count of linked workflows */
+    linkedWorkflowCount?: number;
+}
+/** Data sink list item (subset for list views) */
+export interface DataSinkListItem {
+    id: string;
+    name: string | null;
+    key: string;
+    status: DataSinkStatus;
+    setupState: DataSinkSetupState;
+    sizeBytes: number;
+    lastRefreshedAt: string;
+    isActive: boolean;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    linkedWorkflowCount?: number;
+}
+/** Data retrieved from data sink */
+export interface DataSinkData {
+    raw: Record<string, unknown>;
+    extracted: Record<string, unknown> | null;
+    cached: boolean;
+    version: number;
+    fetchedAt: string;
+}
+/** Input for creating a data sink */
+export interface CreateDataSinkInput {
+    /** Unique key within workspace (required) */
+    key: string;
+    /** DataSink name (required) */
+    name: string;
+    /** Description (optional) */
+    description?: string;
+    /** Cache TTL in seconds (default: 300) */
+    ttl?: number;
+    /** Refresh configuration */
+    refresh?: {
+        type: DataSinkRefreshType;
+        schedule?: RefreshSchedule;
+    };
+    /** Additional configuration */
+    config?: Record<string, unknown>;
+    /** Initial data payload JSON (optional - workflows push data later) */
+    data?: Record<string, unknown>;
+    /** Export configurations */
+    exports?: DataSinkExport[];
+    /** Alert rules */
+    alerts?: DataSinkAlert[];
+    /** Resource quota configuration */
+    quota?: {
+        maxDataSize?: number;
+        maxRetentionDays?: number;
+        alertThreshold?: number;
+    };
+    /** Field-level masking enabled */
+    fieldMaskingEnabled?: boolean;
+    /** Field masking rules */
+    fieldMaskingRules?: Record<string, unknown>;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+    /** Initial setup state */
+    setupState?: DataSinkSetupState;
+}
+/** Input for updating a data sink */
+export interface UpdateDataSinkInput {
+    id: string;
+    version: number;
+    name?: string;
+    description?: string;
+    /** Updated data payload (JSON) */
+    data?: unknown;
+    ttl?: number;
+    isActive?: boolean;
+    status?: DataSinkStatus;
+    setupState?: DataSinkSetupState;
+    fieldMaskingEnabled?: boolean;
+    fieldMaskingRules?: Record<string, unknown>;
+    refresh?: {
+        type: DataSinkRefreshType;
+        schedule?: RefreshSchedule;
+    };
+    exports?: DataSinkExport[];
+    alerts?: DataSinkAlert[];
+    quota?: {
+        maxDataSize?: number;
+        maxRetentionDays?: number;
+        alertThreshold?: number;
+    };
+    metadata?: Record<string, unknown>;
+}
+/** Data sink connection for pagination */
+export interface DataSinkConnection {
+    edges: DataSinkEdge[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+export interface DataSinkEdge {
+    cursor: string;
+    node: DataSink | DataSinkListItem;
+}
+/** Parser expression type (JQ and JSONata only) */
+export type ParserType = 'jq' | 'jsonata';
+/** Parser status */
+export type ParserStatus = 'active' | 'inactive';
+/** Complete Parser entity */
+export interface Parser {
+    id: string;
+    workspaceId: string;
+    tenantId?: string;
+    consoleId: string;
+    name: string;
+    description: string | null;
+    type: ParserType;
+    expression: string;
+    inputSinkKey: string;
+    outputKey: string;
+    ttl: number | null;
+    status: ParserStatus;
+    version: number;
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy: string;
+}
+/** Parser list item (subset for list views) */
+export interface ParserListItem {
+    id: string;
+    consoleId: string;
+    name: string;
+    description: string | null;
+    type: ParserType;
+    inputSinkKey: string;
+    outputKey: string;
+    status: ParserStatus;
+    updatedAt: string;
+}
+/** Result of testing a parser expression */
+export interface TestParserExpressionResult {
+    success: boolean;
+    output: unknown;
+    error: string | null;
+    executionTimeMs: number;
+}
+/** Result of executing a parser */
+export interface ParserExecutionResult {
+    parserId: string;
+    success: boolean;
+    output: unknown;
+    error: string | null;
+    executionTimeMs: number;
+    cachedAt: string | null;
+}
+/** Input for creating a parser */
+export interface CreateParserInput {
+    consoleId: string;
+    name: string;
+    type: ParserType;
+    expression: string;
+    inputSinkKey: string;
+    outputKey: string;
+    description?: string;
+    ttl?: number;
+}
+/** Input for updating a parser */
+export interface UpdateParserInput {
+    name?: string;
+    description?: string;
+    type?: ParserType;
+    expression?: string;
+    inputSinkKey?: string;
+    outputKey?: string;
+    ttl?: number;
+    status?: ParserStatus;
+}
+/** Input for testing a parser expression */
+export interface TestParserInput {
+    type: ParserType;
+    expression: string;
+    sampleData: unknown;
+}
+/** Parser connection for pagination */
+export interface ParserConnection {
+    edges: ParserEdge[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+export interface ParserEdge {
+    cursor: string;
+    node: Parser | ParserListItem;
+}
+/** Pipeline status */
+export type PipelineStatus = 'draft' | 'active' | 'inactive' | 'error';
+/** Stage error handling strategy */
+export type StageErrorHandling = 'fail' | 'skip' | 'fallback';
+/** Pipeline execution status */
+export type PipelineExecutionStatus = 'pending' | 'running' | 'completed' | 'failed';
+/** Stage execution status */
+export type StageExecutionStatus = 'pending' | 'running' | 'success' | 'skipped' | 'failed';
+/** Pipeline stage definition */
+export interface PipelineStage {
+    id: string;
+    pipelineId: string;
+    position: number;
+    parserId: string;
+    parserName: string | null;
+    parserType: ParserType | null;
+    expression: string | null;
+    inputKey: string;
+    outputKey: string;
+    enabled: boolean;
+    onError: StageErrorHandling;
+    fallbackValue: unknown | null;
+    description: string | null;
+}
+/** Complete Pipeline entity */
+export interface Pipeline {
+    id: string;
+    workspaceId: string;
+    tenantId: string;
+    consoleId: string;
+    name: string;
+    description: string | null;
+    status: PipelineStatus;
+    stages: PipelineStage[];
+    lastExecutedAt: string | null;
+    version: number;
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy: string;
+}
+/** Pipeline list item (subset for list views) */
+export interface PipelineListItem {
+    id: string;
+    consoleId: string;
+    name: string;
+    description: string | null;
+    status: PipelineStatus;
+    stageCount: number;
+    lastExecutedAt: string | null;
+    updatedAt: string;
+}
+/** Result of a single stage execution */
+export interface PipelineStageResult {
+    id: string;
+    stageId: string;
+    stageName: string | null;
+    status: StageExecutionStatus;
+    executionTimeMs: number;
+    output: unknown | null;
+    error: string | null;
+}
+/** Complete pipeline execution record */
+export interface PipelineExecution {
+    id: string;
+    pipelineId: string;
+    pipelineVersion: number;
+    status: PipelineExecutionStatus;
+    startedAt: string;
+    completedAt: string | null;
+    totalExecutionTimeMs: number | null;
+    inputData: unknown | null;
+    outputData: unknown | null;
+    error: string | null;
+    executedBy: string;
+    stageResults: PipelineStageResult[];
+    createdAt: string;
+}
+/** Input for creating a pipeline stage */
+export interface CreatePipelineStageInput {
+    parserId: string;
+    parserName?: string;
+    parserType?: ParserType;
+    expression?: string;
+    inputKey: string;
+    outputKey: string;
+    enabled?: boolean;
+    onError?: StageErrorHandling;
+    fallbackValue?: unknown;
+    description?: string;
+}
+/** Input for creating a pipeline */
+export interface CreatePipelineInput {
+    consoleId: string;
+    name: string;
+    description?: string;
+    status?: PipelineStatus;
+    stages: CreatePipelineStageInput[];
+}
+/** Input for updating a pipeline stage */
+export interface UpdatePipelineStageInput {
+    id?: string;
+    parserId?: string;
+    parserName?: string;
+    parserType?: ParserType;
+    expression?: string;
+    inputKey?: string;
+    outputKey?: string;
+    enabled?: boolean;
+    onError?: StageErrorHandling;
+    fallbackValue?: unknown;
+    description?: string;
+}
+/** Input for updating a pipeline */
+export interface UpdatePipelineInput {
+    name?: string;
+    description?: string;
+    status?: PipelineStatus;
+    stages?: UpdatePipelineStageInput[];
+}
+/** Input for executing a pipeline */
+export interface ExecutePipelineInput {
+    pipelineId: string;
+    inputData?: unknown;
+}
+/** Input for testing a pipeline */
+export interface TestPipelineInput {
+    pipelineId: string;
+    inputData: unknown;
+}
+/** Pipeline connection for pagination */
+export interface PipelineConnection {
+    edges: PipelineEdge[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+export interface PipelineEdge {
+    cursor: string;
+    node: Pipeline | PipelineListItem;
+}
+/** Workflow status */
+export type FluidGridsWorkflowStatus = 'draft' | 'active' | 'paused' | 'error' | 'archived';
+/** Complete FluidGrids Workflow entity */
+export interface FluidGridsWorkflow {
+    id: string;
+    name: string;
+    key: string;
+    description: string | null;
+    externalWorkflowId: string | null;
+    webhookUrl: string | null;
+    webhookSecret: string | null;
+    config: Record<string, unknown> | null;
+    status: FluidGridsWorkflowStatus;
+    lastExecutedAt: string | null;
+    executionCount: number;
+    version: number;
+    /** Linked data sinks */
+    dataSinkLinks: DataSinkWorkflowLink[];
+    /** Count of linked data sinks */
+    linkedDataSinkCount: number;
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy: string;
+}
+/** Workflow list item (subset for list views) */
+export interface FluidGridsWorkflowListItem {
+    id: string;
+    name: string;
+    key: string;
+    description: string | null;
+    status: FluidGridsWorkflowStatus;
+    lastExecutedAt: string | null;
+    executionCount: number;
+    linkedDataSinkCount: number;
+    updatedAt: string;
+}
+/** Junction table linking DataSink and Workflow (many-to-many) */
+export interface DataSinkWorkflowLink {
+    id: string;
+    dataSinkId: string;
+    dataSink?: DataSink | DataSinkListItem;
+    workflowId: string;
+    workflow?: FluidGridsWorkflow | FluidGridsWorkflowListItem;
+    isEnabled: boolean;
+    priority: number;
+    dataMapping: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Input for creating a workflow */
+export interface CreateWorkflowInput {
+    name: string;
+    key: string;
+    description?: string;
+    config?: Record<string, unknown>;
+    /** FluidGrids workflow definition JSON (DAG nodes/edges) */
+    definitionJson?: Record<string, unknown>;
+    /** Data sink keys to link on creation */
+    dataSinkKeys?: string[];
+}
+/** Input for updating a workflow */
+export interface UpdateWorkflowInput {
+    name?: string;
+    description?: string;
+    config?: Record<string, unknown>;
+    status?: FluidGridsWorkflowStatus;
+}
+/** Input for linking a data sink to a workflow */
+export interface LinkDataSinkInput {
+    dataSinkKey: string;
+    priority?: number;
+    dataMapping?: Record<string, unknown>;
+}
+/** Input for updating a data sink link */
+export interface UpdateDataSinkLinkInput {
+    isEnabled?: boolean;
+    priority?: number;
+    dataMapping?: Record<string, unknown>;
+}
+/** Workflow connection for pagination */
+export interface FluidGridsWorkflowConnection {
+    edges: FluidGridsWorkflowEdge[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+export interface FluidGridsWorkflowEdge {
+    cursor: string;
+    node: FluidGridsWorkflow | FluidGridsWorkflowListItem;
+}
+/** Data sink update event from subscription */
+export interface DataSinkUpdateEvent {
+    type: 'created' | 'updated' | 'deleted' | 'refreshed';
+    dataSink: DataSinkListItem;
+    timestamp: string;
+    actorId: string | null;
+}
+/** Workflow update event from subscription */
+export interface WorkflowUpdateEvent {
+    type: 'created' | 'updated' | 'deleted' | 'executed';
+    workflow: FluidGridsWorkflowListItem;
+    timestamp: string;
+    userId: string | null;
+}
+export interface BatchPositionUpdate {
+    id: string;
+    position: WidgetPositionInput;
+}
+//# sourceMappingURL=index.d.ts.map