@adminforth/dashboard 1.3.0 → 1.4.1

package/dist/custom/model/dashboard.types.ts

@@ -6,18 +6,34 @@ export type DashboardConfig = {
   widgets: DashboardWidgetConfig[]
 }
 
+export type JsonValue =
+  | string
+  | number
+  | boolean
+  | null
+  | JsonValue[]
+  | { [key: string]: JsonValue }
+
+export type DashboardVariables = Record<string, JsonValue>
+
 export type DashboardGroupConfig = {
   id: string
   label: string
   order: number
 }
 
+export type EditableDashboardGroupConfig = Pick<DashboardGroupConfig, 'label'>
+
 export type DashboardGroupMoveDirection = 'up' | 'down'
 export type DashboardWidgetMoveDirection = 'up' | 'down'
 export type DashboardWidgetTarget = 'empty' | 'table' | 'chart' | 'kpi_card' | 'pivot_table' | 'gauge_card'
 export type DashboardWidgetSize = 'small' | 'medium' | 'large' | 'wide' | 'full'
+export type DashboardWidgetConfigValidationError = {
+  field: string
+  message: string
+}
 export type QueryAggregateOperation = 'sum' | 'count' | 'count_distinct' | 'avg' | 'min' | 'max' | 'median'
-export type TimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year'
+export type TimeGrain = 'day' | 'week' | 'month' | 'year'
 export type ValueFormat =
   | 'number'
   | 'compact_number'
@@ -30,8 +46,8 @@ export type ValueFormat =
 export type WidgetLayout = {
   size?: DashboardWidgetSize
   width?: number
-  minWidth?: number
-  maxWidth?: number | null
+  min_width?: number
+  max_width?: number | null
   height?: number
 }
 
@@ -39,11 +55,12 @@ export type WidgetBaseConfig = {
   id: string
   group_id: string
   label?: string
+  variables?: DashboardVariables
   size?: DashboardWidgetSize
   width?: number
   height?: number
-  minWidth?: number
-  maxWidth?: number | null
+  min_width?: number
+  max_width?: number | null
   order: number
 }
 
@@ -53,16 +70,16 @@ export type FilterExpression =
   | Array<FilterExpression>
   | {
       field: string
-      eq?: unknown
-      neq?: unknown
-      gt?: unknown
-      gte?: unknown
-      lt?: unknown
-      lte?: unknown
-      in?: unknown[]
-      not_in?: unknown[]
-      like?: unknown
-      ilike?: unknown
+      eq?: JsonValue
+      neq?: JsonValue
+      gt?: JsonValue
+      gte?: JsonValue
+      lt?: JsonValue
+      lte?: JsonValue
+      in?: JsonValue[]
+      not_in?: JsonValue[]
+      like?: JsonValue
+      ilike?: JsonValue
     }
 
 export type QueryFieldSelectItem = {
@@ -103,30 +120,31 @@ export type QueryConfig = {
   resource: string
   select?: QuerySelectItem[]
   filters?: FilterExpression
-  groupBy?: QueryGroupByItem[]
-  orderBy?: QueryOrderByItem[]
+  group_by?: QueryGroupByItem[]
+  order_by?: QueryOrderByItem[]
   limit?: number
   offset?: number
-  timeSeries?: {
+  time_series?: {
     field: string
     grain: TimeGrain
     timezone?: string
   }
   period?: {
     field: string
-    gte?: unknown
-    lt?: unknown
+    gte?: JsonValue
+    lt?: JsonValue
   }
   bucket?: {
     field: string
     buckets: Array<{ label: string, min?: number, max?: number }>
   }
   calcs?: QueryCalcSelectItem[]
-  formatting?: Record<string, unknown>
+  formatting?: Record<string, JsonValue>
 }
 
 export type FunnelQueryConfig = {
   steps: FunnelQueryStep[]
+  calcs?: QueryCalcSelectItem[]
 }
 
 export type FunnelQueryStep = {
@@ -145,7 +163,7 @@ export type FieldRef = string | {
 export type TableViewConfig = {
   columns?: FieldRef[]
   pagination?: boolean
-  pageSize?: number
+  page_size?: number
 }
 
 export type KpiCardViewConfig = {
@@ -160,8 +178,8 @@ export type KpiCardViewConfig = {
     text?: string
     field?: string
   }
-  comparison?: unknown
-  sparkline?: unknown
+  comparison?: JsonValue
+  sparkline?: JsonValue
 }
 
 export type GaugeCardViewConfig = {
@@ -178,9 +196,9 @@ export type GaugeCardViewConfig = {
     label?: string
   }
   progress?: {
-    valueField: string
-    targetValue?: number
-    targetField?: string
+    value_field: string
+    target_value?: number
+    target_field?: string
     format?: ValueFormat
   }
   color?: string
@@ -239,6 +257,14 @@ export type DashboardWidgetConfig =
   | GaugeCardWidgetConfig
   | PivotTableWidgetConfig
 
+export type EditableDashboardWidgetConfig =
+  | Omit<EmptyWidgetConfig, 'id' | 'group_id' | 'order'>
+  | Omit<TableWidgetConfig, 'id' | 'group_id' | 'order'>
+  | Omit<ChartDashboardWidgetConfig, 'id' | 'group_id' | 'order'>
+  | Omit<KpiCardWidgetConfig, 'id' | 'group_id' | 'order'>
+  | Omit<GaugeCardWidgetConfig, 'id' | 'group_id' | 'order'>
+  | Omit<PivotTableWidgetConfig, 'id' | 'group_id' | 'order'>
+
 export type DashboardWidgetTableData = {
   kind?: 'table'
   columns: string[]
@@ -266,252 +292,19 @@ export type DashboardWidgetAggregateData = {
 
 export type DashboardWidgetData = DashboardWidgetTableData | DashboardWidgetAggregateData
 
-export function normalizeDashboardConfig(config: unknown): DashboardConfig {
-  const value = isRecord(config) ? config : {}
-
-  return {
-    version: typeof value.version === 'number' ? value.version : 1,
-    groups: Array.isArray(value.groups) ? (value.groups as DashboardGroupConfig[]) : [],
-    widgets: Array.isArray(value.widgets)
-      ? value.widgets.map((widget) => normalizeDashboardWidgetConfig(widget) as DashboardWidgetConfig)
-      : [],
-  }
-}
-
-export function normalizeDashboardWidgetConfig(config: unknown) {
-  if (!isRecord(config)) {
-    return config
-  }
-
-  const normalized: Record<string, unknown> = { ...config }
-  normalizeWidgetLayoutConfig(normalized)
-
-  if (normalized.query !== undefined) {
-    normalized.query = normalizeQueryConfig(normalized.query)
-  }
-
-  if (normalized.table !== undefined) {
-    normalized.table = normalizeTableConfig(normalized.table)
-  }
-
-  if (normalized.card !== undefined) {
-    normalized.card = normalizeCardConfig(normalized.card)
-  }
-
-  if (normalized.pivot !== undefined) {
-    normalized.pivot = normalizePivotConfig(normalized.pivot)
-  }
-
-  const target = normalizeDashboardWidgetTarget(normalized.target)
-
-  if (target !== undefined) {
-    normalized.target = target
-  }
-
-  return normalized
-}
-
-export function serializeDashboardWidgetConfigForEditor(widget: DashboardWidgetConfig) {
-  const serialized: Record<string, unknown> = { ...widget }
-
-  if (Object.prototype.hasOwnProperty.call(serialized, 'minWidth')) {
-    serialized.min_width = widget.minWidth
-    delete serialized.minWidth
-  }
-
-  if (Object.prototype.hasOwnProperty.call(serialized, 'maxWidth')) {
-    serialized.max_width = widget.maxWidth
-    delete serialized.maxWidth
-  }
-
-  if ('query' in widget) {
-    serialized.query = serializeQueryConfigForEditor(widget.query)
-  }
-
-  if ('table' in widget && widget.table !== undefined) {
-    serialized.table = serializeTableConfigForEditor(widget.table)
-  }
-
-  if ('card' in widget && widget.card !== undefined) {
-    serialized.card = serializeCardConfigForEditor(widget.card)
-  }
+export function serializeDashboardWidgetConfigForEditor(
+  widget: DashboardWidgetConfig,
+): unknown {
+  const {
+    id: _id,
+    group_id: _groupId,
+    order: _order,
+    ...editableWidget
+  } = widget
 
-  if ('pivot' in widget && widget.pivot !== undefined) {
-    serialized.pivot = serializePivotConfigForEditor(widget.pivot)
-  }
-
-  return serialized
+  return editableWidget
 }
 
 export function getFieldRefField(value: FieldRef | undefined) {
   return typeof value === 'string' ? value : value?.field
 }
-
-export function getFieldRefLabel(value: FieldRef | undefined) {
-  return typeof value === 'string' ? value : value?.label
-}
-
-function normalizeDashboardWidgetTarget(value: unknown): DashboardWidgetTarget | undefined {
-  switch (value) {
-    case 'empty':
-    case 'table':
-    case 'chart':
-    case 'kpi_card':
-    case 'pivot_table':
-    case 'gauge_card':
-      return value
-    default:
-      return undefined
-  }
-}
-
-function normalizeWidgetLayoutConfig(value: Record<string, unknown>) {
-  if (value.min_width !== undefined) {
-    value.minWidth = value.min_width
-  }
-
-  if (value.max_width !== undefined) {
-    value.maxWidth = value.max_width
-  }
-}
-
-function normalizeQueryConfig(value: unknown): unknown {
-  if (!isRecord(value)) {
-    return value
-  }
-
-  if (Array.isArray(value.steps)) {
-    return {
-      steps: value.steps.map((step) => normalizeFunnelQueryStep(step)),
-    }
-  }
-
-  return {
-    ...value,
-    ...(Array.isArray(value.group_by) ? { groupBy: value.group_by } : {}),
-    ...(Array.isArray(value.order_by) ? { orderBy: value.order_by } : {}),
-    ...(value.time_series !== undefined ? { timeSeries: value.time_series } : {}),
-  }
-}
-
-function normalizeFunnelQueryStep(value: unknown) {
-  if (!isRecord(value)) {
-    return value
-  }
-
-  return {
-    ...value,
-    ...(typeof value.resource_id === 'string' ? { resource: value.resource_id } : {}),
-  }
-}
-
-function normalizeTableConfig(value: unknown) {
-  if (!isRecord(value)) {
-    return value
-  }
-
-  return {
-    ...value,
-    ...(value.page_size !== undefined ? { pageSize: value.page_size } : {}),
-  }
-}
-
-function normalizeCardConfig(value: unknown): unknown {
-  if (!isRecord(value)) {
-    return value
-  }
-
-  const normalized = { ...value }
-
-  if (isRecord(normalized.progress)) {
-    normalized.progress = {
-      ...normalized.progress,
-      ...(normalized.progress.value_field !== undefined ? { valueField: normalized.progress.value_field } : {}),
-      ...(normalized.progress.target_value !== undefined ? { targetValue: normalized.progress.target_value } : {}),
-      ...(normalized.progress.target_field !== undefined ? { targetField: normalized.progress.target_field } : {}),
-    }
-  }
-
-  if (isRecord(normalized.comparison)) {
-    normalized.comparison = {
-      ...normalized.comparison,
-      ...(normalized.comparison.positive_is_good !== undefined ? { positiveIsGood: normalized.comparison.positive_is_good } : {}),
-    }
-  }
-
-  return normalized
-}
-
-function normalizePivotConfig(value: unknown): unknown {
-  return value
-}
-
-function serializeQueryConfigForEditor(value: QueryConfig | FunnelQueryConfig) {
-  if ('steps' in value) {
-    return {
-      steps: value.steps.map((step) => ({
-        ...step,
-        resource_id: step.resource,
-        resource: undefined,
-      })).map((step) => removeUndefinedFields(step)),
-    }
-  }
-
-  return removeUndefinedFields({
-    ...value,
-    group_by: value.groupBy,
-    groupBy: undefined,
-    order_by: value.orderBy,
-    orderBy: undefined,
-    time_series: value.timeSeries,
-    timeSeries: undefined,
-  })
-}
-
-function serializeTableConfigForEditor(value: TableViewConfig) {
-  return removeUndefinedFields({
-    ...value,
-    page_size: value.pageSize,
-    pageSize: undefined,
-  })
-}
-
-function serializeCardConfigForEditor(value: KpiCardViewConfig | GaugeCardViewConfig) {
-  const serialized: Record<string, unknown> = { ...value }
-
-  if (isRecord(serialized.progress)) {
-    serialized.progress = removeUndefinedFields({
-      ...serialized.progress,
-      value_field: serialized.progress.valueField,
-      valueField: undefined,
-      target_value: serialized.progress.targetValue,
-      targetValue: undefined,
-      target_field: serialized.progress.targetField,
-      targetField: undefined,
-    })
-  }
-
-  if (isRecord(serialized.comparison)) {
-    serialized.comparison = removeUndefinedFields({
-      ...serialized.comparison,
-      positive_is_good: serialized.comparison.positiveIsGood,
-      positiveIsGood: undefined,
-    })
-  }
-
-  return removeUndefinedFields(serialized)
-}
-
-function serializePivotConfigForEditor(value: PivotTableViewConfig) {
-  return value
-}
-
-function removeUndefinedFields<T extends Record<string, unknown>>(value: T) {
-  return Object.fromEntries(
-    Object.entries(value).filter(([, item]) => item !== undefined),
-  )
-}
-
-function isRecord(value: unknown): value is Record<string, any> {
-  return typeof value === 'object' && value !== null
-}

package/dist/custom/model/dashboardTopics.d.ts

@@ -0,0 +1,2 @@
+export declare const DASHBOARD_CONFIG_UPDATED_TOPIC_PREFIX = "/opentopic/dashboard-config-updated";
+export declare function getDashboardConfigUpdatedTopic(slug: string): string;

package/dist/custom/model/dashboardTopics.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DASHBOARD_CONFIG_UPDATED_TOPIC_PREFIX = void 0;
+exports.getDashboardConfigUpdatedTopic = getDashboardConfigUpdatedTopic;
+exports.DASHBOARD_CONFIG_UPDATED_TOPIC_PREFIX = '/opentopic/dashboard-config-updated';
+function getDashboardConfigUpdatedTopic(slug) {
+    return `${exports.DASHBOARD_CONFIG_UPDATED_TOPIC_PREFIX}/${slug}`;
+}

package/dist/custom/model/dashboardTopics.ts

@@ -0,0 +1,5 @@
+export const DASHBOARD_CONFIG_UPDATED_TOPIC_PREFIX = '/opentopic/dashboard-config-updated'
+
+export function getDashboardConfigUpdatedTopic(slug: string) {
+  return `${DASHBOARD_CONFIG_UPDATED_TOPIC_PREFIX}/${slug}`
+}