@open-mercato/core 0.4.2-canary-10c7a8bf2a → 0.4.2-canary-e6bf6a353e

package/dist/modules/dashboards/cli.js

@@ -2,6 +2,7 @@ import { createRequestContainer } from "@open-mercato/shared/lib/di/container";
 import { DashboardRoleWidgets } from "@open-mercato/core/modules/dashboards/data/entities";
 import { Role } from "@open-mercato/core/modules/auth/data/entities";
 import { loadAllWidgets } from "@open-mercato/core/modules/dashboards/lib/widgets";
+import { seedAnalyticsData } from "./seed/analytics.js";
 function parseArgs(rest) {
   const args = {};
   for (let i = 0; i < rest.length; i += 2) {
@@ -90,7 +91,147 @@ const seedDefaults = {
     });
   }
 };
-var cli_default = [seedDefaults];
+const seedAnalytics = {
+  command: "seed-analytics",
+  async run(rest) {
+    const args = parseArgs(rest);
+    const tenantId = args.tenant || args.tenantId || null;
+    const organizationId = args.organization || args.organizationId || args.org || null;
+    const months = args.months ? parseInt(args.months, 10) : 6;
+    const ordersPerMonth = args.ordersPerMonth ? parseInt(args.ordersPerMonth, 10) : 50;
+    if (!tenantId || !organizationId) {
+      console.error("Usage: mercato dashboards seed-analytics --tenant <tenantId> --organization <organizationId> [--months 6] [--ordersPerMonth 50]");
+      return;
+    }
+    const { resolve } = await createRequestContainer();
+    const em = resolve("em");
+    console.log(`Seeding analytics data for ${months} months with ~${ordersPerMonth} orders/month...`);
+    try {
+      const result = await em.transactional(
+        async (tem) => seedAnalyticsData(tem, { tenantId, organizationId }, { months, ordersPerMonth })
+      );
+      if (result.orders === 0) {
+        console.log("Analytics data already exists. Skipping seed.");
+      } else {
+        console.log(`Seeded analytics data:`);
+        console.log(`  - Orders: ${result.orders}`);
+        console.log(`  - Customers: ${result.customers}`);
+        console.log(`  - Products: ${result.products}`);
+        console.log(`  - Deals: ${result.deals}`);
+      }
+    } catch (error) {
+      console.error("Failed to seed analytics data:", error);
+    }
+  }
+};
+const debugAnalytics = {
+  command: "debug-analytics",
+  async run(rest) {
+    const args = parseArgs(rest);
+    const tenantId = args.tenant || args.tenantId || null;
+    const organizationId = args.organization || args.organizationId || args.org || null;
+    if (!tenantId) {
+      console.error("Usage: mercato dashboards debug-analytics --tenant <tenantId> [--organization <organizationId>]");
+      return;
+    }
+    const { resolve } = await createRequestContainer();
+    const em = resolve("em");
+    const conn = em.getConnection();
+    console.log("Checking analytics data...\n");
+    const ordersResult = await conn.execute(
+      `SELECT COUNT(*) as total, MIN(placed_at) as earliest, MAX(placed_at) as latest
+       FROM sales_orders
+       WHERE tenant_id = ? AND order_number LIKE 'SO-ANALYTICS-%'`,
+      [tenantId]
+    );
+    console.log("Orders summary:", ordersResult[0]);
+    const recentOrders = await conn.execute(
+      `SELECT order_number, placed_at, status, grand_total_gross_amount::numeric as total
+       FROM sales_orders
+       WHERE tenant_id = ? AND order_number LIKE 'SO-ANALYTICS-%'
+       ORDER BY placed_at DESC LIMIT 5`,
+      [tenantId]
+    );
+    console.log("\nRecent orders:", recentOrders);
+    const januaryOrders = await conn.execute(
+      `SELECT COUNT(*) as count, SUM(grand_total_gross_amount::numeric) as total
+       FROM sales_orders
+       WHERE tenant_id = ?
+         AND order_number LIKE 'SO-ANALYTICS-%'
+         AND placed_at >= '2026-01-01'
+         AND placed_at <= '2026-01-31 23:59:59'`,
+      [tenantId]
+    );
+    console.log("\nJanuary 2026 orders:", januaryOrders[0]);
+    const allOrders = await conn.execute(
+      `SELECT COUNT(*) as count
+       FROM sales_orders
+       WHERE tenant_id = ?`,
+      [tenantId]
+    );
+    console.log("\nTotal orders in tenant:", allOrders[0]);
+    const orgCheck = await conn.execute(
+      `SELECT organization_id, COUNT(*) as count
+       FROM sales_orders
+       WHERE tenant_id = ? AND order_number LIKE 'SO-ANALYTICS-%'
+       GROUP BY organization_id`,
+      [tenantId]
+    );
+    console.log("\nOrders by organization:", orgCheck);
+    if (organizationId) {
+      const orgOrders = await conn.execute(
+        `SELECT COUNT(*) as count, SUM(grand_total_gross_amount::numeric) as total
+         FROM sales_orders
+         WHERE tenant_id = ?
+           AND organization_id = ?
+           AND placed_at >= '2026-01-01'
+           AND placed_at <= '2026-01-31 23:59:59'`,
+        [tenantId, organizationId]
+      );
+      console.log(`
+January orders for org ${organizationId}:`, orgOrders[0]);
+    }
+    const nullPlacedAt = await conn.execute(
+      `SELECT COUNT(*) as count
+       FROM sales_orders
+       WHERE tenant_id = ? AND placed_at IS NULL`,
+      [tenantId]
+    );
+    console.log("\nOrders with NULL placed_at:", nullPlacedAt[0]);
+    const nonAnalytics = await conn.execute(
+      `SELECT order_number, placed_at, status, organization_id, grand_total_gross_amount::numeric as total
+       FROM sales_orders
+       WHERE tenant_id = ? AND order_number NOT LIKE 'SO-ANALYTICS-%'
+       ORDER BY placed_at DESC NULLS LAST LIMIT 10`,
+      [tenantId]
+    );
+    console.log("\nNon-analytics orders:", nonAnalytics);
+    console.log("\n--- Simulating widget query for this_month ---");
+    const widgetQuery = await conn.execute(
+      `SELECT COALESCE(SUM(grand_total_gross_amount::numeric), 0) AS value
+       FROM sales_orders
+       WHERE tenant_id = ?
+         AND organization_id = ANY(?::uuid[])
+         AND deleted_at IS NULL
+         AND placed_at >= '2026-01-01'
+         AND placed_at <= '2026-01-31 23:59:59'`,
+      [tenantId, `{${organizationId}}`]
+    );
+    console.log("Widget query result (revenue sum):", widgetQuery[0]);
+    const widgetCountQuery = await conn.execute(
+      `SELECT COUNT(*) AS value
+       FROM sales_orders
+       WHERE tenant_id = ?
+         AND organization_id = ANY(?::uuid[])
+         AND deleted_at IS NULL
+         AND placed_at >= '2026-01-01'
+         AND placed_at <= '2026-01-31 23:59:59'`,
+      [tenantId, `{${organizationId}}`]
+    );
+    console.log("Widget query result (order count):", widgetCountQuery[0]);
+  }
+};
+var cli_default = [seedDefaults, seedAnalytics, debugAnalytics];
 export {
   cli_default as default,
   seedDashboardDefaultsForTenant

package/dist/modules/dashboards/cli.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/dashboards/cli.ts"],
-  "sourcesContent": ["import type { ModuleCli } from '@open-mercato/shared/modules/registry'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { DashboardRoleWidgets } from '@open-mercato/core/modules/dashboards/data/entities'\nimport { Role } from '@open-mercato/core/modules/auth/data/entities'\nimport { loadAllWidgets } from '@open-mercato/core/modules/dashboards/lib/widgets'\n\ntype Args = Record<string, string>\n\nfunction parseArgs(rest: string[]): Args {\n  const args: Args = {}\n  for (let i = 0; i < rest.length; i += 2) {\n    const key = rest[i]?.replace(/^--/, '')\n    const value = rest[i + 1]\n    if (key) args[key] = value ?? ''\n  }\n  return args\n}\n\nexport async function seedDashboardDefaultsForTenant(\n  em: EntityManager,\n  {\n    tenantId,\n    organizationId = null,\n    roleNames = ['superadmin', 'admin', 'employee'],\n    widgetIds,\n    logger,\n  }: {\n    tenantId: string\n    organizationId?: string | null\n    roleNames?: string[]\n    widgetIds?: string[]\n    logger?: (message: string) => void\n  },\n): Promise<boolean> {\n  if (!tenantId) throw new Error('tenantId is required')\n  const log = logger ?? (() => {})\n\n  const widgets = await loadAllWidgets()\n  const widgetMap = new Map(widgets.map((widget) => [widget.metadata.id, widget]))\n  const resolvedWidgetIds = widgetIds && widgetIds.length\n    ? widgetIds.filter((id) => widgetMap.has(id))\n    : widgets.filter((widget) => widget.metadata.defaultEnabled).map((widget) => widget.metadata.id)\n\n  if (!resolvedWidgetIds.length) {\n    log('No widgets resolved for dashboard seeding.')\n    return false\n  }\n\n  await em.transactional(async (tem) => {\n    for (const roleName of roleNames) {\n      const role = await tem.findOne(Role, { name: roleName })\n      if (!role) {\n        log(`Skipping role \"${roleName}\" (not found)`)\n        continue\n      }\n      const existing = await tem.findOne(DashboardRoleWidgets, {\n        roleId: String(role.id),\n        tenantId,\n        organizationId,\n        deletedAt: null,\n      })\n      if (existing) {\n        existing.widgetIdsJson = resolvedWidgetIds\n        tem.persist(existing)\n        log(`Updated dashboard widgets for role \"${roleName}\"`)\n      } else {\n        const record = tem.create(DashboardRoleWidgets, {\n          roleId: String(role.id),\n          tenantId,\n          organizationId,\n          widgetIdsJson: resolvedWidgetIds,\n          createdAt: new Date(),\n          updatedAt: null,\n          deletedAt: null,\n        })\n        tem.persist(record)\n        log(`Created dashboard widgets for role \"${roleName}\"`)\n      }\n    }\n  })\n\n  return true\n}\n\nconst seedDefaults: ModuleCli = {\n  command: 'seed-defaults',\n  async run(rest) {\n    const args = parseArgs(rest)\n    const tenantId = args.tenant || args.tenantId || null\n    const organizationId = args.organization || args.organizationId || null\n    const roleCsv = args.roles || 'superadmin,admin,employee'\n    const widgetCsv = args.widgets || ''\n    if (!tenantId) {\n      console.error('Usage: mercato dashboards seed-defaults --tenant <tenantId> [--roles superadmin,admin,employee] [--widgets id1,id2]')\n      return\n    }\n\n    const roleNames = roleCsv\n      .split(',')\n      .map((name) => name.trim())\n      .filter(Boolean)\n\n    if (!roleNames.length) {\n      console.log('No roles provided, nothing to seed.')\n      return\n    }\n\n    const { resolve } = await createRequestContainer()\n    const em = resolve('em') as any\n\n    await seedDashboardDefaultsForTenant(em as EntityManager, {\n      tenantId,\n      organizationId,\n      roleNames,\n      widgetIds: widgetCsv ? widgetCsv.split(',').map((id) => id.trim()).filter(Boolean) : undefined,\n      logger: (message) => console.log(message),\n    })\n  },\n}\n\nexport default [seedDefaults]\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { ModuleCli } from '@open-mercato/shared/modules/registry'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { DashboardRoleWidgets } from '@open-mercato/core/modules/dashboards/data/entities'\nimport { Role } from '@open-mercato/core/modules/auth/data/entities'\nimport { loadAllWidgets } from '@open-mercato/core/modules/dashboards/lib/widgets'\nimport { seedAnalyticsData } from './seed/analytics'\n\ntype Args = Record<string, string>\n\nfunction parseArgs(rest: string[]): Args {\n  const args: Args = {}\n  for (let i = 0; i < rest.length; i += 2) {\n    const key = rest[i]?.replace(/^--/, '')\n    const value = rest[i + 1]\n    if (key) args[key] = value ?? ''\n  }\n  return args\n}\n\nexport async function seedDashboardDefaultsForTenant(\n  em: EntityManager,\n  {\n    tenantId,\n    organizationId = null,\n    roleNames = ['superadmin', 'admin', 'employee'],\n    widgetIds,\n    logger,\n  }: {\n    tenantId: string\n    organizationId?: string | null\n    roleNames?: string[]\n    widgetIds?: string[]\n    logger?: (message: string) => void\n  },\n): Promise<boolean> {\n  if (!tenantId) throw new Error('tenantId is required')\n  const log = logger ?? (() => {})\n\n  const widgets = await loadAllWidgets()\n  const widgetMap = new Map(widgets.map((widget) => [widget.metadata.id, widget]))\n  const resolvedWidgetIds = widgetIds && widgetIds.length\n    ? widgetIds.filter((id) => widgetMap.has(id))\n    : widgets.filter((widget) => widget.metadata.defaultEnabled).map((widget) => widget.metadata.id)\n\n  if (!resolvedWidgetIds.length) {\n    log('No widgets resolved for dashboard seeding.')\n    return false\n  }\n\n  await em.transactional(async (tem) => {\n    for (const roleName of roleNames) {\n      const role = await tem.findOne(Role, { name: roleName })\n      if (!role) {\n        log(`Skipping role \"${roleName}\" (not found)`)\n        continue\n      }\n      const existing = await tem.findOne(DashboardRoleWidgets, {\n        roleId: String(role.id),\n        tenantId,\n        organizationId,\n        deletedAt: null,\n      })\n      if (existing) {\n        existing.widgetIdsJson = resolvedWidgetIds\n        tem.persist(existing)\n        log(`Updated dashboard widgets for role \"${roleName}\"`)\n      } else {\n        const record = tem.create(DashboardRoleWidgets, {\n          roleId: String(role.id),\n          tenantId,\n          organizationId,\n          widgetIdsJson: resolvedWidgetIds,\n          createdAt: new Date(),\n          updatedAt: null,\n          deletedAt: null,\n        })\n        tem.persist(record)\n        log(`Created dashboard widgets for role \"${roleName}\"`)\n      }\n    }\n  })\n\n  return true\n}\n\nconst seedDefaults: ModuleCli = {\n  command: 'seed-defaults',\n  async run(rest) {\n    const args = parseArgs(rest)\n    const tenantId = args.tenant || args.tenantId || null\n    const organizationId = args.organization || args.organizationId || null\n    const roleCsv = args.roles || 'superadmin,admin,employee'\n    const widgetCsv = args.widgets || ''\n    if (!tenantId) {\n      console.error('Usage: mercato dashboards seed-defaults --tenant <tenantId> [--roles superadmin,admin,employee] [--widgets id1,id2]')\n      return\n    }\n\n    const roleNames = roleCsv\n      .split(',')\n      .map((name) => name.trim())\n      .filter(Boolean)\n\n    if (!roleNames.length) {\n      console.log('No roles provided, nothing to seed.')\n      return\n    }\n\n    const { resolve } = await createRequestContainer()\n    const em = resolve('em') as any\n\n    await seedDashboardDefaultsForTenant(em as EntityManager, {\n      tenantId,\n      organizationId,\n      roleNames,\n      widgetIds: widgetCsv ? widgetCsv.split(',').map((id) => id.trim()).filter(Boolean) : undefined,\n      logger: (message) => console.log(message),\n    })\n  },\n}\n\nconst seedAnalytics: ModuleCli = {\n  command: 'seed-analytics',\n  async run(rest) {\n    const args = parseArgs(rest)\n    const tenantId = args.tenant || args.tenantId || null\n    const organizationId = args.organization || args.organizationId || args.org || null\n    const months = args.months ? parseInt(args.months, 10) : 6\n    const ordersPerMonth = args.ordersPerMonth ? parseInt(args.ordersPerMonth, 10) : 50\n\n    if (!tenantId || !organizationId) {\n      console.error('Usage: mercato dashboards seed-analytics --tenant <tenantId> --organization <organizationId> [--months 6] [--ordersPerMonth 50]')\n      return\n    }\n\n    const { resolve } = await createRequestContainer()\n    const em = resolve('em') as EntityManager\n\n    console.log(`Seeding analytics data for ${months} months with ~${ordersPerMonth} orders/month...`)\n\n    try {\n      const result = await em.transactional(async (tem) =>\n        seedAnalyticsData(tem, { tenantId, organizationId }, { months, ordersPerMonth })\n      )\n\n      if (result.orders === 0) {\n        console.log('Analytics data already exists. Skipping seed.')\n      } else {\n        console.log(`Seeded analytics data:`)\n        console.log(`  - Orders: ${result.orders}`)\n        console.log(`  - Customers: ${result.customers}`)\n        console.log(`  - Products: ${result.products}`)\n        console.log(`  - Deals: ${result.deals}`)\n      }\n    } catch (error) {\n      console.error('Failed to seed analytics data:', error)\n    }\n  },\n}\n\nconst debugAnalytics: ModuleCli = {\n  command: 'debug-analytics',\n  async run(rest) {\n    const args = parseArgs(rest)\n    const tenantId = args.tenant || args.tenantId || null\n    const organizationId = args.organization || args.organizationId || args.org || null\n\n    if (!tenantId) {\n      console.error('Usage: mercato dashboards debug-analytics --tenant <tenantId> [--organization <organizationId>]')\n      return\n    }\n\n    const { resolve } = await createRequestContainer()\n    const em = resolve('em') as EntityManager\n    const conn = em.getConnection()\n\n    console.log('Checking analytics data...\\n')\n\n    const ordersResult = await conn.execute(\n      `SELECT COUNT(*) as total, MIN(placed_at) as earliest, MAX(placed_at) as latest\n       FROM sales_orders\n       WHERE tenant_id = ? AND order_number LIKE 'SO-ANALYTICS-%'`,\n      [tenantId]\n    )\n    console.log('Orders summary:', ordersResult[0])\n\n    const recentOrders = await conn.execute(\n      `SELECT order_number, placed_at, status, grand_total_gross_amount::numeric as total\n       FROM sales_orders\n       WHERE tenant_id = ? AND order_number LIKE 'SO-ANALYTICS-%'\n       ORDER BY placed_at DESC LIMIT 5`,\n      [tenantId]\n    )\n    console.log('\\nRecent orders:', recentOrders)\n\n    const januaryOrders = await conn.execute(\n      `SELECT COUNT(*) as count, SUM(grand_total_gross_amount::numeric) as total\n       FROM sales_orders\n       WHERE tenant_id = ?\n         AND order_number LIKE 'SO-ANALYTICS-%'\n         AND placed_at >= '2026-01-01'\n         AND placed_at <= '2026-01-31 23:59:59'`,\n      [tenantId]\n    )\n    console.log('\\nJanuary 2026 orders:', januaryOrders[0])\n\n    const allOrders = await conn.execute(\n      `SELECT COUNT(*) as count\n       FROM sales_orders\n       WHERE tenant_id = ?`,\n      [tenantId]\n    )\n    console.log('\\nTotal orders in tenant:', allOrders[0])\n\n    const orgCheck = await conn.execute(\n      `SELECT organization_id, COUNT(*) as count\n       FROM sales_orders\n       WHERE tenant_id = ? AND order_number LIKE 'SO-ANALYTICS-%'\n       GROUP BY organization_id`,\n      [tenantId]\n    )\n    console.log('\\nOrders by organization:', orgCheck)\n\n    if (organizationId) {\n      const orgOrders = await conn.execute(\n        `SELECT COUNT(*) as count, SUM(grand_total_gross_amount::numeric) as total\n         FROM sales_orders\n         WHERE tenant_id = ?\n           AND organization_id = ?\n           AND placed_at >= '2026-01-01'\n           AND placed_at <= '2026-01-31 23:59:59'`,\n        [tenantId, organizationId]\n      )\n      console.log(`\\nJanuary orders for org ${organizationId}:`, orgOrders[0])\n    }\n\n    // Check for NULL placed_at\n    const nullPlacedAt = await conn.execute(\n      `SELECT COUNT(*) as count\n       FROM sales_orders\n       WHERE tenant_id = ? AND placed_at IS NULL`,\n      [tenantId]\n    )\n    console.log('\\nOrders with NULL placed_at:', nullPlacedAt[0])\n\n    // Check non-analytics orders\n    const nonAnalytics = await conn.execute(\n      `SELECT order_number, placed_at, status, organization_id, grand_total_gross_amount::numeric as total\n       FROM sales_orders\n       WHERE tenant_id = ? AND order_number NOT LIKE 'SO-ANALYTICS-%'\n       ORDER BY placed_at DESC NULLS LAST LIMIT 10`,\n      [tenantId]\n    )\n    console.log('\\nNon-analytics orders:', nonAnalytics)\n\n    // Simulate widget query\n    console.log('\\n--- Simulating widget query for this_month ---')\n    const widgetQuery = await conn.execute(\n      `SELECT COALESCE(SUM(grand_total_gross_amount::numeric), 0) AS value\n       FROM sales_orders\n       WHERE tenant_id = ?\n         AND organization_id = ANY(?::uuid[])\n         AND deleted_at IS NULL\n         AND placed_at >= '2026-01-01'\n         AND placed_at <= '2026-01-31 23:59:59'`,\n      [tenantId, `{${organizationId}}`]\n    )\n    console.log('Widget query result (revenue sum):', widgetQuery[0])\n\n    const widgetCountQuery = await conn.execute(\n      `SELECT COUNT(*) AS value\n       FROM sales_orders\n       WHERE tenant_id = ?\n         AND organization_id = ANY(?::uuid[])\n         AND deleted_at IS NULL\n         AND placed_at >= '2026-01-01'\n         AND placed_at <= '2026-01-31 23:59:59'`,\n      [tenantId, `{${organizationId}}`]\n    )\n    console.log('Widget query result (order count):', widgetCountQuery[0])\n  },\n}\n\nexport default [seedDefaults, seedAnalytics, debugAnalytics]\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/dashboards/di.js

@@ -0,0 +1,11 @@
+import { asFunction } from "awilix";
+import { createAnalyticsRegistry } from "./services/analyticsRegistry.js";
+function register(container) {
+  container.register({
+    analyticsRegistry: asFunction(() => createAnalyticsRegistry()).singleton()
+  });
+}
+export {
+  register
+};
+//# sourceMappingURL=di.js.map

package/dist/modules/dashboards/di.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/dashboards/di.ts"],
+  "sourcesContent": ["import { asFunction } from 'awilix'\nimport type { AppContainer } from '@open-mercato/shared/lib/di/container'\nimport { createAnalyticsRegistry } from './services/analyticsRegistry'\n\nexport function register(container: AppContainer): void {\n  container.register({\n    analyticsRegistry: asFunction(() => createAnalyticsRegistry()).singleton(),\n  })\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAE3B,SAAS,+BAA+B;AAEjC,SAAS,SAAS,WAA+B;AACtD,YAAU,SAAS;AAAA,IACjB,mBAAmB,WAAW,MAAM,wBAAwB,CAAC,EAAE,UAAU;AAAA,EAC3E,CAAC;AACH;",
+  "names": []
+}

package/dist/modules/dashboards/lib/aggregations.js

@@ -0,0 +1,162 @@
+const VALID_GRANULARITIES = ["day", "week", "month", "quarter", "year"];
+const VALID_AGGREGATES = ["count", "sum", "avg", "min", "max"];
+const SAFE_IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function isValidGranularity(value) {
+  return typeof value === "string" && VALID_GRANULARITIES.includes(value);
+}
+function isValidAggregate(value) {
+  return typeof value === "string" && VALID_AGGREGATES.includes(value);
+}
+function isSafeIdentifier(value) {
+  return SAFE_IDENTIFIER_PATTERN.test(value);
+}
+function buildAggregateExpression(aggregate, column) {
+  switch (aggregate) {
+    case "count":
+      return column === "id" ? "COUNT(*)" : `COUNT(${column})`;
+    case "sum":
+      return `COALESCE(SUM(${column}::numeric), 0)`;
+    case "avg":
+      return `COALESCE(AVG(${column}::numeric), 0)`;
+    case "min":
+      return `MIN(${column}::numeric)`;
+    case "max":
+      return `MAX(${column}::numeric)`;
+    default:
+      return `COUNT(*)`;
+  }
+}
+function buildDateTruncExpression(column, granularity) {
+  if (!isValidGranularity(granularity)) {
+    throw new Error(`Invalid granularity: ${granularity}`);
+  }
+  return `DATE_TRUNC('${granularity}', ${column})`;
+}
+function buildJsonbFieldExpression(column, path) {
+  const parts = path.split(".");
+  for (const part of parts) {
+    if (!isSafeIdentifier(part)) {
+      throw new Error(`Invalid JSONB path part: ${part}`);
+    }
+  }
+  if (parts.length === 1) {
+    return `${column}->>'${parts[0]}'`;
+  }
+  const intermediate = parts.slice(0, -1).map((p) => `'${p}'`).join("->");
+  const lastPart = parts[parts.length - 1];
+  return `${column}->${intermediate}->>'${lastPart}'`;
+}
+function buildAggregationQuery(options) {
+  const { registry } = options;
+  const config = registry.getEntityTypeConfig(options.entityType);
+  if (!config) return null;
+  const metricMapping = registry.getFieldMapping(options.entityType, options.metric.field);
+  if (!metricMapping) return null;
+  const params = [];
+  const tableName = config.schema ? `"${config.schema}"."${config.tableName}"` : `"${config.tableName}"`;
+  const aggregateExpr = buildAggregateExpression(options.metric.aggregate, metricMapping.dbColumn);
+  let selectClause = `SELECT ${aggregateExpr} AS value`;
+  let groupByClause = "";
+  let orderByClause = "";
+  let limitClause = "";
+  if (options.groupBy) {
+    let groupMapping = registry.getFieldMapping(options.entityType, options.groupBy.field);
+    let groupExpr = null;
+    if (!groupMapping && options.groupBy.field.includes(".")) {
+      const [baseField, ...pathParts] = options.groupBy.field.split(".");
+      const baseMapping = registry.getFieldMapping(options.entityType, baseField);
+      if (baseMapping?.type === "jsonb") {
+        groupExpr = buildJsonbFieldExpression(baseMapping.dbColumn, pathParts.join("."));
+      }
+    } else if (groupMapping) {
+      if (groupMapping.type === "timestamp" && options.groupBy.granularity) {
+        groupExpr = buildDateTruncExpression(groupMapping.dbColumn, options.groupBy.granularity);
+      } else {
+        groupExpr = groupMapping.dbColumn;
+      }
+    }
+    if (groupExpr) {
+      selectClause = `SELECT ${groupExpr} AS group_key, ${aggregateExpr} AS value`;
+      groupByClause = `GROUP BY ${groupExpr}`;
+      orderByClause = `ORDER BY value DESC`;
+      if (options.groupBy.limit && options.groupBy.limit > 0) {
+        limitClause = `LIMIT ${Math.min(options.groupBy.limit, 100)}`;
+      }
+    }
+  }
+  const whereClauses = [];
+  whereClauses.push(`tenant_id = ?`);
+  params.push(options.scope.tenantId);
+  if (options.scope.organizationIds && options.scope.organizationIds.length > 0) {
+    whereClauses.push(`organization_id = ANY(?::uuid[])`);
+    params.push(`{${options.scope.organizationIds.join(",")}}`);
+  }
+  whereClauses.push(`deleted_at IS NULL`);
+  if (options.dateRange) {
+    const dateMapping = registry.getFieldMapping(options.entityType, options.dateRange.field);
+    if (dateMapping) {
+      whereClauses.push(`${dateMapping.dbColumn} >= ?`);
+      params.push(options.dateRange.start);
+      whereClauses.push(`${dateMapping.dbColumn} <= ?`);
+      params.push(options.dateRange.end);
+    }
+  }
+  if (options.filters) {
+    for (const filter of options.filters) {
+      const filterMapping = registry.getFieldMapping(options.entityType, filter.field);
+      if (!filterMapping) continue;
+      switch (filter.operator) {
+        case "eq":
+          whereClauses.push(`${filterMapping.dbColumn} = ?`);
+          params.push(filter.value);
+          break;
+        case "neq":
+          whereClauses.push(`${filterMapping.dbColumn} != ?`);
+          params.push(filter.value);
+          break;
+        case "gt":
+          whereClauses.push(`${filterMapping.dbColumn} > ?`);
+          params.push(filter.value);
+          break;
+        case "gte":
+          whereClauses.push(`${filterMapping.dbColumn} >= ?`);
+          params.push(filter.value);
+          break;
+        case "lt":
+          whereClauses.push(`${filterMapping.dbColumn} < ?`);
+          params.push(filter.value);
+          break;
+        case "lte":
+          whereClauses.push(`${filterMapping.dbColumn} <= ?`);
+          params.push(filter.value);
+          break;
+        case "in":
+          whereClauses.push(`${filterMapping.dbColumn} = ANY(?)`);
+          params.push(filter.value);
+          break;
+        case "not_in":
+          whereClauses.push(`${filterMapping.dbColumn} != ALL(?)`);
+          params.push(filter.value);
+          break;
+        case "is_null":
+          whereClauses.push(`${filterMapping.dbColumn} IS NULL`);
+          break;
+        case "is_not_null":
+          whereClauses.push(`${filterMapping.dbColumn} IS NOT NULL`);
+          break;
+      }
+    }
+  }
+  const whereClause = whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : "";
+  const sql = [selectClause, `FROM ${tableName}`, whereClause, groupByClause, orderByClause, limitClause].filter(Boolean).join(" ");
+  return { sql, params };
+}
+export {
+  buildAggregateExpression,
+  buildAggregationQuery,
+  buildDateTruncExpression,
+  buildJsonbFieldExpression,
+  isValidAggregate,
+  isValidGranularity
+};
+//# sourceMappingURL=aggregations.js.map

package/dist/modules/dashboards/lib/aggregations.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/dashboards/lib/aggregations.ts"],
+  "sourcesContent": ["import type { AnalyticsRegistry } from '../services/analyticsRegistry'\nimport type { AnalyticsEntityTypeConfig, AnalyticsFieldMapping } from '@open-mercato/shared/modules/analytics'\n\nexport type AggregateFunction = 'count' | 'sum' | 'avg' | 'min' | 'max'\nexport type DateGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year'\n\nconst VALID_GRANULARITIES: readonly DateGranularity[] = ['day', 'week', 'month', 'quarter', 'year']\nconst VALID_AGGREGATES: readonly AggregateFunction[] = ['count', 'sum', 'avg', 'min', 'max']\nconst SAFE_IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/\n\nexport function isValidGranularity(value: unknown): value is DateGranularity {\n  return typeof value === 'string' && VALID_GRANULARITIES.includes(value as DateGranularity)\n}\n\nexport function isValidAggregate(value: unknown): value is AggregateFunction {\n  return typeof value === 'string' && VALID_AGGREGATES.includes(value as AggregateFunction)\n}\n\nfunction isSafeIdentifier(value: string): boolean {\n  return SAFE_IDENTIFIER_PATTERN.test(value)\n}\n\n// Re-export types from shared module for convenience\nexport type EntityTypeConfig = AnalyticsEntityTypeConfig\nexport type FieldMapping = AnalyticsFieldMapping\n\nexport function buildAggregateExpression(aggregate: AggregateFunction, column: string): string {\n  switch (aggregate) {\n    case 'count':\n      return column === 'id' ? 'COUNT(*)' : `COUNT(${column})`\n    case 'sum':\n      return `COALESCE(SUM(${column}::numeric), 0)`\n    case 'avg':\n      return `COALESCE(AVG(${column}::numeric), 0)`\n    case 'min':\n      return `MIN(${column}::numeric)`\n    case 'max':\n      return `MAX(${column}::numeric)`\n    default:\n      return `COUNT(*)`\n  }\n}\n\nexport function buildDateTruncExpression(column: string, granularity: DateGranularity): string {\n  if (!isValidGranularity(granularity)) {\n    throw new Error(`Invalid granularity: ${granularity}`)\n  }\n  return `DATE_TRUNC('${granularity}', ${column})`\n}\n\nexport function buildJsonbFieldExpression(column: string, path: string): string {\n  const parts = path.split('.')\n  for (const part of parts) {\n    if (!isSafeIdentifier(part)) {\n      throw new Error(`Invalid JSONB path part: ${part}`)\n    }\n  }\n  if (parts.length === 1) {\n    return `${column}->>'${parts[0]}'`\n  }\n  const intermediate = parts.slice(0, -1).map((p) => `'${p}'`).join('->')\n  const lastPart = parts[parts.length - 1]\n  return `${column}->${intermediate}->>'${lastPart}'`\n}\n\nexport type AggregationQuery = {\n  sql: string\n  params: unknown[]\n}\n\nexport type BuildAggregationQueryOptions = {\n  entityType: string\n  metric: {\n    field: string\n    aggregate: AggregateFunction\n  }\n  groupBy?: {\n    field: string\n    granularity?: DateGranularity\n    limit?: number\n  }\n  dateRange?: {\n    field: string\n    start: Date\n    end: Date\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  scope: {\n    tenantId: string\n    organizationIds?: string[]\n  }\n  /** Analytics registry for resolving entity and field configurations */\n  registry: AnalyticsRegistry\n}\n\nexport function buildAggregationQuery(options: BuildAggregationQueryOptions): AggregationQuery | null {\n  const { registry } = options\n  const config = registry.getEntityTypeConfig(options.entityType)\n  if (!config) return null\n\n  const metricMapping = registry.getFieldMapping(options.entityType, options.metric.field)\n  if (!metricMapping) return null\n\n  const params: unknown[] = []\n\n  const tableName = config.schema ? `\"${config.schema}\".\"${config.tableName}\"` : `\"${config.tableName}\"`\n  const aggregateExpr = buildAggregateExpression(options.metric.aggregate, metricMapping.dbColumn)\n\n  let selectClause = `SELECT ${aggregateExpr} AS value`\n  let groupByClause = ''\n  let orderByClause = ''\n  let limitClause = ''\n\n  if (options.groupBy) {\n    let groupMapping = registry.getFieldMapping(options.entityType, options.groupBy.field)\n    let groupExpr: string | null = null\n\n    // Handle JSONB path notation (e.g., shippingAddressSnapshot.region)\n    if (!groupMapping && options.groupBy.field.includes('.')) {\n      const [baseField, ...pathParts] = options.groupBy.field.split('.')\n      const baseMapping = registry.getFieldMapping(options.entityType, baseField)\n      if (baseMapping?.type === 'jsonb') {\n        groupExpr = buildJsonbFieldExpression(baseMapping.dbColumn, pathParts.join('.'))\n      }\n    } else if (groupMapping) {\n      if (groupMapping.type === 'timestamp' && options.groupBy.granularity) {\n        groupExpr = buildDateTruncExpression(groupMapping.dbColumn, options.groupBy.granularity)\n      } else {\n        groupExpr = groupMapping.dbColumn\n      }\n    }\n\n    if (groupExpr) {\n      selectClause = `SELECT ${groupExpr} AS group_key, ${aggregateExpr} AS value`\n      groupByClause = `GROUP BY ${groupExpr}`\n      orderByClause = `ORDER BY value DESC`\n\n      if (options.groupBy.limit && options.groupBy.limit > 0) {\n        limitClause = `LIMIT ${Math.min(options.groupBy.limit, 100)}`\n      }\n    }\n  }\n\n  const whereClauses: string[] = []\n\n  whereClauses.push(`tenant_id = ?`)\n  params.push(options.scope.tenantId)\n\n  if (options.scope.organizationIds && options.scope.organizationIds.length > 0) {\n    whereClauses.push(`organization_id = ANY(?::uuid[])`)\n    params.push(`{${options.scope.organizationIds.join(',')}}`)\n  }\n\n  whereClauses.push(`deleted_at IS NULL`)\n\n  if (options.dateRange) {\n    const dateMapping = registry.getFieldMapping(options.entityType, options.dateRange.field)\n    if (dateMapping) {\n      whereClauses.push(`${dateMapping.dbColumn} >= ?`)\n      params.push(options.dateRange.start)\n      whereClauses.push(`${dateMapping.dbColumn} <= ?`)\n      params.push(options.dateRange.end)\n    }\n  }\n\n  if (options.filters) {\n    for (const filter of options.filters) {\n      const filterMapping = registry.getFieldMapping(options.entityType, filter.field)\n      if (!filterMapping) continue\n\n      switch (filter.operator) {\n        case 'eq':\n          whereClauses.push(`${filterMapping.dbColumn} = ?`)\n          params.push(filter.value)\n          break\n        case 'neq':\n          whereClauses.push(`${filterMapping.dbColumn} != ?`)\n          params.push(filter.value)\n          break\n        case 'gt':\n          whereClauses.push(`${filterMapping.dbColumn} > ?`)\n          params.push(filter.value)\n          break\n        case 'gte':\n          whereClauses.push(`${filterMapping.dbColumn} >= ?`)\n          params.push(filter.value)\n          break\n        case 'lt':\n          whereClauses.push(`${filterMapping.dbColumn} < ?`)\n          params.push(filter.value)\n          break\n        case 'lte':\n          whereClauses.push(`${filterMapping.dbColumn} <= ?`)\n          params.push(filter.value)\n          break\n        case 'in':\n          whereClauses.push(`${filterMapping.dbColumn} = ANY(?)`)\n          params.push(filter.value)\n          break\n        case 'not_in':\n          whereClauses.push(`${filterMapping.dbColumn} != ALL(?)`)\n          params.push(filter.value)\n          break\n        case 'is_null':\n          whereClauses.push(`${filterMapping.dbColumn} IS NULL`)\n          break\n        case 'is_not_null':\n          whereClauses.push(`${filterMapping.dbColumn} IS NOT NULL`)\n          break\n      }\n    }\n  }\n\n  const whereClause = whereClauses.length > 0 ? `WHERE ${whereClauses.join(' AND ')}` : ''\n\n  const sql = [selectClause, `FROM ${tableName}`, whereClause, groupByClause, orderByClause, limitClause]\n    .filter(Boolean)\n    .join(' ')\n\n  return { sql, params }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/dashboards/lib/formatters.js

@@ -0,0 +1,34 @@
+function formatCurrency(value, options = {}) {
+  const { currency = "USD", minimumFractionDigits = 0, maximumFractionDigits = 0 } = options;
+  return new Intl.NumberFormat(void 0, {
+    style: "currency",
+    currency,
+    minimumFractionDigits,
+    maximumFractionDigits
+  }).format(value);
+}
+function formatCurrencyWithDecimals(value, options = {}) {
+  return formatCurrency(value, { minimumFractionDigits: 2, maximumFractionDigits: 2, ...options });
+}
+function formatCurrencyCompact(value, currencySymbol = "$") {
+  if (Math.abs(value) >= 1e6) {
+    return `${currencySymbol}${(value / 1e6).toFixed(1)}M`;
+  }
+  if (Math.abs(value) >= 1e3) {
+    return `${currencySymbol}${(value / 1e3).toFixed(1)}K`;
+  }
+  return `${currencySymbol}${value.toFixed(0)}`;
+}
+function formatCurrencySafe(value, fallback = "--") {
+  if (value === null || value === void 0) return fallback;
+  const num = Number(value);
+  if (!Number.isFinite(num)) return fallback;
+  return formatCurrency(num);
+}
+export {
+  formatCurrency,
+  formatCurrencyCompact,
+  formatCurrencySafe,
+  formatCurrencyWithDecimals
+};
+//# sourceMappingURL=formatters.js.map

package/dist/modules/dashboards/lib/formatters.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/dashboards/lib/formatters.ts"],
+  "sourcesContent": ["export type FormatCurrencyOptions = {\n  currency?: string\n  minimumFractionDigits?: number\n  maximumFractionDigits?: number\n}\n\nexport function formatCurrency(value: number, options: FormatCurrencyOptions = {}): string {\n  const { currency = 'USD', minimumFractionDigits = 0, maximumFractionDigits = 0 } = options\n  return new Intl.NumberFormat(undefined, {\n    style: 'currency',\n    currency,\n    minimumFractionDigits,\n    maximumFractionDigits,\n  }).format(value)\n}\n\nexport function formatCurrencyWithDecimals(value: number, options: FormatCurrencyOptions = {}): string {\n  return formatCurrency(value, { minimumFractionDigits: 2, maximumFractionDigits: 2, ...options })\n}\n\nexport function formatCurrencyCompact(value: number, currencySymbol = '$'): string {\n  if (Math.abs(value) >= 1_000_000) {\n    return `${currencySymbol}${(value / 1_000_000).toFixed(1)}M`\n  }\n  if (Math.abs(value) >= 1_000) {\n    return `${currencySymbol}${(value / 1_000).toFixed(1)}K`\n  }\n  return `${currencySymbol}${value.toFixed(0)}`\n}\n\nexport function formatCurrencySafe(value: unknown, fallback = '--'): string {\n  if (value === null || value === undefined) return fallback\n  const num = Number(value)\n  if (!Number.isFinite(num)) return fallback\n  return formatCurrency(num)\n}\n"],
+  "mappings": "AAMO,SAAS,eAAe,OAAe,UAAiC,CAAC,GAAW;AACzF,QAAM,EAAE,WAAW,OAAO,wBAAwB,GAAG,wBAAwB,EAAE,IAAI;AACnF,SAAO,IAAI,KAAK,aAAa,QAAW;AAAA,IACtC,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,EAAE,OAAO,KAAK;AACjB;AAEO,SAAS,2BAA2B,OAAe,UAAiC,CAAC,GAAW;AACrG,SAAO,eAAe,OAAO,EAAE,uBAAuB,GAAG,uBAAuB,GAAG,GAAG,QAAQ,CAAC;AACjG;AAEO,SAAS,sBAAsB,OAAe,iBAAiB,KAAa;AACjF,MAAI,KAAK,IAAI,KAAK,KAAK,KAAW;AAChC,WAAO,GAAG,cAAc,IAAI,QAAQ,KAAW,QAAQ,CAAC,CAAC;AAAA,EAC3D;AACA,MAAI,KAAK,IAAI,KAAK,KAAK,KAAO;AAC5B,WAAO,GAAG,cAAc,IAAI,QAAQ,KAAO,QAAQ,CAAC,CAAC;AAAA,EACvD;AACA,SAAO,GAAG,cAAc,GAAG,MAAM,QAAQ,CAAC,CAAC;AAC7C;AAEO,SAAS,mBAAmB,OAAgB,WAAW,MAAc;AAC1E,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,QAAM,MAAM,OAAO,KAAK;AACxB,MAAI,CAAC,OAAO,SAAS,GAAG,EAAG,QAAO;AAClC,SAAO,eAAe,GAAG;AAC3B;",
+  "names": []
+}