@meshmakers/octo-meshboard 3.4.280 → 3.4.310

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshmakers/octo-meshboard",
-  "version": "3.4.280",
+  "version": "3.4.310",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",

package/types/meshmakers-octo-meshboard.d.ts

@@ -7,7 +7,7 @@ import { EntitySelectDialogDataSource, ColumnDefinition, DialogFetchOptions, Dia
 import { Observable, Subject } from 'rxjs';
 import { EntitySelectDataSource, EntitySelectResult } from '@meshmakers/shared-services';
 import * as _meshmakers_octo_services from '@meshmakers/octo-services';
-import { Exact, InputMaybe, Scalars, SearchFilterDto, FieldFilterDto, SortDto, CkTypeSelectorItem, RuntimeEntityItem as RuntimeEntityItem$1, RuntimeEntitySelectDataSource as RuntimeEntitySelectDataSource$1, RuntimeEntityDialogDataSource as RuntimeEntityDialogDataSource$1, QueryModeDto, AttributeItem, TenantIdProvider } from '@meshmakers/octo-services';
+import { Exact, InputMaybe, Scalars, SearchFilterDto, FieldFilterDto, SortDto, CkTypeSelectorItem, RuntimeEntityItem as RuntimeEntityItem$1, RuntimeEntitySelectDataSource as RuntimeEntitySelectDataSource$1, RuntimeEntityDialogDataSource as RuntimeEntityDialogDataSource$1, QueryModeDto, ResolveSeriesQueryInputDto, CkRollupFunctionDto, SeriesResolutionSignalDto, AttributeItem, TenantIdProvider } from '@meshmakers/octo-services';
 export { RuntimeEntityDialogDataSource, RuntimeEntityItem, RuntimeEntitySelectDataSource, TENANT_ID_PROVIDER, TenantIdProvider } from '@meshmakers/octo-services';
 import * as Apollo from 'apollo-angular';
 import { CkTypeSelectorInputComponent, AttributeValueTypeDto, FieldFilterItem, FilterVariable, PropertyGridItem, PropertyGridConfig, OctoGraphQlDataSource, FieldFilterEditorComponent } from '@meshmakers/octo-ui';
@@ -287,6 +287,19 @@ interface PersistentQueryDataSource extends WidgetDataSource {
      * queries (the archive `rtIds` override is a stream-data concept).
      */
     entitySelectorId?: string;
+    /**
+     * Resolution-aware routing (AB#4290): when `true`, a stream-data chart resolves the
+     * best archive/rollup for the visible time window + target point count via
+     * `QueryExecutorService.resolveSeriesQuery` before querying, instead of always hitting
+     * the persisted archive. Requires `sourcePath` + the series' aggregation to be known.
+     * Ignored for runtime queries. Default (absent/`false`) keeps the direct query.
+     */
+    resolutionAware?: boolean;
+    /**
+     * Optional OBIS-code filter forwarded to resolution-aware routing / the downsampling
+     * query to narrow the series (e.g. `1.8.0` active-energy import). Stream-data only.
+     */
+    obisFilter?: string;
 }
 /**
  * Aggregation types supported
@@ -2582,6 +2595,21 @@ declare class MeshBoardGridService {
 /** @deprecated Use MeshBoardGridService instead */
 declare const DashboardGridService: typeof MeshBoardGridService;
 
+/**
+ * Result of resolution-aware series routing (AB#4290). The caller runs the existing
+ * stream-data downsampling query against {@link archiveRtId} with `limit = points`
+ * and the column aggregation set to {@link reducingFunction}. `signal` is a truthful
+ * outcome the widget can surface (e.g. a "resolution-limited" hint).
+ */
+interface SeriesResolutionResult {
+    archiveRtId: string;
+    effectiveBucketMs: number;
+    points: number;
+    reducingFunction: CkRollupFunctionDto;
+    signal: SeriesResolutionSignalDto;
+    actualPoints: number | null;
+    diagnostic: string | null;
+}
 /**
  * Time-range and downsampling arguments for stream-data persistent queries.
  * Mirrors the GraphQL input `StreamDataArguments` so widgets can build it
@@ -2684,6 +2712,7 @@ declare class QueryExecutorService {
     private readonly runtimeGql;
     private readonly streamDataGql;
     private readonly persistentQueriesGql;
+    private readonly resolveSeriesGql;
     /**
      * Cache of resolved query families, keyed by query rtId. Filled lazily for
      * legacy widget configs that pre-date the `queryFamily` field — saves a
@@ -2699,6 +2728,14 @@ declare class QueryExecutorService {
     resolveFamily(queryRtId: string): Promise<QueryFamily>;
     executeRuntime(queryRtId: string, options?: QueryExecutionOptions): Observable<QueryExecutionResult>;
     executeStreamData(queryRtId: string, options?: QueryExecutionOptions): Observable<QueryExecutionResult>;
+    /**
+     * Resolution-aware series routing (AB#4290): asks the backend which archive/rollup to
+     * query for a base archive family, time window and target point count — so a widget can
+     * render ~`targetPoints` points without knowing which physical archive holds the data at a
+     * usable grain. The caller then runs {@link executeStreamData} (downsampling) against the
+     * returned `archiveRtId` with `limit = points`. Returns null when StreamData is not enabled.
+     */
+    resolveSeriesQuery(input: ResolveSeriesQueryInputDto): Promise<SeriesResolutionResult | null>;
     private buildStreamDataArg;
     private mapColumns;
     private mapRuntimeRows;
@@ -4236,6 +4273,9 @@ declare class LineChartWidgetComponent implements DashboardWidget<LineChartWidge
     hasValidConfig(): boolean;
     formatValue(value: number): string;
     getUnitForSeries(seriesName: string): string;
+    /** The downsampling min/max envelope is rendered as a separate `<name> (min/max)` rangeArea
+     *  series; it is excluded from the shared tooltip so only the actual value lines are listed. */
+    isBandSeries(seriesName: string): boolean;
     private loadData;
     private buildStreamDataArgs;
     /**
@@ -6327,4 +6367,4 @@ declare class MeshBoardManagerDialogComponent implements OnInit {
 }
 
 export { AddWidgetDialogComponent, AiInsightsConfigDialogComponent, AiInsightsService, AiInsightsWidgetComponent, AlertBannerConfigDialogComponent, AlertBannerWidgetComponent, AlertListConfigDialogComponent, AlertListWidgetComponent, AssociationsConfigDialogComponent, AutoRefreshTimerService, BarChartConfigDialogComponent, BarChartWidgetComponent, DEFAULT_TIME_ZONE_MODE, DashboardDataService, DashboardGridService, EditModeStateService, EditWidgetDialogComponent, EntityAssociationsWidgetComponent, EntityCardConfigDialogComponent, EntityCardWidgetComponent, EntityDetailDialogComponent, EntitySelectorEditorComponent, EntitySelectorToolbarComponent, GaugeConfigDialogComponent, GaugeWidgetComponent, HeatmapConfigDialogComponent, HeatmapWidgetComponent, KpiConfigDialogComponent, KpiWidgetComponent, LineChartConfigDialogComponent, LineChartWidgetComponent, MESHBOARD_OPTIONS, MESHBOARD_TENANT_ID_PROVIDER, MarkdownConfigDialogComponent, MarkdownWidgetComponent, MeshBoardDataService, MeshBoardGridService, MeshBoardManagerDialogComponent, MeshBoardPersistenceService, MeshBoardSettingsDialogComponent, MeshBoardSettingsResult, MeshBoardStateService, MeshBoardViewComponent, PieChartConfigDialogComponent, PieChartWidgetComponent, QueryExecutorService, QuerySelectorComponent, RuntimeEntitySelectorComponent, ServiceHealthConfigDialogComponent, ServiceHealthWidgetComponent, StatsGridConfigDialogComponent, StatsGridWidgetComponent, StatusIndicatorConfigDialogComponent, StatusIndicatorWidgetComponent, StatusListConfigDialogComponent, StatusListWidgetComponent, SummaryCardConfigDialogComponent, SummaryCardWidgetComponent, TableConfigDialogComponent, TableWidgetComponent, TableWidgetDataSourceDirective, WidgetFactoryService, WidgetGroupComponent, WidgetGroupConfigDialogComponent, WidgetNotConfiguredComponent, WidgetRegistryService, classifyQuery, provideDefaultWidgets, provideMeshBoard, provideProcessWidget, provideWidgetRegistrations, queryFamily, registerDefaultWidgets, registerProcessWidget };
-export type { AggregationDataSource, AggregationQuery, AggregationType, AiInsightsConfigResult, AiInsightsWidgetConfig, AlertBannerConfigResult, AlertBannerWidgetConfig, AlertListConfigResult, AlertListWidgetConfig, AnyWidgetConfig, AssociationsConfigResult, BarChartColorThreshold, BarChartConfigResult, BarChartSeries, BarChartType, BarChartWidgetConfig, BaseWidgetConfig, CategoryValueItem, ChartReferenceLine, CkQueryResult, CkQueryTarget, CkTypeAttributeInfo, ConfigDialogResult, ConfigResultApplier, ConstructionKitQueryDataSource, DashboardConfig, DashboardWidget, DataSource, DataSourceType, DiagramPropertyMapping, EntityAssociation, EntityAttribute, EntityCardConfigResult, EntityCardWidgetConfig, EntityListWidget, EntitySelectorAttributeMapping, EntitySelectorChildScope, EntitySelectorClearEvent, EntitySelectorConfig, EntitySelectorEvent, EntityWidget, EntityWithAssociationsWidgetConfig, GaugeConfigResult, GaugeRange, GaugeType, GaugeWidgetConfig, GridCell, GridPosition, GroupChildWidgetType, GroupedDataItem, HeatmapAggregation, HeatmapColorMode, HeatmapColorScheme, HeatmapConfigResult, HeatmapWidgetConfig, KpiConfigResult, KpiDataSourceType, KpiQueryMode, KpiWidgetConfig, LineChartConfigResult, LineChartType, LineChartWidgetConfig, MarkdownConfigResult, MarkdownTextAlign, MarkdownWidgetConfig, MeshBoardConfig, MeshBoardOptions, MeshBoardTimeFilterConfig, MeshBoardTimeZoneMode, MeshBoardVariable, MeshBoardVariableSource, MeshBoardVariableType, ParentAssociationMode, PersistedDashboard, PersistedMeshBoard, PersistedWidget, PersistedWidgetData, PersistentQueryCellMode, PersistentQueryCellSource, PersistentQueryDataSource, PersistentQueryItem, PieChartConfigResult, PieChartType, PieChartWidgetConfig, ProcessWidgetConfig, Quarter, QueryCell, QueryClassification, QueryColumn, QueryColumnInfo, QueryColumnItem, QueryExecutionOptions, QueryExecutionResult, QueryFamily, QueryKind, QueryResultRow, RelativeTimeUnit, RepeaterDataItem, RepeaterQueryDataSource, RuntimeEntityData, RuntimeEntityDataSource, RuntimeEntitySelectorValue, ServiceCallDataSource, ServiceCallType, ServiceHealthConfigResult, ServiceHealthWidgetConfig, StatColor, StatItem, StaticDataSource, StatsGridConfigResult, StatsGridWidgetConfig, StatusIndicatorConfigResult, StatusIndicatorWidgetConfig, StatusListConfigResult, StatusListWidgetConfig, StreamDataExecutionArgs, SummaryCardConfigResult, SummaryCardTile, SummaryCardWidgetConfig, TableColumn, TableColumnStatusIconMapping, TableConfigResult, TableFilterConfig, TableSortConfig, TableWidgetConfig, TargetEntityWithAttributes, TimeRangePickerConfig, TimeRangeSelection, TimeRangeType, UpdateDashboardResult, VariableResolutionError, WidgetConfig, WidgetConfigDialog, WidgetConfigDialogSize, WidgetConfigResult, WidgetCreationOptions, WidgetDataSource, WidgetFilterConfig, WidgetGroupAttributeMappings, WidgetGroupChildTemplate, WidgetGroupConfig, WidgetGroupConfigResult, WidgetGroupLayout, WidgetPersistenceData, WidgetPositionUpdate, WidgetRegistration, WidgetType, WidgetZone };
+export type { AggregationDataSource, AggregationQuery, AggregationType, AiInsightsConfigResult, AiInsightsWidgetConfig, AlertBannerConfigResult, AlertBannerWidgetConfig, AlertListConfigResult, AlertListWidgetConfig, AnyWidgetConfig, AssociationsConfigResult, BarChartColorThreshold, BarChartConfigResult, BarChartSeries, BarChartType, BarChartWidgetConfig, BaseWidgetConfig, CategoryValueItem, ChartReferenceLine, CkQueryResult, CkQueryTarget, CkTypeAttributeInfo, ConfigDialogResult, ConfigResultApplier, ConstructionKitQueryDataSource, DashboardConfig, DashboardWidget, DataSource, DataSourceType, DiagramPropertyMapping, EntityAssociation, EntityAttribute, EntityCardConfigResult, EntityCardWidgetConfig, EntityListWidget, EntitySelectorAttributeMapping, EntitySelectorChildScope, EntitySelectorClearEvent, EntitySelectorConfig, EntitySelectorEvent, EntityWidget, EntityWithAssociationsWidgetConfig, GaugeConfigResult, GaugeRange, GaugeType, GaugeWidgetConfig, GridCell, GridPosition, GroupChildWidgetType, GroupedDataItem, HeatmapAggregation, HeatmapColorMode, HeatmapColorScheme, HeatmapConfigResult, HeatmapWidgetConfig, KpiConfigResult, KpiDataSourceType, KpiQueryMode, KpiWidgetConfig, LineChartConfigResult, LineChartType, LineChartWidgetConfig, MarkdownConfigResult, MarkdownTextAlign, MarkdownWidgetConfig, MeshBoardConfig, MeshBoardOptions, MeshBoardTimeFilterConfig, MeshBoardTimeZoneMode, MeshBoardVariable, MeshBoardVariableSource, MeshBoardVariableType, ParentAssociationMode, PersistedDashboard, PersistedMeshBoard, PersistedWidget, PersistedWidgetData, PersistentQueryCellMode, PersistentQueryCellSource, PersistentQueryDataSource, PersistentQueryItem, PieChartConfigResult, PieChartType, PieChartWidgetConfig, ProcessWidgetConfig, Quarter, QueryCell, QueryClassification, QueryColumn, QueryColumnInfo, QueryColumnItem, QueryExecutionOptions, QueryExecutionResult, QueryFamily, QueryKind, QueryResultRow, RelativeTimeUnit, RepeaterDataItem, RepeaterQueryDataSource, RuntimeEntityData, RuntimeEntityDataSource, RuntimeEntitySelectorValue, SeriesResolutionResult, ServiceCallDataSource, ServiceCallType, ServiceHealthConfigResult, ServiceHealthWidgetConfig, StatColor, StatItem, StaticDataSource, StatsGridConfigResult, StatsGridWidgetConfig, StatusIndicatorConfigResult, StatusIndicatorWidgetConfig, StatusListConfigResult, StatusListWidgetConfig, StreamDataExecutionArgs, SummaryCardConfigResult, SummaryCardTile, SummaryCardWidgetConfig, TableColumn, TableColumnStatusIconMapping, TableConfigResult, TableFilterConfig, TableSortConfig, TableWidgetConfig, TargetEntityWithAttributes, TimeRangePickerConfig, TimeRangeSelection, TimeRangeType, UpdateDashboardResult, VariableResolutionError, WidgetConfig, WidgetConfigDialog, WidgetConfigDialogSize, WidgetConfigResult, WidgetCreationOptions, WidgetDataSource, WidgetFilterConfig, WidgetGroupAttributeMappings, WidgetGroupChildTemplate, WidgetGroupConfig, WidgetGroupConfigResult, WidgetGroupLayout, WidgetPersistenceData, WidgetPositionUpdate, WidgetRegistration, WidgetType, WidgetZone };