@open-mercato/core 0.4.2-canary-cf7d9b4116 → 0.4.2-canary-e6bf6a353e

package/dist/modules/dashboards/services/widgetDataService.js

@@ -0,0 +1,207 @@
+import { createHash } from "node:crypto";
+import {
+  resolveDateRange,
+  getPreviousPeriod,
+  calculatePercentageChange,
+  determineChangeDirection,
+  isValidDateRangePreset
+} from "@open-mercato/ui/backend/date-range";
+import {
+  buildAggregationQuery
+} from "../lib/aggregations.js";
+const WIDGET_DATA_CACHE_TTL = 12e4;
+const SAFE_IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+class WidgetDataValidationError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "WidgetDataValidationError";
+  }
+}
+function assertSafeIdentifier(value, name) {
+  if (!SAFE_IDENTIFIER_PATTERN.test(value)) {
+    throw new Error(`Invalid ${name}: ${value}`);
+  }
+}
+class WidgetDataService {
+  constructor(options) {
+    this.em = options.em;
+    this.scope = options.scope;
+    this.registry = options.registry;
+    this.cache = options.cache;
+  }
+  buildCacheKey(request) {
+    const hash = createHash("sha256");
+    hash.update(JSON.stringify({ request, scope: this.scope }));
+    return `widget-data:${hash.digest("hex").slice(0, 16)}`;
+  }
+  getCacheTags(entityType) {
+    return ["widget-data", `widget-data:${entityType}`];
+  }
+  async fetchWidgetData(request) {
+    this.validateRequest(request);
+    if (this.cache) {
+      const cacheKey = this.buildCacheKey(request);
+      try {
+        const cached = await this.cache.get(cacheKey);
+        if (cached && typeof cached === "object" && "value" in cached) {
+          return cached;
+        }
+      } catch {
+      }
+    }
+    const now = /* @__PURE__ */ new Date();
+    let dateRangeResolved;
+    let comparisonRange;
+    if (request.dateRange) {
+      dateRangeResolved = resolveDateRange(request.dateRange.preset, now);
+      if (request.comparison) {
+        comparisonRange = getPreviousPeriod(dateRangeResolved, request.dateRange.preset);
+      }
+    }
+    const mainResult = await this.executeQuery(request, dateRangeResolved);
+    let comparisonResult;
+    if (comparisonRange && request.dateRange) {
+      comparisonResult = await this.executeQuery(request, comparisonRange);
+    }
+    const response = {
+      value: mainResult.value,
+      data: mainResult.data,
+      metadata: {
+        fetchedAt: now.toISOString(),
+        recordCount: mainResult.data.length || (mainResult.value !== null ? 1 : 0)
+      }
+    };
+    if (comparisonResult && mainResult.value !== null && comparisonResult.value !== null) {
+      response.comparison = {
+        value: comparisonResult.value,
+        change: calculatePercentageChange(mainResult.value, comparisonResult.value),
+        direction: determineChangeDirection(mainResult.value, comparisonResult.value)
+      };
+    }
+    if (this.cache) {
+      const cacheKey = this.buildCacheKey(request);
+      const tags = this.getCacheTags(request.entityType);
+      try {
+        await this.cache.set(cacheKey, response, { ttl: WIDGET_DATA_CACHE_TTL, tags });
+      } catch {
+      }
+    }
+    return response;
+  }
+  validateRequest(request) {
+    if (!this.registry.isValidEntityType(request.entityType)) {
+      throw new WidgetDataValidationError(`Invalid entity type: ${request.entityType}`);
+    }
+    if (!request.metric?.field || !request.metric?.aggregate) {
+      throw new WidgetDataValidationError("Metric field and aggregate are required");
+    }
+    const metricMapping = this.registry.getFieldMapping(request.entityType, request.metric.field);
+    if (!metricMapping) {
+      throw new WidgetDataValidationError(
+        `Invalid metric field: ${request.metric.field} for entity type: ${request.entityType}`
+      );
+    }
+    const validAggregates = ["count", "sum", "avg", "min", "max"];
+    if (!validAggregates.includes(request.metric.aggregate)) {
+      throw new WidgetDataValidationError(`Invalid aggregate function: ${request.metric.aggregate}`);
+    }
+    if (request.dateRange && !isValidDateRangePreset(request.dateRange.preset)) {
+      throw new WidgetDataValidationError(`Invalid date range preset: ${request.dateRange.preset}`);
+    }
+    if (request.groupBy) {
+      const groupMapping = this.registry.getFieldMapping(request.entityType, request.groupBy.field);
+      if (!groupMapping) {
+        const [baseField] = request.groupBy.field.split(".");
+        const baseMapping = this.registry.getFieldMapping(request.entityType, baseField);
+        if (!baseMapping || baseMapping.type !== "jsonb") {
+          throw new WidgetDataValidationError(`Invalid groupBy field: ${request.groupBy.field}`);
+        }
+      }
+    }
+  }
+  async executeQuery(request, dateRange) {
+    const query = buildAggregationQuery({
+      entityType: request.entityType,
+      metric: request.metric,
+      groupBy: request.groupBy,
+      dateRange: dateRange && request.dateRange ? { field: request.dateRange.field, ...dateRange } : void 0,
+      filters: request.filters,
+      scope: this.scope,
+      registry: this.registry
+    });
+    if (!query) {
+      throw new Error("Failed to build aggregation query");
+    }
+    const rows = await this.em.getConnection().execute(query.sql, query.params);
+    const results = Array.isArray(rows) ? rows : [];
+    if (request.groupBy) {
+      let data = results.map((row) => ({
+        groupKey: row.group_key,
+        value: row.value !== null ? Number(row.value) : null
+      }));
+      if (request.groupBy.resolveLabels) {
+        data = await this.resolveGroupLabels(data, request.entityType, request.groupBy.field);
+      }
+      const totalValue = data.reduce((sum, item) => sum + (item.value ?? 0), 0);
+      return { value: totalValue, data };
+    }
+    const singleValue = results[0]?.value !== void 0 ? Number(results[0].value) : null;
+    return { value: singleValue, data: [] };
+  }
+  async resolveGroupLabels(data, entityType, groupByField) {
+    const config = this.registry.getLabelResolverConfig(entityType, groupByField);
+    if (!config) {
+      return data.map((item) => ({
+        ...item,
+        groupLabel: item.groupKey != null && item.groupKey !== "" ? String(item.groupKey) : void 0
+      }));
+    }
+    const ids = data.map((item) => item.groupKey).filter((id) => {
+      if (typeof id !== "string" || id.length === 0) return false;
+      return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id);
+    });
+    if (ids.length === 0) {
+      return data.map((item) => ({ ...item, groupLabel: void 0 }));
+    }
+    const uniqueIds = [...new Set(ids)];
+    assertSafeIdentifier(config.table, "table name");
+    assertSafeIdentifier(config.idColumn, "id column");
+    assertSafeIdentifier(config.labelColumn, "label column");
+    const clauses = [`"${config.idColumn}" = ANY(?::uuid[])`, "tenant_id = ?"];
+    const params = [`{${uniqueIds.join(",")}}`, this.scope.tenantId];
+    if (this.scope.organizationIds && this.scope.organizationIds.length > 0) {
+      clauses.push("organization_id = ANY(?::uuid[])");
+      params.push(`{${this.scope.organizationIds.join(",")}}`);
+    }
+    const sql = `SELECT "${config.idColumn}" as id, "${config.labelColumn}" as label FROM "${config.table}" WHERE ${clauses.join(
+      " AND "
+    )}`;
+    try {
+      const labelRows = await this.em.getConnection().execute(sql, params);
+      const labelMap = /* @__PURE__ */ new Map();
+      for (const row of labelRows) {
+        if (row.id && row.label != null && row.label !== "") {
+          labelMap.set(row.id, row.label);
+        }
+      }
+      return data.map((item) => ({
+        ...item,
+        groupLabel: typeof item.groupKey === "string" && labelMap.has(item.groupKey) ? labelMap.get(item.groupKey) : void 0
+      }));
+    } catch {
+      return data.map((item) => ({
+        ...item,
+        groupLabel: void 0
+      }));
+    }
+  }
+}
+function createWidgetDataService(em, scope, registry, cache) {
+  return new WidgetDataService({ em, scope, registry, cache });
+}
+export {
+  WidgetDataService,
+  WidgetDataValidationError,
+  createWidgetDataService
+};
+//# sourceMappingURL=widgetDataService.js.map

package/dist/modules/dashboards/services/widgetDataService.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/dashboards/services/widgetDataService.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { CacheStrategy } from '@open-mercato/cache'\nimport { createHash } from 'node:crypto'\nimport {\n  type DateRangePreset,\n  resolveDateRange,\n  getPreviousPeriod,\n  calculatePercentageChange,\n  determineChangeDirection,\n  isValidDateRangePreset,\n} from '@open-mercato/ui/backend/date-range'\nimport {\n  type AggregateFunction,\n  type DateGranularity,\n  buildAggregationQuery,\n} from '../lib/aggregations'\nimport type { AnalyticsRegistry } from './analyticsRegistry'\n\nconst WIDGET_DATA_CACHE_TTL = 120_000\n\nconst SAFE_IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/\n\nexport class WidgetDataValidationError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'WidgetDataValidationError'\n  }\n}\n\nfunction assertSafeIdentifier(value: string, name: string): void {\n  if (!SAFE_IDENTIFIER_PATTERN.test(value)) {\n    throw new Error(`Invalid ${name}: ${value}`)\n  }\n}\n\nexport type WidgetDataRequest = {\n  entityType: string\n  metric: {\n    field: string\n    aggregate: AggregateFunction\n  }\n  groupBy?: {\n    field: string\n    granularity?: DateGranularity\n    limit?: number\n    resolveLabels?: boolean\n  }\n  filters?: Array<{\n    field: string\n    operator: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'not_in' | 'is_null' | 'is_not_null'\n    value?: unknown\n  }>\n  dateRange?: {\n    field: string\n    preset: DateRangePreset\n  }\n  comparison?: {\n    type: 'previous_period' | 'previous_year'\n  }\n}\n\nexport type WidgetDataItem = {\n  groupKey: unknown\n  groupLabel?: string\n  value: number | null\n}\n\nexport type WidgetDataResponse = {\n  value: number | null\n  data: WidgetDataItem[]\n  comparison?: {\n    value: number | null\n    change: number\n    direction: 'up' | 'down' | 'unchanged'\n  }\n  metadata: {\n    fetchedAt: string\n    recordCount: number\n  }\n}\n\nexport type WidgetDataScope = {\n  tenantId: string\n  organizationIds?: string[]\n}\n\nexport type WidgetDataServiceOptions = {\n  em: EntityManager\n  scope: WidgetDataScope\n  registry: AnalyticsRegistry\n  cache?: CacheStrategy\n}\n\nexport class WidgetDataService {\n  private em: EntityManager\n  private scope: WidgetDataScope\n  private registry: AnalyticsRegistry\n  private cache?: CacheStrategy\n\n  constructor(options: WidgetDataServiceOptions) {\n    this.em = options.em\n    this.scope = options.scope\n    this.registry = options.registry\n    this.cache = options.cache\n  }\n\n  private buildCacheKey(request: WidgetDataRequest): string {\n    const hash = createHash('sha256')\n    hash.update(JSON.stringify({ request, scope: this.scope }))\n    return `widget-data:${hash.digest('hex').slice(0, 16)}`\n  }\n\n  private getCacheTags(entityType: string): string[] {\n    return ['widget-data', `widget-data:${entityType}`]\n  }\n\n  async fetchWidgetData(request: WidgetDataRequest): Promise<WidgetDataResponse> {\n    this.validateRequest(request)\n\n    if (this.cache) {\n      const cacheKey = this.buildCacheKey(request)\n      try {\n        const cached = await this.cache.get(cacheKey)\n        if (cached && typeof cached === 'object' && 'value' in (cached as object)) {\n          return cached as WidgetDataResponse\n        }\n      } catch {\n      }\n    }\n\n    const now = new Date()\n    let dateRangeResolved: { start: Date; end: Date } | undefined\n    let comparisonRange: { start: Date; end: Date } | undefined\n\n    if (request.dateRange) {\n      dateRangeResolved = resolveDateRange(request.dateRange.preset, now)\n      if (request.comparison) {\n        comparisonRange = getPreviousPeriod(dateRangeResolved, request.dateRange.preset)\n      }\n    }\n\n    const mainResult = await this.executeQuery(request, dateRangeResolved)\n\n    let comparisonResult: { value: number | null; data: WidgetDataItem[] } | undefined\n    if (comparisonRange && request.dateRange) {\n      comparisonResult = await this.executeQuery(request, comparisonRange)\n    }\n\n    const response: WidgetDataResponse = {\n      value: mainResult.value,\n      data: mainResult.data,\n      metadata: {\n        fetchedAt: now.toISOString(),\n        recordCount: mainResult.data.length || (mainResult.value !== null ? 1 : 0),\n      },\n    }\n\n    if (comparisonResult && mainResult.value !== null && comparisonResult.value !== null) {\n      response.comparison = {\n        value: comparisonResult.value,\n        change: calculatePercentageChange(mainResult.value, comparisonResult.value),\n        direction: determineChangeDirection(mainResult.value, comparisonResult.value),\n      }\n    }\n\n    if (this.cache) {\n      const cacheKey = this.buildCacheKey(request)\n      const tags = this.getCacheTags(request.entityType)\n      try {\n        await this.cache.set(cacheKey, response, { ttl: WIDGET_DATA_CACHE_TTL, tags })\n      } catch {\n      }\n    }\n\n    return response\n  }\n\n  private validateRequest(request: WidgetDataRequest): void {\n    if (!this.registry.isValidEntityType(request.entityType)) {\n      throw new WidgetDataValidationError(`Invalid entity type: ${request.entityType}`)\n    }\n\n    if (!request.metric?.field || !request.metric?.aggregate) {\n      throw new WidgetDataValidationError('Metric field and aggregate are required')\n    }\n\n    const metricMapping = this.registry.getFieldMapping(request.entityType, request.metric.field)\n    if (!metricMapping) {\n      throw new WidgetDataValidationError(\n        `Invalid metric field: ${request.metric.field} for entity type: ${request.entityType}`\n      )\n    }\n\n    const validAggregates: AggregateFunction[] = ['count', 'sum', 'avg', 'min', 'max']\n    if (!validAggregates.includes(request.metric.aggregate)) {\n      throw new WidgetDataValidationError(`Invalid aggregate function: ${request.metric.aggregate}`)\n    }\n\n    if (request.dateRange && !isValidDateRangePreset(request.dateRange.preset)) {\n      throw new WidgetDataValidationError(`Invalid date range preset: ${request.dateRange.preset}`)\n    }\n\n    if (request.groupBy) {\n      const groupMapping = this.registry.getFieldMapping(request.entityType, request.groupBy.field)\n      if (!groupMapping) {\n        const [baseField] = request.groupBy.field.split('.')\n        const baseMapping = this.registry.getFieldMapping(request.entityType, baseField)\n        if (!baseMapping || baseMapping.type !== 'jsonb') {\n          throw new WidgetDataValidationError(`Invalid groupBy field: ${request.groupBy.field}`)\n        }\n      }\n    }\n  }\n\n  private async executeQuery(\n    request: WidgetDataRequest,\n    dateRange?: { start: Date; end: Date },\n  ): Promise<{ value: number | null; data: WidgetDataItem[] }> {\n    const query = buildAggregationQuery({\n      entityType: request.entityType,\n      metric: request.metric,\n      groupBy: request.groupBy,\n      dateRange: dateRange && request.dateRange ? { field: request.dateRange.field, ...dateRange } : undefined,\n      filters: request.filters,\n      scope: this.scope,\n      registry: this.registry,\n    })\n\n    if (!query) {\n      throw new Error('Failed to build aggregation query')\n    }\n\n    const rows = await this.em.getConnection().execute(query.sql, query.params)\n    const results = Array.isArray(rows) ? rows : []\n\n    if (request.groupBy) {\n      let data: WidgetDataItem[] = results.map((row: Record<string, unknown>) => ({\n        groupKey: row.group_key,\n        value: row.value !== null ? Number(row.value) : null,\n      }))\n\n      if (request.groupBy.resolveLabels) {\n        data = await this.resolveGroupLabels(data, request.entityType, request.groupBy.field)\n      }\n\n      const totalValue = data.reduce((sum: number, item: WidgetDataItem) => sum + (item.value ?? 0), 0)\n      return { value: totalValue, data }\n    }\n\n    const singleValue = results[0]?.value !== undefined ? Number(results[0].value) : null\n    return { value: singleValue, data: [] }\n  }\n\n  private async resolveGroupLabels(\n    data: WidgetDataItem[],\n    entityType: string,\n    groupByField: string,\n  ): Promise<WidgetDataItem[]> {\n    const config = this.registry.getLabelResolverConfig(entityType, groupByField)\n\n    if (!config) {\n      return data.map((item) => ({\n        ...item,\n        groupLabel: item.groupKey != null && item.groupKey !== '' ? String(item.groupKey) : undefined,\n      }))\n    }\n\n    const ids = data\n      .map((item) => item.groupKey)\n      .filter((id): id is string => {\n        if (typeof id !== 'string' || id.length === 0) return false\n        return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)\n      })\n\n    if (ids.length === 0) {\n      return data.map((item) => ({ ...item, groupLabel: undefined }))\n    }\n\n    const uniqueIds = [...new Set(ids)]\n\n    assertSafeIdentifier(config.table, 'table name')\n    assertSafeIdentifier(config.idColumn, 'id column')\n    assertSafeIdentifier(config.labelColumn, 'label column')\n\n    const clauses = [`\"${config.idColumn}\" = ANY(?::uuid[])`, 'tenant_id = ?']\n    const params: unknown[] = [`{${uniqueIds.join(',')}}`, this.scope.tenantId]\n\n    if (this.scope.organizationIds && this.scope.organizationIds.length > 0) {\n      clauses.push('organization_id = ANY(?::uuid[])')\n      params.push(`{${this.scope.organizationIds.join(',')}}`)\n    }\n\n    const sql = `SELECT \"${config.idColumn}\" as id, \"${config.labelColumn}\" as label FROM \"${config.table}\" WHERE ${clauses.join(\n      ' AND ',\n    )}`\n\n    try {\n      const labelRows = await this.em.getConnection().execute(sql, params)\n\n      const labelMap = new Map<string, string>()\n      for (const row of labelRows as Array<{ id: string; label: string | null }>) {\n        if (row.id && row.label != null && row.label !== '') {\n          labelMap.set(row.id, row.label)\n        }\n      }\n\n      return data.map((item) => ({\n        ...item,\n        groupLabel: typeof item.groupKey === 'string' && labelMap.has(item.groupKey)\n          ? labelMap.get(item.groupKey)!\n          : undefined,\n      }))\n    } catch {\n      return data.map((item) => ({\n        ...item,\n        groupLabel: undefined,\n      }))\n    }\n  }\n}\n\nexport function createWidgetDataService(\n  em: EntityManager,\n  scope: WidgetDataScope,\n  registry: AnalyticsRegistry,\n  cache?: CacheStrategy,\n): WidgetDataService {\n  return new WidgetDataService({ em, scope, registry, cache })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/dashboards/widgets/dashboard/aov-kpi/config.js

@@ -0,0 +1,18 @@
+import { isValidDateRangePreset } from "@open-mercato/ui/backend/date-range";
+const DEFAULT_SETTINGS = {
+  dateRange: "this_month",
+  showComparison: true
+};
+function hydrateSettings(raw) {
+  if (!raw || typeof raw !== "object") return { ...DEFAULT_SETTINGS };
+  const obj = raw;
+  return {
+    dateRange: isValidDateRangePreset(obj.dateRange) ? obj.dateRange : DEFAULT_SETTINGS.dateRange,
+    showComparison: typeof obj.showComparison === "boolean" ? obj.showComparison : DEFAULT_SETTINGS.showComparison
+  };
+}
+export {
+  DEFAULT_SETTINGS,
+  hydrateSettings
+};
+//# sourceMappingURL=config.js.map

package/dist/modules/dashboards/widgets/dashboard/aov-kpi/config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/dashboards/widgets/dashboard/aov-kpi/config.ts"],
+  "sourcesContent": ["import { type DateRangePreset, isValidDateRangePreset } from '@open-mercato/ui/backend/date-range'\n\nexport type AovKpiSettings = {\n  dateRange: DateRangePreset\n  showComparison: boolean\n}\n\nexport const DEFAULT_SETTINGS: AovKpiSettings = {\n  dateRange: 'this_month',\n  showComparison: true,\n}\n\nexport function hydrateSettings(raw: unknown): AovKpiSettings {\n  if (!raw || typeof raw !== 'object') return { ...DEFAULT_SETTINGS }\n  const obj = raw as Record<string, unknown>\n  return {\n    dateRange: isValidDateRangePreset(obj.dateRange) ? obj.dateRange : DEFAULT_SETTINGS.dateRange,\n    showComparison: typeof obj.showComparison === 'boolean' ? obj.showComparison : DEFAULT_SETTINGS.showComparison,\n  }\n}\n"],
+  "mappings": "AAAA,SAA+B,8BAA8B;AAOtD,MAAM,mBAAmC;AAAA,EAC9C,WAAW;AAAA,EACX,gBAAgB;AAClB;AAEO,SAAS,gBAAgB,KAA8B;AAC5D,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO,EAAE,GAAG,iBAAiB;AAClE,QAAM,MAAM;AACZ,SAAO;AAAA,IACL,WAAW,uBAAuB,IAAI,SAAS,IAAI,IAAI,YAAY,iBAAiB;AAAA,IACpF,gBAAgB,OAAO,IAAI,mBAAmB,YAAY,IAAI,iBAAiB,iBAAiB;AAAA,EAClG;AACF;",
+  "names": []
+}

package/dist/modules/dashboards/widgets/dashboard/aov-kpi/widget.client.js

@@ -0,0 +1,128 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { apiCall } from "@open-mercato/ui/backend/utils/apiCall";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { KpiCard } from "@open-mercato/ui/backend/charts";
+import {
+  DateRangeSelect,
+  InlineDateRangeSelect,
+  getComparisonLabelKey
+} from "@open-mercato/ui/backend/date-range";
+import { DEFAULT_SETTINGS, hydrateSettings } from "./config.js";
+import { formatCurrencyWithDecimals } from "../../../lib/formatters.js";
+async function fetchAovData(settings) {
+  const body = {
+    entityType: "sales:orders",
+    metric: {
+      field: "grandTotalGrossAmount",
+      aggregate: "avg"
+    },
+    dateRange: {
+      field: "placedAt",
+      preset: settings.dateRange
+    },
+    comparison: settings.showComparison ? { type: "previous_period" } : void 0
+  };
+  const call = await apiCall("/api/dashboards/widgets/data", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!call.ok) {
+    const errorMsg = call.result?.error;
+    throw new Error(typeof errorMsg === "string" ? errorMsg : "Failed to fetch AOV data");
+  }
+  return call.result;
+}
+const AovKpiWidget = ({
+  mode,
+  settings = DEFAULT_SETTINGS,
+  onSettingsChange,
+  refreshToken,
+  onRefreshStateChange
+}) => {
+  const t = useT();
+  const hydrated = React.useMemo(() => hydrateSettings(settings), [settings]);
+  const [value, setValue] = React.useState(null);
+  const [trend, setTrend] = React.useState(void 0);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const refresh = React.useCallback(async () => {
+    onRefreshStateChange?.(true);
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await fetchAovData(hydrated);
+      setValue(data.value);
+      if (data.comparison) {
+        setTrend({
+          value: data.comparison.change,
+          direction: data.comparison.direction
+        });
+      } else {
+        setTrend(void 0);
+      }
+    } catch (err) {
+      console.error("Failed to load AOV KPI data", err);
+      setError(t("dashboards.analytics.widgets.aovKpi.error", "Failed to load data"));
+    } finally {
+      setLoading(false);
+      onRefreshStateChange?.(false);
+    }
+  }, [hydrated, onRefreshStateChange, t]);
+  React.useEffect(() => {
+    refresh().catch(() => {
+    });
+  }, [refresh, refreshToken]);
+  if (mode === "settings") {
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-4 text-sm", children: [
+      /* @__PURE__ */ jsx(
+        DateRangeSelect,
+        {
+          id: "aov-kpi-date-range",
+          label: t("dashboards.analytics.settings.dateRange", "Date Range"),
+          value: hydrated.dateRange,
+          onChange: (dateRange) => onSettingsChange({ ...hydrated, dateRange })
+        }
+      ),
+      /* @__PURE__ */ jsx("div", { className: "space-y-1.5", children: /* @__PURE__ */ jsxs("label", { className: "flex items-center gap-2 text-sm", children: [
+        /* @__PURE__ */ jsx(
+          "input",
+          {
+            type: "checkbox",
+            checked: hydrated.showComparison,
+            onChange: (e) => onSettingsChange({ ...hydrated, showComparison: e.target.checked }),
+            className: "h-4 w-4 rounded border focus:ring-primary"
+          }
+        ),
+        t("dashboards.analytics.settings.showComparison", "Show comparison")
+      ] }) })
+    ] });
+  }
+  const comparisonLabelInfo = getComparisonLabelKey(hydrated.dateRange);
+  const comparisonLabel = hydrated.showComparison ? t(comparisonLabelInfo.key, comparisonLabelInfo.fallback) : void 0;
+  return /* @__PURE__ */ jsx(
+    KpiCard,
+    {
+      value,
+      trend,
+      comparisonLabel,
+      loading,
+      error,
+      formatValue: formatCurrencyWithDecimals,
+      headerAction: /* @__PURE__ */ jsx(
+        InlineDateRangeSelect,
+        {
+          value: hydrated.dateRange,
+          onChange: (dateRange) => onSettingsChange({ ...hydrated, dateRange })
+        }
+      )
+    }
+  );
+};
+var widget_client_default = AovKpiWidget;
+export {
+  widget_client_default as default
+};
+//# sourceMappingURL=widget.client.js.map

package/dist/modules/dashboards/widgets/dashboard/aov-kpi/widget.client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/dashboards/widgets/dashboard/aov-kpi/widget.client.tsx"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport type { DashboardWidgetComponentProps } from '@open-mercato/shared/modules/dashboard/widgets'\nimport { apiCall } from '@open-mercato/ui/backend/utils/apiCall'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { KpiCard, type KpiTrend } from '@open-mercato/ui/backend/charts'\nimport {\n  DateRangeSelect,\n  InlineDateRangeSelect,\n  type DateRangePreset,\n  getComparisonLabelKey,\n} from '@open-mercato/ui/backend/date-range'\nimport { DEFAULT_SETTINGS, hydrateSettings, type AovKpiSettings } from './config'\nimport type { WidgetDataResponse } from '../../../services/widgetDataService'\nimport { formatCurrencyWithDecimals } from '../../../lib/formatters'\n\nasync function fetchAovData(settings: AovKpiSettings): Promise<WidgetDataResponse> {\n  const body = {\n    entityType: 'sales:orders',\n    metric: {\n      field: 'grandTotalGrossAmount',\n      aggregate: 'avg',\n    },\n    dateRange: {\n      field: 'placedAt',\n      preset: settings.dateRange,\n    },\n    comparison: settings.showComparison ? { type: 'previous_period' } : undefined,\n  }\n\n  const call = await apiCall<WidgetDataResponse>('/api/dashboards/widgets/data', {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n  })\n\n  if (!call.ok) {\n    const errorMsg = (call.result as Record<string, unknown>)?.error\n    throw new Error(typeof errorMsg === 'string' ? errorMsg : 'Failed to fetch AOV data')\n  }\n\n  return call.result as WidgetDataResponse\n}\n\nconst AovKpiWidget: React.FC<DashboardWidgetComponentProps<AovKpiSettings>> = ({\n  mode,\n  settings = DEFAULT_SETTINGS,\n  onSettingsChange,\n  refreshToken,\n  onRefreshStateChange,\n}) => {\n  const t = useT()\n  const hydrated = React.useMemo(() => hydrateSettings(settings), [settings])\n  const [value, setValue] = React.useState<number | null>(null)\n  const [trend, setTrend] = React.useState<KpiTrend | undefined>(undefined)\n  const [loading, setLoading] = React.useState(true)\n  const [error, setError] = React.useState<string | null>(null)\n\n  const refresh = React.useCallback(async () => {\n    onRefreshStateChange?.(true)\n    setLoading(true)\n    setError(null)\n    try {\n      const data = await fetchAovData(hydrated)\n      setValue(data.value)\n      if (data.comparison) {\n        setTrend({\n          value: data.comparison.change,\n          direction: data.comparison.direction,\n        })\n      } else {\n        setTrend(undefined)\n      }\n    } catch (err) {\n      console.error('Failed to load AOV KPI data', err)\n      setError(t('dashboards.analytics.widgets.aovKpi.error', 'Failed to load data'))\n    } finally {\n      setLoading(false)\n      onRefreshStateChange?.(false)\n    }\n  }, [hydrated, onRefreshStateChange, t])\n\n  React.useEffect(() => {\n    refresh().catch(() => {})\n  }, [refresh, refreshToken])\n\n  if (mode === 'settings') {\n    return (\n      <div className=\"space-y-4 text-sm\">\n        <DateRangeSelect\n          id=\"aov-kpi-date-range\"\n          label={t('dashboards.analytics.settings.dateRange', 'Date Range')}\n          value={hydrated.dateRange}\n          onChange={(dateRange: DateRangePreset) => onSettingsChange({ ...hydrated, dateRange })}\n        />\n        <div className=\"space-y-1.5\">\n          <label className=\"flex items-center gap-2 text-sm\">\n            <input\n              type=\"checkbox\"\n              checked={hydrated.showComparison}\n              onChange={(e) => onSettingsChange({ ...hydrated, showComparison: e.target.checked })}\n              className=\"h-4 w-4 rounded border focus:ring-primary\"\n            />\n            {t('dashboards.analytics.settings.showComparison', 'Show comparison')}\n          </label>\n        </div>\n      </div>\n    )\n  }\n\n  const comparisonLabelInfo = getComparisonLabelKey(hydrated.dateRange)\n  const comparisonLabel = hydrated.showComparison\n    ? t(comparisonLabelInfo.key, comparisonLabelInfo.fallback)\n    : undefined\n\n  return (\n    <KpiCard\n      value={value}\n      trend={trend}\n      comparisonLabel={comparisonLabel}\n      loading={loading}\n      error={error}\n      formatValue={formatCurrencyWithDecimals}\n      headerAction={\n        <InlineDateRangeSelect\n          value={hydrated.dateRange}\n          onChange={(dateRange) => onSettingsChange({ ...hydrated, dateRange })}\n        />\n      }\n    />\n  )\n}\n\nexport default AovKpiWidget\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/dashboards/widgets/dashboard/aov-kpi/widget.js

@@ -0,0 +1,25 @@
+import AovKpiWidget from "./widget.client.js";
+import { DEFAULT_SETTINGS, hydrateSettings } from "./config.js";
+const widget = {
+  metadata: {
+    id: "dashboards.analytics.aovKpi",
+    title: "Average Order Value",
+    description: "Average order value with period comparison",
+    features: ["analytics.view", "sales.orders.view"],
+    defaultSize: "sm",
+    defaultEnabled: false,
+    defaultSettings: DEFAULT_SETTINGS,
+    tags: ["analytics", "sales", "kpi"],
+    category: "analytics",
+    icon: "trending-up",
+    supportsRefresh: true
+  },
+  Widget: AovKpiWidget,
+  hydrateSettings,
+  dehydrateSettings: (s) => ({ dateRange: s.dateRange, showComparison: s.showComparison })
+};
+var widget_default = widget;
+export {
+  widget_default as default
+};
+//# sourceMappingURL=widget.js.map

package/dist/modules/dashboards/widgets/dashboard/aov-kpi/widget.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/dashboards/widgets/dashboard/aov-kpi/widget.ts"],
+  "sourcesContent": ["import type { DashboardWidgetModule } from '@open-mercato/shared/modules/dashboard/widgets'\nimport AovKpiWidget from './widget.client'\nimport { DEFAULT_SETTINGS, hydrateSettings, type AovKpiSettings } from './config'\n\nconst widget: DashboardWidgetModule<AovKpiSettings> = {\n  metadata: {\n    id: 'dashboards.analytics.aovKpi',\n    title: 'Average Order Value',\n    description: 'Average order value with period comparison',\n    features: ['analytics.view', 'sales.orders.view'],\n    defaultSize: 'sm',\n    defaultEnabled: false,\n    defaultSettings: DEFAULT_SETTINGS,\n    tags: ['analytics', 'sales', 'kpi'],\n    category: 'analytics',\n    icon: 'trending-up',\n    supportsRefresh: true,\n  },\n  Widget: AovKpiWidget,\n  hydrateSettings,\n  dehydrateSettings: (s) => ({ dateRange: s.dateRange, showComparison: s.showComparison }),\n}\n\nexport default widget\n"],
+  "mappings": "AACA,OAAO,kBAAkB;AACzB,SAAS,kBAAkB,uBAA4C;AAEvE,MAAM,SAAgD;AAAA,EACpD,UAAU;AAAA,IACR,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU,CAAC,kBAAkB,mBAAmB;AAAA,IAChD,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,MAAM,CAAC,aAAa,SAAS,KAAK;AAAA,IAClC,UAAU;AAAA,IACV,MAAM;AAAA,IACN,iBAAiB;AAAA,EACnB;AAAA,EACA,QAAQ;AAAA,EACR;AAAA,EACA,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,gBAAgB,EAAE,eAAe;AACxF;AAEA,IAAO,iBAAQ;",
+  "names": []
+}

package/dist/modules/dashboards/widgets/dashboard/new-customers-kpi/config.js

@@ -0,0 +1,18 @@
+import { isValidDateRangePreset } from "@open-mercato/ui/backend/date-range";
+const DEFAULT_SETTINGS = {
+  dateRange: "this_month",
+  showComparison: true
+};
+function hydrateSettings(raw) {
+  if (!raw || typeof raw !== "object") return { ...DEFAULT_SETTINGS };
+  const obj = raw;
+  return {
+    dateRange: isValidDateRangePreset(obj.dateRange) ? obj.dateRange : DEFAULT_SETTINGS.dateRange,
+    showComparison: typeof obj.showComparison === "boolean" ? obj.showComparison : DEFAULT_SETTINGS.showComparison
+  };
+}
+export {
+  DEFAULT_SETTINGS,
+  hydrateSettings
+};
+//# sourceMappingURL=config.js.map

package/dist/modules/dashboards/widgets/dashboard/new-customers-kpi/config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/dashboards/widgets/dashboard/new-customers-kpi/config.ts"],
+  "sourcesContent": ["import { type DateRangePreset, isValidDateRangePreset } from '@open-mercato/ui/backend/date-range'\n\nexport type NewCustomersKpiSettings = {\n  dateRange: DateRangePreset\n  showComparison: boolean\n}\n\nexport const DEFAULT_SETTINGS: NewCustomersKpiSettings = {\n  dateRange: 'this_month',\n  showComparison: true,\n}\n\nexport function hydrateSettings(raw: unknown): NewCustomersKpiSettings {\n  if (!raw || typeof raw !== 'object') return { ...DEFAULT_SETTINGS }\n  const obj = raw as Record<string, unknown>\n  return {\n    dateRange: isValidDateRangePreset(obj.dateRange) ? obj.dateRange : DEFAULT_SETTINGS.dateRange,\n    showComparison: typeof obj.showComparison === 'boolean' ? obj.showComparison : DEFAULT_SETTINGS.showComparison,\n  }\n}\n"],
+  "mappings": "AAAA,SAA+B,8BAA8B;AAOtD,MAAM,mBAA4C;AAAA,EACvD,WAAW;AAAA,EACX,gBAAgB;AAClB;AAEO,SAAS,gBAAgB,KAAuC;AACrE,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO,EAAE,GAAG,iBAAiB;AAClE,QAAM,MAAM;AACZ,SAAO;AAAA,IACL,WAAW,uBAAuB,IAAI,SAAS,IAAI,IAAI,YAAY,iBAAiB;AAAA,IACpF,gBAAgB,OAAO,IAAI,mBAAmB,YAAY,IAAI,iBAAiB,iBAAiB;AAAA,EAClG;AACF;",
+  "names": []
+}

package/dist/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.client.js

@@ -0,0 +1,126 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { apiCall } from "@open-mercato/ui/backend/utils/apiCall";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { KpiCard } from "@open-mercato/ui/backend/charts";
+import {
+  DateRangeSelect,
+  InlineDateRangeSelect,
+  getComparisonLabelKey
+} from "@open-mercato/ui/backend/date-range";
+import { DEFAULT_SETTINGS, hydrateSettings } from "./config.js";
+async function fetchNewCustomersData(settings) {
+  const body = {
+    entityType: "customers:entities",
+    metric: {
+      field: "id",
+      aggregate: "count"
+    },
+    dateRange: {
+      field: "createdAt",
+      preset: settings.dateRange
+    },
+    comparison: settings.showComparison ? { type: "previous_period" } : void 0
+  };
+  const call = await apiCall("/api/dashboards/widgets/data", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!call.ok) {
+    const errorMsg = call.result?.error;
+    throw new Error(typeof errorMsg === "string" ? errorMsg : "Failed to fetch new customers data");
+  }
+  return call.result;
+}
+const NewCustomersKpiWidget = ({
+  mode,
+  settings = DEFAULT_SETTINGS,
+  onSettingsChange,
+  refreshToken,
+  onRefreshStateChange
+}) => {
+  const t = useT();
+  const hydrated = React.useMemo(() => hydrateSettings(settings), [settings]);
+  const [value, setValue] = React.useState(null);
+  const [trend, setTrend] = React.useState(void 0);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const refresh = React.useCallback(async () => {
+    onRefreshStateChange?.(true);
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await fetchNewCustomersData(hydrated);
+      setValue(data.value);
+      if (data.comparison) {
+        setTrend({
+          value: data.comparison.change,
+          direction: data.comparison.direction
+        });
+      } else {
+        setTrend(void 0);
+      }
+    } catch (err) {
+      console.error("Failed to load new customers KPI data", err);
+      setError(t("dashboards.analytics.widgets.newCustomersKpi.error", "Failed to load data"));
+    } finally {
+      setLoading(false);
+      onRefreshStateChange?.(false);
+    }
+  }, [hydrated, onRefreshStateChange, t]);
+  React.useEffect(() => {
+    refresh().catch(() => {
+    });
+  }, [refresh, refreshToken]);
+  if (mode === "settings") {
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-4 text-sm", children: [
+      /* @__PURE__ */ jsx(
+        DateRangeSelect,
+        {
+          id: "new-customers-kpi-date-range",
+          label: t("dashboards.analytics.settings.dateRange", "Date Range"),
+          value: hydrated.dateRange,
+          onChange: (dateRange) => onSettingsChange({ ...hydrated, dateRange })
+        }
+      ),
+      /* @__PURE__ */ jsx("div", { className: "space-y-1.5", children: /* @__PURE__ */ jsxs("label", { className: "flex items-center gap-2 text-sm", children: [
+        /* @__PURE__ */ jsx(
+          "input",
+          {
+            type: "checkbox",
+            checked: hydrated.showComparison,
+            onChange: (e) => onSettingsChange({ ...hydrated, showComparison: e.target.checked }),
+            className: "h-4 w-4 rounded border focus:ring-primary"
+          }
+        ),
+        t("dashboards.analytics.settings.showComparison", "Show comparison")
+      ] }) })
+    ] });
+  }
+  const comparisonLabelInfo = getComparisonLabelKey(hydrated.dateRange);
+  const comparisonLabel = hydrated.showComparison ? t(comparisonLabelInfo.key, comparisonLabelInfo.fallback) : void 0;
+  return /* @__PURE__ */ jsx(
+    KpiCard,
+    {
+      value,
+      trend,
+      comparisonLabel,
+      loading,
+      error,
+      headerAction: /* @__PURE__ */ jsx(
+        InlineDateRangeSelect,
+        {
+          value: hydrated.dateRange,
+          onChange: (dateRange) => onSettingsChange({ ...hydrated, dateRange })
+        }
+      )
+    }
+  );
+};
+var widget_client_default = NewCustomersKpiWidget;
+export {
+  widget_client_default as default
+};
+//# sourceMappingURL=widget.client.js.map

package/dist/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.client.tsx"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport type { DashboardWidgetComponentProps } from '@open-mercato/shared/modules/dashboard/widgets'\nimport { apiCall } from '@open-mercato/ui/backend/utils/apiCall'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { KpiCard, type KpiTrend } from '@open-mercato/ui/backend/charts'\nimport {\n  DateRangeSelect,\n  InlineDateRangeSelect,\n  type DateRangePreset,\n  getComparisonLabelKey,\n} from '@open-mercato/ui/backend/date-range'\nimport { DEFAULT_SETTINGS, hydrateSettings, type NewCustomersKpiSettings } from './config'\nimport type { WidgetDataResponse } from '../../../services/widgetDataService'\n\nasync function fetchNewCustomersData(settings: NewCustomersKpiSettings): Promise<WidgetDataResponse> {\n  const body = {\n    entityType: 'customers:entities',\n    metric: {\n      field: 'id',\n      aggregate: 'count',\n    },\n    dateRange: {\n      field: 'createdAt',\n      preset: settings.dateRange,\n    },\n    comparison: settings.showComparison ? { type: 'previous_period' } : undefined,\n  }\n\n  const call = await apiCall<WidgetDataResponse>('/api/dashboards/widgets/data', {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n  })\n\n  if (!call.ok) {\n    const errorMsg = (call.result as Record<string, unknown>)?.error\n    throw new Error(typeof errorMsg === 'string' ? errorMsg : 'Failed to fetch new customers data')\n  }\n\n  return call.result as WidgetDataResponse\n}\n\nconst NewCustomersKpiWidget: React.FC<DashboardWidgetComponentProps<NewCustomersKpiSettings>> = ({\n  mode,\n  settings = DEFAULT_SETTINGS,\n  onSettingsChange,\n  refreshToken,\n  onRefreshStateChange,\n}) => {\n  const t = useT()\n  const hydrated = React.useMemo(() => hydrateSettings(settings), [settings])\n  const [value, setValue] = React.useState<number | null>(null)\n  const [trend, setTrend] = React.useState<KpiTrend | undefined>(undefined)\n  const [loading, setLoading] = React.useState(true)\n  const [error, setError] = React.useState<string | null>(null)\n\n  const refresh = React.useCallback(async () => {\n    onRefreshStateChange?.(true)\n    setLoading(true)\n    setError(null)\n    try {\n      const data = await fetchNewCustomersData(hydrated)\n      setValue(data.value)\n      if (data.comparison) {\n        setTrend({\n          value: data.comparison.change,\n          direction: data.comparison.direction,\n        })\n      } else {\n        setTrend(undefined)\n      }\n    } catch (err) {\n      console.error('Failed to load new customers KPI data', err)\n      setError(t('dashboards.analytics.widgets.newCustomersKpi.error', 'Failed to load data'))\n    } finally {\n      setLoading(false)\n      onRefreshStateChange?.(false)\n    }\n  }, [hydrated, onRefreshStateChange, t])\n\n  React.useEffect(() => {\n    refresh().catch(() => {})\n  }, [refresh, refreshToken])\n\n  if (mode === 'settings') {\n    return (\n      <div className=\"space-y-4 text-sm\">\n        <DateRangeSelect\n          id=\"new-customers-kpi-date-range\"\n          label={t('dashboards.analytics.settings.dateRange', 'Date Range')}\n          value={hydrated.dateRange}\n          onChange={(dateRange: DateRangePreset) => onSettingsChange({ ...hydrated, dateRange })}\n        />\n        <div className=\"space-y-1.5\">\n          <label className=\"flex items-center gap-2 text-sm\">\n            <input\n              type=\"checkbox\"\n              checked={hydrated.showComparison}\n              onChange={(e) => onSettingsChange({ ...hydrated, showComparison: e.target.checked })}\n              className=\"h-4 w-4 rounded border focus:ring-primary\"\n            />\n            {t('dashboards.analytics.settings.showComparison', 'Show comparison')}\n          </label>\n        </div>\n      </div>\n    )\n  }\n\n  const comparisonLabelInfo = getComparisonLabelKey(hydrated.dateRange)\n  const comparisonLabel = hydrated.showComparison\n    ? t(comparisonLabelInfo.key, comparisonLabelInfo.fallback)\n    : undefined\n\n  return (\n    <KpiCard\n      value={value}\n      trend={trend}\n      comparisonLabel={comparisonLabel}\n      loading={loading}\n      error={error}\n      headerAction={\n        <InlineDateRangeSelect\n          value={hydrated.dateRange}\n          onChange={(dateRange) => onSettingsChange({ ...hydrated, dateRange })}\n        />\n      }\n    />\n  )\n}\n\nexport default NewCustomersKpiWidget\n"],
+  "mappings": "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",
+  "names": []
+}