@fayz-ai/plugin-reports 0.9.1 → 0.11.0

package/dist/index.js

@@ -1,8 +1,9 @@
-import { reportColumnsToTanstack, formatValuePlain } from './chunk-2ZFN6ECM.js';
-import * as React4 from 'react';
-import React4__default, { useState, useEffect } from 'react';
+import { reportColumnsToTanstack, formatValuePlain } from './chunk-4SPBNVQA.js';
+import * as React6 from 'react';
+import React6__default, { useState, useEffect } from 'react';
 import { usePluginRuntime, getAnalyticsCards, registerTranslations, createSafeDataProvider, getSupabaseClientOptional, hashRouterAdapter, useTranslation, exportCSV } from '@fayz-ai/core';
-import { AnalyticsContextProvider, collectFilters, AnalyticsControls, AnalyticsGrid, Card, FilterChip, DataTable, Button, SubpageHeader, useAnalyticsCard, useAnalyticsContext, AnalyticsCard, Dropdown, DropdownTrigger, DropdownContent, DropdownItem } from '@fayz-ai/ui';
+import { useOrganizationStore, useShellRailAvailable, useContextualNav, AssistantInvite } from '@fayz-ai/admin';
+import { AnalyticsContextProvider, useModuleLayout, ModulePage, collectFilters, AnalyticsControls, AnalyticsGrid, Card, FilterChip, DataTable, Button, SubpageHeader, useAnalyticsCard, useAnalyticsContext, AnalyticsCard, Dropdown, DropdownTrigger, DropdownContent, DropdownItem } from '@fayz-ai/ui';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { BarChart3, User, Search, ArrowLeft, Printer, Construction, Download, Radio, ChevronLeft, ChevronRight } from 'lucide-react';
 
@@ -59,10 +60,10 @@ function matchesFilters(row, filters) {
 function inRange(row, dateColumn, from, to) {
   const raw = row[dateColumn];
   if (raw == null) return true;
-  const t2 = new Date(String(raw)).getTime();
-  if (Number.isNaN(t2)) return true;
-  if (from && t2 < (/* @__PURE__ */ new Date(`${from}T00:00:00`)).getTime()) return false;
-  if (to && t2 > (/* @__PURE__ */ new Date(`${to}T23:59:59.999`)).getTime()) return false;
+  const t = new Date(String(raw)).getTime();
+  if (Number.isNaN(t)) return true;
+  if (from && t < (/* @__PURE__ */ new Date(`${from}T00:00:00`)).getTime()) return false;
+  if (to && t > (/* @__PURE__ */ new Date(`${to}T23:59:59.999`)).getTime()) return false;
   return true;
 }
 function applyMeasure(rows, agg, column) {
@@ -163,7 +164,7 @@ function reservedKeys(card) {
   ]);
 }
 function searchColumns(card) {
-  const cols = (card.columns ?? []).filter((c) => c.type === "text" || c.type === "email").map((c) => c.key);
+  const cols = (card.columns ?? []).filter((c) => c.type === "text" || c.type === "email" || c.type === "person").map((c) => c.key);
   return cols.length ? cols : void 0;
 }
 function camelToSnake(s) {
@@ -204,6 +205,61 @@ async function selectFromView(card, state, db, tenantId, reserved) {
     total: count ?? 0
   };
 }
+function toError(err) {
+  if (err instanceof Error) return err;
+  if (err && typeof err === "object") {
+    const e = err;
+    const message = [...new Set(
+      [e.message, e.details, e.hint].filter(
+        (part) => typeof part === "string" && part.trim().length > 0
+      )
+    )].join(" \u2014 ");
+    if (message) return Object.assign(new Error(message), e.code ? { code: e.code } : {});
+  }
+  return new Error(String(err));
+}
+function isAggregateCard(card) {
+  const { source } = card.query;
+  if (source.kind !== "view" || !source.name) return false;
+  return (card.query.dimensions?.length ?? 0) > 0 || (card.query.measures?.length ?? 0) > 0;
+}
+function runArgs(card, state, tenantId) {
+  const size = state.pageSize || 50;
+  const snapshot = card.query.dateColumn === null;
+  return {
+    source: card.query.source.name,
+    tenant_id: tenantId ?? null,
+    from: !snapshot && state.dateRange.from ? `${state.dateRange.from}T00:00:00` : null,
+    // Inclusive end-of-day: the range picker speaks in days, the column is a
+    // timestamp, and closing at midnight loses everything sold that day.
+    to: !snapshot && state.dateRange.to ? `${state.dateRange.to}T23:59:59.999` : null,
+    dimensions: (card.query.dimensions ?? []).map((d) => ({
+      key: d.key,
+      ...d.grain && d.grain !== "auto" ? { grain: d.grain } : {}
+    })),
+    measures: (card.query.measures ?? []).filter((m) => m.agg !== "ratio").map((m) => ({ key: m.key, agg: m.agg, ...m.column ? { column: m.column } : {} })),
+    filters: state.filters ?? {},
+    search: state.search ?? null,
+    search_columns: searchColumns(card) ?? null,
+    sort: state.sortBy ?? card.query.defaultSort ?? null,
+    dir: state.sortDir ?? card.query.defaultSortDir ?? "desc",
+    limit: card.query.limit ?? size,
+    offset: card.query.limit ? 0 : ((state.page || 1) - 1) * size
+  };
+}
+function toResult(data, card, reserved) {
+  const rows = data?.rows ?? [];
+  return {
+    rows: rows.map((r) => mapRow(r, reserved, card.query.source.columnMap)),
+    total: data?.total ?? rows.length,
+    summary: data?.summary ?? void 0
+  };
+}
+function batchUnavailable(err) {
+  const code = typeof err?.code === "string" ? err.code : "";
+  if (["42883", "PGRST202"].includes(code)) return true;
+  return typeof err?.message === "string" && err.message.includes("analytics_run_batch");
+}
 function createSupabaseAnalyticsProvider(config) {
   const resolveTenantId = () => (typeof config.tenantId === "function" ? config.tenantId() : config.tenantId) || void 0;
   function client() {
@@ -211,18 +267,19 @@ function createSupabaseAnalyticsProvider(config) {
     if (!supabase) throw new Error("Supabase client not available");
     return config.schema && config.schema !== "public" ? supabase.schema(config.schema) : supabase;
   }
+  let batchSupported = true;
   return {
     async run(card, state) {
       const { source } = card.query;
       const reserved = reservedKeys(card);
       if (source.kind === "fn") {
         if (!source.run) throw new Error(`analytics: card ${card.id} declares kind 'fn' with no run()`);
-        const rows2 = await source.run({
+        const rows = await source.run({
           tenantId: resolveTenantId(),
           dateRange: state.dateRange,
           filters: state.filters
         });
-        return aggregateRows(rows2, card, state);
+        return aggregateRows(rows, card, state);
       }
       if (!source.name) throw new Error(`analytics: card ${card.id} has no source name`);
       const isDetail = (card.query.dimensions?.length ?? 0) === 0 && (card.query.measures?.length ?? 0) === 0;
@@ -237,42 +294,80 @@ function createSupabaseAnalyticsProvider(config) {
           ...Object.fromEntries(Object.entries(state.filters ?? {}).map(([k, v]) => [`p_${k}`, v]))
         });
         if (error2) throw error2;
-        const rows2 = Array.isArray(data2) ? data2 : data2?.rows ?? [];
+        const rows = Array.isArray(data2) ? data2 : data2?.rows ?? [];
         return {
-          rows: rows2.map((r) => mapRow(r, reserved, source.columnMap)),
-          total: Array.isArray(data2) ? rows2.length : data2?.total ?? rows2.length,
+          rows: rows.map((r) => mapRow(r, reserved, source.columnMap)),
+          total: Array.isArray(data2) ? rows.length : data2?.total ?? rows.length,
           summary: Array.isArray(data2) ? void 0 : data2?.summary
         };
       }
-      const size = state.pageSize || 50;
-      const snapshot = card.query.dateColumn === null;
+      const args = runArgs(card, state, resolveTenantId());
       const { data, error } = await client().rpc("analytics_run", {
-        p_source: source.name,
-        p_tenant_id: resolveTenantId() ?? null,
-        p_from: !snapshot && state.dateRange.from ? `${state.dateRange.from}T00:00:00` : null,
-        // Inclusive end-of-day: the range picker speaks in days, the column is
-        // a timestamp, and closing at midnight loses everything sold that day.
-        p_to: !snapshot && state.dateRange.to ? `${state.dateRange.to}T23:59:59.999` : null,
-        p_dimensions: (card.query.dimensions ?? []).map((d) => ({
-          key: d.key,
-          ...d.grain && d.grain !== "auto" ? { grain: d.grain } : {}
-        })),
-        p_measures: (card.query.measures ?? []).filter((m) => m.agg !== "ratio").map((m) => ({ key: m.key, agg: m.agg, ...m.column ? { column: m.column } : {} })),
-        p_filters: state.filters ?? {},
-        p_search: state.search ?? null,
-        p_search_columns: searchColumns(card) ?? null,
-        p_sort: state.sortBy ?? card.query.defaultSort ?? null,
-        p_dir: state.sortDir ?? card.query.defaultSortDir ?? "desc",
-        p_limit: card.query.limit ?? size,
-        p_offset: card.query.limit ? 0 : ((state.page || 1) - 1) * size
+        p_source: args.source,
+        p_tenant_id: args.tenant_id,
+        p_from: args.from,
+        p_to: args.to,
+        p_dimensions: args.dimensions,
+        p_measures: args.measures,
+        p_filters: args.filters,
+        p_search: args.search,
+        p_search_columns: args.search_columns,
+        p_sort: args.sort,
+        p_dir: args.dir,
+        p_limit: args.limit,
+        p_offset: args.offset
       });
       if (error) throw error;
-      const rows = data?.rows ?? [];
-      return {
-        rows: rows.map((r) => mapRow(r, reserved, source.columnMap)),
-        total: data?.total ?? rows.length,
-        summary: data?.summary ?? void 0
-      };
+      return toResult(data, card, reserved);
+    },
+    // -----------------------------------------------------------------------
+    // The batched path.
+    //
+    // Every aggregate card in the batch becomes ONE analytics_run_batch call;
+    // detail listings and 'fn' cards, which the batch function cannot express,
+    // still go one by one — but a dashboard is all aggregates, so opening
+    // /analytics went from forty-one requests to one.
+    //
+    // Results keep their INDEX. The caller matched a promise to a position, and
+    // returning a compacted array would silently hand card 7 card 9's numbers.
+    // -----------------------------------------------------------------------
+    async runMany(requests) {
+      const out = new Array(requests.length);
+      const batchable = [];
+      for (let i = 0; i < requests.length; i++) {
+        if (batchSupported && isAggregateCard(requests[i].card)) batchable.push(i);
+      }
+      const singles = requests.map((req, i) => ({ req, i })).filter(({ i }) => !batchable.includes(i)).map(({ req, i }) => this.run(req.card, req.state).then((r) => {
+        out[i] = r;
+      }).catch((e) => {
+        out[i] = toError(e);
+      }));
+      if (batchable.length > 0) {
+        const tenantId = resolveTenantId();
+        const payload = batchable.map((i) => runArgs(requests[i].card, requests[i].state, tenantId));
+        const { data, error } = await client().rpc("analytics_run_batch", { p_requests: payload });
+        if (error && batchUnavailable(error)) {
+          batchSupported = false;
+          await Promise.all([
+            ...singles,
+            ...batchable.map((i) => this.run(requests[i].card, requests[i].state).then((r) => {
+              out[i] = r;
+            }).catch((e) => {
+              out[i] = toError(e);
+            }))
+          ]);
+          return out;
+        }
+        if (error) throw error;
+        const results = Array.isArray(data) ? data : [];
+        batchable.forEach((cardIndex, slot) => {
+          const entry = results[slot];
+          const { card } = requests[cardIndex];
+          out[cardIndex] = entry?.error ? Object.assign(toError(entry.error), { code: entry.code }) : toResult(entry, card, reservedKeys(card));
+        });
+      }
+      await Promise.all(singles);
+      return out;
     }
   };
 }
@@ -286,10 +381,10 @@ function seeded(seed) {
   }
   return () => {
     h += 1831565813;
-    let t2 = h;
-    t2 = Math.imul(t2 ^ t2 >>> 15, t2 | 1);
-    t2 ^= t2 + Math.imul(t2 ^ t2 >>> 7, t2 | 61);
-    return ((t2 ^ t2 >>> 14) >>> 0) / 4294967296;
+    let t = h;
+    t = Math.imul(t ^ t >>> 15, t | 1);
+    t ^= t + Math.imul(t ^ t >>> 7, t | 61);
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
   };
 }
 var SAMPLE_LABELS = {
@@ -338,21 +433,37 @@ function createMockAnalyticsProvider() {
         return row;
       });
       return aggregateRows(rows, card, state);
+    },
+    // There is no transport to save a round trip on, so this is just the loop.
+    // It exists because the mock is reached through createSafeDataProvider,
+    // whose Proxy answers EVERY property with a function — `provider.runMany`
+    // is truthy even for a provider that never declared it, and the caller's
+    // feature check therefore cannot detect its absence. Implementing it is how
+    // the mock stops being a landmine behind that Proxy.
+    async runMany(requests) {
+      return Promise.all(requests.map((r) => this.run(r.card, r.state).catch((e) => e instanceof Error ? e : new Error(String(e)))));
     }
   };
 }
-
-// src/lib/tenant.ts
-var t;
+var override;
+function setReportsTenantId(id) {
+  override = id;
+}
 function getReportsTenantId() {
-  return t;
+  if (override) return override;
+  try {
+    return useOrganizationStore.getState().currentOrg?.id;
+  } catch {
+    return void 0;
+  }
 }
 
 // src/locales/en.ts
 var en = {
   "reports.pageTitle": "Reports",
   "reports.pageSubtitle": "Access complete reports for analysis and decision making",
-  "reports.allReports": "All Reports",
+  "reports.overview": "Overview",
+  "reports.allReports": "All reports",
   "reports.dateRange": "Date Range",
   "reports.from": "From",
   "reports.to": "To",
@@ -374,6 +485,17 @@ var en = {
   "reports.generate": "Generate",
   "reports.emptyStateTitle": "Ready to generate",
   "reports.emptyStateDescription": "Select a date range and filters, then click Generate to view the report.",
+  // The assistant's invitation on /analytics. It opens on a question, not on a
+  // grid: the numbers are already downstairs, and what the owner actually wants
+  // is to know what they mean.
+  "reports.assistant.persona": "Growth Analyst",
+  "reports.assistant.headline": "Hi {{name}}, what would you like to learn today?",
+  "reports.assistant.pitch": "Let's find the opportunities hiding in your business",
+  "reports.assistant.description": "Tell me your goals and I'll help build a plan to hit them. I read the same data these reports do, and I'll point at what changed and what to do about it.",
+  "reports.assistant.placeholder": "Build a custom report...",
+  "reports.assistant.suggestion.0": "How is my business doing this month?",
+  "reports.assistant.suggestion.1": "What's growing and what's falling?",
+  "reports.assistant.suggestion.2": "Where am I losing money?",
   "reports.unavailableTitle": "Coming soon",
   "reports.unavailableDescription": "This report is not available yet. It will be enabled in a future update."
 };
@@ -382,7 +504,8 @@ var en = {
 var ptBR = {
   "reports.pageTitle": "Relat\xF3rios",
   "reports.pageSubtitle": "Acesse relat\xF3rios completos para an\xE1lise e tomada de decis\xE3o",
-  "reports.allReports": "Todos os Relat\xF3rios",
+  "reports.overview": "Vis\xE3o geral",
+  "reports.allReports": "Todos os relat\xF3rios",
   "reports.dateRange": "Per\xEDodo",
   "reports.from": "De",
   "reports.to": "At\xE9",
@@ -404,6 +527,14 @@ var ptBR = {
   "reports.generate": "Gerar",
   "reports.emptyStateTitle": "Pronto para gerar",
   "reports.emptyStateDescription": "Selecione o per\xEDodo e os filtros desejados, depois clique em Gerar para visualizar o relat\xF3rio.",
+  "reports.assistant.persona": "Analista de Crescimento",
+  "reports.assistant.headline": "Oi {{name}}, o que voc\xEA quer entender hoje?",
+  "reports.assistant.pitch": "Vamos achar as oportunidades escondidas no seu neg\xF3cio",
+  "reports.assistant.description": "Me conte sua meta e eu ajudo a montar o plano para bater. Leio os mesmos dados destes relat\xF3rios e aponto o que mudou e o que fazer a respeito.",
+  "reports.assistant.placeholder": "Pe\xE7a um relat\xF3rio do seu jeito...",
+  "reports.assistant.suggestion.0": "Como est\xE1 meu neg\xF3cio neste m\xEAs?",
+  "reports.assistant.suggestion.1": "O que est\xE1 crescendo e o que est\xE1 caindo?",
+  "reports.assistant.suggestion.2": "Onde estou perdendo dinheiro?",
   "reports.unavailableTitle": "Em breve",
   "reports.unavailableDescription": "Este relat\xF3rio ainda n\xE3o est\xE1 dispon\xEDvel. Ser\xE1 habilitado em uma atualiza\xE7\xE3o futura."
 };
@@ -459,6 +590,7 @@ function reportDefToCard(report, createdBy) {
       sortable: c.sortable,
       currency: c.currency,
       idKey: c.idKey,
+      personKind: c.personKind,
       renderCell: c.renderCell,
       visible: c.visible,
       align: c.align,
@@ -493,8 +625,8 @@ function markViewed(cardId) {
   for (const listener of listeners) listener(next);
 }
 function useLastViewed() {
-  const [map, setMap] = React4.useState(() => read());
-  React4.useEffect(() => {
+  const [map, setMap] = React6.useState(() => read());
+  React6.useEffect(() => {
     listeners.add(setMap);
     return () => {
       listeners.delete(setMap);
@@ -504,16 +636,16 @@ function useLastViewed() {
 }
 var ANALYTICS_BASE = "/analytics";
 var REPORTS_BASE = `${ANALYTICS_BASE}/reports`;
-var ConfigContext = React4__default.createContext(null);
+var ConfigContext = React6__default.createContext(null);
 function useAnalyticsConfig() {
-  const ctx = React4__default.useContext(ConfigContext);
+  const ctx = React6__default.useContext(ConfigContext);
   if (!ctx) throw new Error("useAnalyticsConfig must be used inside <AnalyticsSurface>");
   return ctx;
 }
 function useAnalyticsCards() {
   const runtime = usePluginRuntime();
   const { cards, createdBy } = useAnalyticsConfig();
-  return React4__default.useMemo(() => {
+  return React6__default.useMemo(() => {
     const byId = /* @__PURE__ */ new Map();
     for (const card of getAnalyticsCards(runtime)) byId.set(card.id, card);
     for (const card of cards) byId.set(card.id, card);
@@ -522,7 +654,7 @@ function useAnalyticsCards() {
 }
 function useOverviewCards() {
   const all = useAnalyticsCards();
-  return React4__default.useMemo(
+  return React6__default.useMemo(
     () => all.filter((c) => c.dashboard && c.dashboard.defaultVisible !== false).sort((a, b) => (a.dashboard?.order ?? 0) - (b.dashboard?.order ?? 0)),
     [all]
   );
@@ -530,10 +662,14 @@ function useOverviewCards() {
 function cardColumns(card) {
   if (card.columns?.length) return card.columns;
   return [
-    ...(card.query.dimensions ?? []).map((d) => ({
+    // A hidden dimension is group-by only — the id a person column reads from,
+    // never a column of UUIDs next to the name it belongs to.
+    ...(card.query.dimensions ?? []).filter((d) => !d.hidden).map((d) => ({
       key: d.key,
       label: d.label,
-      type: d.format ?? (d.grain ? "date" : "text"),
+      type: d.person ? "person" : d.format ?? (d.grain ? "date" : "text"),
+      idKey: d.person?.idKey,
+      personKind: d.person?.kind,
       align: "left"
     })),
     ...(card.query.measures ?? []).map((m) => ({
@@ -549,7 +685,7 @@ function navigateAnalytics(path) {
   hashRouterAdapter().navigate(path);
 }
 function AnalyticsSurface({ config, provider, children }) {
-  const openCard = React4__default.useCallback((card) => {
+  const openCard = React6__default.useCallback((card) => {
     markViewed(card.id);
     navigateAnalytics(`${REPORTS_BASE}/${encodeURIComponent(card.id)}`);
   }, []);
@@ -567,22 +703,148 @@ function AnalyticsSurface({ config, provider, children }) {
     }
   ) });
 }
+function AnalyticsAssistant() {
+  const { assistant } = useAnalyticsConfig();
+  const t = useTranslation();
+  const suggestions = React6__default.useMemo(
+    () => assistant?.suggestions ?? [0, 1, 2].map((i) => ({ label: t(`reports.assistant.suggestion.${i}`) })),
+    [assistant?.suggestions, t]
+  );
+  if (!assistant) return null;
+  return /* @__PURE__ */ jsx(
+    AssistantInvite,
+    {
+      id: "analytics",
+      auto: assistant.auto ?? false,
+      persona: assistant.persona ?? t("reports.assistant.persona"),
+      headline: assistant.headline ?? t("reports.assistant.headline"),
+      pitch: assistant.pitch ?? t("reports.assistant.pitch"),
+      description: assistant.description ?? t("reports.assistant.description"),
+      placeholder: assistant.placeholder ?? t("reports.assistant.placeholder"),
+      suggestions
+    }
+  );
+}
+var reportRoute = (cardId) => `${REPORTS_BASE}/${encodeURIComponent(cardId)}`;
+function groupCards(cards) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const card of cards) {
+    const list = groups.get(card.category);
+    if (list) list.push(card);
+    else groups.set(card.category, [card]);
+  }
+  return [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([category, list]) => [category, [...list].sort((a, b) => a.name.localeCompare(b.name))]);
+}
+function useAnalyticsTree() {
+  const t = useTranslation();
+  const { labels, showLiveView } = useAnalyticsConfig();
+  const cards = useAnalyticsCards();
+  return React6__default.useMemo(() => ({
+    title: labels.analytics,
+    // Only the overview. The searchable catalogue (/analytics/reports) is still
+    // routed — bookmarks and the legacy /reports link resolve — but it is not
+    // listed: the tree below already IS the catalogue, and a link named "all
+    // reports" sitting above the reports reads as a different, fuller list.
+    fixed: [
+      { id: "overview", label: labels.overview ?? t("reports.overview"), icon: "BarChart3", route: ANALYTICS_BASE, view: "overview" }
+    ],
+    groups: groupCards(cards),
+    live: showLiveView ? { id: "live", label: labels.liveView, icon: "Radio", route: `${ANALYTICS_BASE}/live`, view: "live" } : null
+  }), [labels, showLiveView, cards, t]);
+}
+function AnalyticsModule({ view, cardId, children }) {
+  const variant = useModuleLayout();
+  const tree = useAnalyticsTree();
+  const activeId = cardId ? decodeURIComponent(cardId) : void 0;
+  const shellRail = useShellRailAvailable();
+  const claimsRail = shellRail ?? variant !== "rail";
+  const entries = React6__default.useMemo(() => [
+    ...tree.fixed.map((f) => ({
+      id: `analytics:${f.id}`,
+      label: f.label,
+      icon: f.icon,
+      route: f.route,
+      section: "main"
+    })),
+    ...tree.groups.flatMap(([category, list]) => list.map((card) => ({
+      id: `analytics:${card.id}`,
+      label: card.name,
+      icon: card.icon ?? "FileText",
+      route: reportRoute(card.id),
+      section: "main",
+      // Consecutive items sharing a group render under one heading — the same
+      // mechanism that heads the settings rail's plugin runs.
+      group: category
+    }))),
+    ...tree.live ? [{
+      id: "analytics:live",
+      label: tree.live.label,
+      icon: tree.live.icon,
+      route: tree.live.route,
+      section: "main"
+    }] : []
+  ], [tree]);
+  useContextualNav(claimsRail ? { base: ANALYTICS_BASE, entries, label: tree.title } : null);
+  const nav = React6__default.useMemo(() => {
+    if (claimsRail) return [];
+    return [
+      ...tree.fixed.map((f) => ({
+        id: f.id,
+        label: f.label,
+        icon: f.icon,
+        active: view === f.view,
+        onClick: () => navigateAnalytics(f.route)
+      })),
+      ...tree.groups.map(([category, list]) => ({
+        id: `group:${category}`,
+        label: category,
+        children: list.map((card) => ({
+          id: card.id,
+          label: card.name,
+          active: view === "report" && card.id === activeId,
+          onClick: () => navigateAnalytics(reportRoute(card.id))
+        }))
+      })),
+      ...tree.live ? [{
+        id: tree.live.id,
+        label: tree.live.label,
+        icon: tree.live.icon,
+        active: view === "live",
+        onClick: () => navigateAnalytics(tree.live.route)
+      }] : []
+    ];
+  }, [tree, view, activeId, claimsRail]);
+  return /* @__PURE__ */ jsxs(
+    ModulePage,
+    {
+      title: tree.title,
+      nav,
+      navVariant: claimsRail ? "sidebar" : "rail",
+      showHeader: false,
+      viewKey: view === "report" ? `report:${activeId}` : view,
+      children: [
+        /* @__PURE__ */ jsx(AnalyticsAssistant, {}),
+        /* @__PURE__ */ jsx("div", { className: "md:pb-16", children })
+      ]
+    }
+  );
+}
 function AnalyticsOverview() {
   const { labels, showHeader } = useAnalyticsConfig();
   const cards = useOverviewCards();
-  const filters = React4__default.useMemo(() => collectFilters(cards), [cards]);
-  return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+  const filters = React6__default.useMemo(() => collectFilters(cards), [cards]);
+  return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
     showHeader ? /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx("h1", { className: "text-2xl font-semibold tracking-tight", children: labels.analytics }),
       /* @__PURE__ */ jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: labels.overviewSubtitle })
     ] }) : null,
-    /* @__PURE__ */ jsx(AnalyticsControls, { filters, className: "sticky top-0 z-10 -mx-1 bg-background/95 px-1 py-2 backdrop-blur" }),
+    /* @__PURE__ */ jsx(AnalyticsControls, { filters, className: "sticky top-3 z-20" }),
     cards.length === 0 ? /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center justify-center rounded-xl border border-dashed py-16 text-center", children: [
       /* @__PURE__ */ jsx("div", { className: "mb-4 flex h-12 w-12 items-center justify-center rounded-full bg-muted", children: /* @__PURE__ */ jsx(BarChart3, { className: "h-5 w-5 text-muted-foreground" }) }),
       /* @__PURE__ */ jsx("p", { className: "font-medium", children: labels.emptyOverviewTitle }),
       /* @__PURE__ */ jsx("p", { className: "mt-1 max-w-sm text-sm text-muted-foreground", children: labels.emptyOverviewDescription })
     ] }) : /* @__PURE__ */ jsx(AnalyticsGrid, { cards })
-  ] });
+  ] }) });
 }
 function formatViewed(iso, locale, never) {
   if (!iso) return never;
@@ -594,18 +856,18 @@ function ReportsListPage() {
   const { labels, currency, showHeader } = useAnalyticsConfig();
   const cards = useAnalyticsCards();
   const lastViewed = useLastViewed();
-  const [search, setSearch] = React4__default.useState("");
-  const [category, setCategory] = React4__default.useState();
-  const [author, setAuthor] = React4__default.useState();
-  const categoryOptions = React4__default.useMemo(
+  const [search, setSearch] = React6__default.useState("");
+  const [category, setCategory] = React6__default.useState();
+  const [author, setAuthor] = React6__default.useState();
+  const categoryOptions = React6__default.useMemo(
     () => [...new Set(cards.map((c) => c.category))].sort((a, b) => a.localeCompare(b)).map((c) => ({ value: c, label: c })),
     [cards]
   );
-  const authorOptions = React4__default.useMemo(
+  const authorOptions = React6__default.useMemo(
     () => [...new Set(cards.map((c) => c.createdBy ?? "\u2014"))].sort((a, b) => a.localeCompare(b)).map((a) => ({ value: a, label: a })),
     [cards]
   );
-  const rows = React4__default.useMemo(() => {
+  const rows = React6__default.useMemo(() => {
     const q = search.trim().toLowerCase();
     return cards.filter((card) => {
       if (category && card.category !== category) return false;
@@ -614,7 +876,7 @@ function ReportsListPage() {
       return card.name.toLowerCase().includes(q) || card.description?.toLowerCase().includes(q) || card.category.toLowerCase().includes(q);
     });
   }, [cards, search, category, author]);
-  const columns = React4__default.useMemo(() => [
+  const columns = React6__default.useMemo(() => [
     {
       id: "name",
       accessorFn: (card) => card.name,
@@ -730,33 +992,33 @@ function exportToCsv(columns, data, filename, currency) {
   exportCSV(csvColumns, data, filename);
 }
 function ExportDropdown({ columns, data, filename, currency, title }) {
-  const t2 = useTranslation();
+  const t = useTranslation();
   const [excelAvailable, setExcelAvailable] = useState(false);
   const [pdfAvailable, setPdfAvailable] = useState(false);
   useEffect(() => {
-    import('./excel-WE73YE2V.js').then((m) => m.isExcelAvailable()).then(setExcelAvailable).catch(() => {
+    import('./excel-KIJTC7OJ.js').then((m) => m.isExcelAvailable()).then(setExcelAvailable).catch(() => {
     });
-    import('./pdf-E6DXHFXU.js').then((m) => m.isPdfAvailable()).then(setPdfAvailable).catch(() => {
+    import('./pdf-7QQ3U5JQ.js').then((m) => m.isPdfAvailable()).then(setPdfAvailable).catch(() => {
     });
   }, []);
   const handleCsv = () => exportToCsv(columns, data, filename, currency);
   const handleExcel = async () => {
-    const { exportToExcel } = await import('./excel-WE73YE2V.js');
+    const { exportToExcel } = await import('./excel-KIJTC7OJ.js');
     await exportToExcel(columns, data, filename, currency);
   };
   const handlePdf = async () => {
-    const { exportToPdf } = await import('./pdf-E6DXHFXU.js');
+    const { exportToPdf } = await import('./pdf-7QQ3U5JQ.js');
     await exportToPdf(columns, data, filename, { title, currency });
   };
   return /* @__PURE__ */ jsxs(Dropdown, { children: [
     /* @__PURE__ */ jsx(DropdownTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", children: [
       /* @__PURE__ */ jsx(Download, { className: "h-4 w-4 mr-1.5" }),
-      t2("reports.export")
+      t("reports.export")
     ] }) }),
     /* @__PURE__ */ jsxs(DropdownContent, { align: "end", children: [
-      /* @__PURE__ */ jsx(DropdownItem, { onClick: handleCsv, children: t2("reports.exportCsv") }),
-      excelAvailable && /* @__PURE__ */ jsx(DropdownItem, { onClick: handleExcel, children: t2("reports.exportExcel") }),
-      pdfAvailable && /* @__PURE__ */ jsx(DropdownItem, { onClick: handlePdf, children: t2("reports.exportPdf") })
+      /* @__PURE__ */ jsx(DropdownItem, { onClick: handleCsv, children: t("reports.exportCsv") }),
+      excelAvailable && /* @__PURE__ */ jsx(DropdownItem, { onClick: handleExcel, children: t("reports.exportExcel") }),
+      pdfAvailable && /* @__PURE__ */ jsx(DropdownItem, { onClick: handlePdf, children: t("reports.exportPdf") })
     ] })
   ] });
 }
@@ -813,8 +1075,8 @@ function ViewerBody({ card }) {
   const { labels, currency } = useAnalyticsConfig();
   const { state, setPage, setPageSize } = useAnalyticsContext();
   const { result, loading, error, engineMissing } = useAnalyticsCard(card);
-  const columns = React4__default.useMemo(() => cardColumns(card), [card]);
-  const tanstackColumns = React4__default.useMemo(
+  const columns = React6__default.useMemo(() => cardColumns(card), [card]);
+  const tanstackColumns = React6__default.useMemo(
     () => reportColumnsToTanstack(columns, currency.code),
     [columns, currency.code]
   );
@@ -871,7 +1133,7 @@ function AnalyticsReportViewer({ cardId }) {
   const { labels } = useAnalyticsConfig();
   const cards = useAnalyticsCards();
   const card = cards.find((c) => c.id === decodeURIComponent(cardId ?? ""));
-  React4__default.useEffect(() => {
+  React6__default.useEffect(() => {
     if (card) markViewed(card.id);
   }, [card?.id]);
   if (!card) {
@@ -888,8 +1150,8 @@ function AnalyticsReportViewer({ cardId }) {
       SubpageHeader,
       {
         title: card.name,
-        parentLabel: labels.reports,
-        onBack: () => navigateAnalytics(REPORTS_BASE)
+        parentLabel: labels.analytics,
+        onBack: () => navigateAnalytics(ANALYTICS_BASE)
       }
     ),
     card.description ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: card.description }) : null,
@@ -908,7 +1170,7 @@ function AnalyticsReportViewer({ cardId }) {
 function ViewerActions({ card }) {
   const { currency } = useAnalyticsConfig();
   const { result } = useAnalyticsCard(card);
-  const columns = React4__default.useMemo(() => cardColumns(card), [card]);
+  const columns = React6__default.useMemo(() => cardColumns(card), [card]);
   if (!result?.rows?.length) return null;
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(
@@ -996,7 +1258,7 @@ async function fetchViaView(reportDef, query, getClient, resolveTenantId, tenant
     }
   }
   if (query.search) {
-    const searchableCols = reportDef.columns.filter((c) => c.type === "text" || c.type === "email").map((c) => camelToSnake2(c.key));
+    const searchableCols = reportDef.columns.filter((c) => c.type === "text" || c.type === "email" || c.type === "person").map((c) => camelToSnake2(c.key));
     if (searchableCols.length > 0) {
       const term = `%${query.search}%`;
       const orClause = searchableCols.map((col) => `${col}.ilike.${term}`).join(",");
@@ -1099,7 +1361,9 @@ function resolveConfig(options) {
     defaultPageSize: options.defaultPageSize ?? 50,
     showHeader: options.showHeader === true,
     defaultRange: options.defaultRange ?? "last_30_days",
-    defaultCompare: options.defaultCompare ?? "previous_period"
+    defaultCompare: options.defaultCompare ?? "previous_period",
+    showLiveView: options.showLiveView === true,
+    assistant: options.assistant === false ? null : options.assistant ?? {}
   };
 }
 function createAnalyticsPlugin(options = {}) {
@@ -1109,10 +1373,14 @@ function createAnalyticsPlugin(options = {}) {
     () => createSupabaseAnalyticsProvider({ tenantId: () => getReportsTenantId() }),
     () => createMockAnalyticsProvider()
   );
-  const page2 = (Body) => (props) => React4__default.createElement(
+  const page2 = (Body, view) => (props) => React6__default.createElement(
     AnalyticsSurface,
     { config, provider },
-    React4__default.createElement(Body, props)
+    React6__default.createElement(
+      AnalyticsModule,
+      { view, cardId: props?.cardId },
+      React6__default.createElement(Body, props)
+    )
   );
   const READ = { feature: "reports", action: "read" };
   const position = options.navPosition ?? 9;
@@ -1125,23 +1393,7 @@ function createAnalyticsPlugin(options = {}) {
       route: ANALYTICS_BASE,
       icon: "BarChart3",
       permission: READ
-    },
-    {
-      section,
-      position: position + 0.1,
-      label: config.labels.reports,
-      route: REPORTS_BASE,
-      icon: "FileText",
-      permission: READ
-    },
-    ...options.showLiveView ? [{
-      section,
-      position: position + 0.2,
-      label: config.labels.liveView,
-      route: `${ANALYTICS_BASE}/live`,
-      icon: "Radio",
-      permission: READ
-    }] : []
+    }
   ];
   return {
     id: "reports",
@@ -1157,8 +1409,8 @@ function createAnalyticsPlugin(options = {}) {
     ],
     navigation: nav,
     routes: [
-      { path: ANALYTICS_BASE, component: page2(AnalyticsOverview), permission: READ },
-      { path: REPORTS_BASE, component: page2(ReportsListPage), permission: READ },
+      { path: ANALYTICS_BASE, component: page2(AnalyticsOverview, "overview"), permission: READ },
+      { path: REPORTS_BASE, component: page2(ReportsListPage, "reports"), permission: READ },
       // Registered before the list would ever shadow it: matchRoute scores
       // static segments above params, so /analytics/reports still wins its own
       // exact path and only /analytics/reports/<id> lands here.
@@ -1166,14 +1418,17 @@ function createAnalyticsPlugin(options = {}) {
       // (the card's name), so it claims the shell bar itself via PageHeader.
       // Declaring both gave the page two stacked back-crumbs saying the same
       // thing, one of them generic.
-      { path: `${REPORTS_BASE}/:cardId`, component: page2(AnalyticsReportViewer), permission: READ },
-      { path: `${ANALYTICS_BASE}/live`, component: page2(LiveViewPage), permission: READ },
+      { path: `${REPORTS_BASE}/:cardId`, component: page2(AnalyticsReportViewer, "report"), permission: READ },
+      { path: `${ANALYTICS_BASE}/live`, component: page2(LiveViewPage, "live"), permission: READ },
       // The old top-level route kept as a redirect target: bookmarks, saved
       // links and the five apps still pointing at /reports must not 404.
-      { path: "/reports", component: page2(ReportsListPage), permission: READ }
+      { path: "/reports", component: page2(ReportsListPage, "reports"), permission: READ }
     ],
     widgets: [],
     registries: [],
+    // Measurement, not acquisition — what the Fayz plugin page lists for
+    // Analytics.
+    integrations: ["google-analytics", "hotjar"],
     locales: reportsLocales
   };
 }
@@ -1194,6 +1449,6 @@ function createReportsPlugin(options) {
   });
 }
 
-export { ANALYTICS_BASE, AnalyticsOverview, AnalyticsReportViewer, AnalyticsSurface, REPORTS_BASE, ReportsListPage, aggregateRows, cardColumns, createAnalyticsPlugin, createMockAnalyticsProvider, createMockReportProvider, createReportsPlugin, createSupabaseAnalyticsProvider, createSupabaseReportProvider, markViewed, reportDefToCard, reportDefsToCards, useAnalyticsCards, useAnalyticsConfig, useLastViewed, useOverviewCards };
+export { ANALYTICS_BASE, AnalyticsModule, AnalyticsOverview, AnalyticsReportViewer, AnalyticsSurface, REPORTS_BASE, ReportsListPage, aggregateRows, cardColumns, createAnalyticsPlugin, createMockAnalyticsProvider, createMockReportProvider, createReportsPlugin, createSupabaseAnalyticsProvider, createSupabaseReportProvider, getReportsTenantId, markViewed, reportDefToCard, reportDefsToCards, setReportsTenantId, useAnalyticsCards, useAnalyticsConfig, useLastViewed, useOverviewCards };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map