hazo_umetrics 1.6.2 → 1.7.0

package/CHANGE_LOG.md

@@ -1,5 +1,41 @@
 # hazo_umetrics — Change Log
 
+## 1.7.0 — Search query analytics: `searchQueries`, `SearchQueriesPanel`, `getIdentity`
+
+**New features (minor — no breaking changes):**
+
+### `getIdentity()` — exported client identity accessor
+
+- New export from `hazo_umetrics/client`: `getIdentity(): { session_id: string; user_id: string | null }`.
+- Lets consumers attribute custom events with the SDK's tracked identity without going through `useMetrics`.
+
+### `searchQueries()` — server-side search aggregation
+
+- New function in `src/server/behavior.ts`: `searchQueries(adapter, opts)`.
+- Reads `action.search` rows; returns `SearchQueriesResult` with: `total_searches`, `unique_terms`, `unique_searchers`, `zero_result_searches`, `top_terms` (ranked by count), `zero_result_terms` (content gaps — searches with `result_count === 0`), `over_time` (per-day buckets), `per_user` (rows with real `user_id`).
+- Term normalization: `.trim().toLowerCase()` for tallying; first-seen casing preserved for display.
+- `result_count` missing ≠ zero; only explicit `0` counts as zero-result.
+
+### `getSearchQueries` API handler
+
+- Added to `createBehaviorHandlers`: `GET analytics/search-queries?app_id=…[&since=…][&top_n=…][&user_ids=…]`.
+- Gates on `metrics.view`; returns `{ ok: true, data: SearchQueriesResult }`.
+
+### `SearchQueriesPanel` — admin UI panel
+
+- New client component exported from `hazo_umetrics/ui`: `SearchQueriesPanel({ appId, apiBase, since?, resolveUserProfiles? })`.
+- Renders summary cards (total searches, unique terms, unique searchers, zero-result count), top-terms mini-bar chart, zero-result terms section (amber highlight — content gaps), searches-over-time day bars, and per-user table with optional profile resolution.
+
+## 1.6.4 — Fix: empty `datapoint_schema` hid all datapoint dimensions
+
+**Fix (patch — no breaking changes):**
+
+### `datapointStats` treated an empty schema array as "restrict to zero keys"
+
+- `getDatapoints` passes the action's `datapoint_schema` as `opts.schema`. For actions with no declared schema this is `[]`, which is truthy — so `datapointStats` built an empty `schemaKeys` Set and then filtered out **every** discovered dimension via `if (schemaKeys && !schemaKeys.has(k)) continue`.
+- Result: any action without an explicit schema showed "No datapoint dimensions found" even when its events carried non-reserved dimensions (e.g. `timer`, `duration_bucket`).
+- Now an empty/absent schema means "no constraint — surface all discovered dimensions"; a non-empty schema still restricts to the declared keys.
+
 ## 1.5.1 — `ui.pageexit.*` rename, smart auto-labels, `defaultActionLabels`, `ActionsPanel.refreshTrigger`
 
 **Fixes / improvements (patch — no breaking changes for new installs; existing `ui.dwell.*` catalog rows need re-seeding):**

package/dist/api/index.d.ts

@@ -178,5 +178,10 @@ export declare function createBehaviorHandlers(options: ApiFactoryOptions): {
      * Returns user journey sessions and aggregated graph. Requires metrics.view.
      */
     getJourney(req: Request): Promise<Response>;
+    /**
+     * GET /...?app_id=<id>[&since=<iso>][&top_n=<n>][&user_ids=<csv>]
+     * Returns search query analytics. Requires metrics.view.
+     */
+    getSearchQueries(req: Request): Promise<Response>;
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"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"}

package/dist/api/index.js

@@ -9,7 +9,7 @@ import { recordStat as _recordStat, getLatestStat as _getLatestStat, getStatSeri
 import { resolveVariant } from '../server/flags.js';
 import { getActivitySummary as _getActivitySummary, getActivityTrend as _getActivityTrend, } from '../server/activity.js';
 import { ensureActionDef as _ensureActionDef, listActions as _listActions, getActionTree as _getActionTree, updateActionDef as _updateActionDef, updateActionDefBulk as _updateActionDefBulk, applyLinksBulk as _applyLinksBulk, getLinks as _getLinks, addLink as _addLink, removeLink as _removeLink, } from '../server/actions.js';
-import { topActions as _topActions, firstSessionActions as _firstSessionActions, postReloginActions as _postReloginActions, actionsBeforeGoal as _actionsBeforeGoal, topErrors as _topErrors, tabDwell as _tabDwell, frequentActionsReturning as _frequentActionsReturning, eventsOverTime as _eventsOverTime, datapointStats as _datapointStats, userJourney as _userJourney, } from '../server/behavior.js';
+import { topActions as _topActions, firstSessionActions as _firstSessionActions, postReloginActions as _postReloginActions, actionsBeforeGoal as _actionsBeforeGoal, topErrors as _topErrors, tabDwell as _tabDwell, frequentActionsReturning as _frequentActionsReturning, eventsOverTime as _eventsOverTime, datapointStats as _datapointStats, userJourney as _userJourney, searchQueries as _searchQueries, } from '../server/behavior.js';
 // ---------------------------------------------------------------------------
 // Default auth — dynamically imports hazo_auth/server-lib to avoid the
 // server-only guard firing at module-evaluation time (e.g. in test runners).
@@ -859,6 +859,8 @@ export function createBehaviorHandlers(options) {
             const user_id = url.searchParams.get('user_id') ?? undefined;
             const session_id = url.searchParams.get('session_id') ?? undefined;
             const since = url.searchParams.get('since') ?? undefined;
+            const splitByPage = url.searchParams.get('split_by_page') === '1';
+            const pageFlow = url.searchParams.get('page_flow') === '1';
             const gate = await gateAuth(req, {
                 required_permissions: ['metrics.view'],
                 app_id: app_id || undefined,
@@ -871,7 +873,32 @@ export function createBehaviorHandlers(options) {
             const adapter = await options.getAdapter();
             const catalog = await _listActions(adapter, { app_id });
             const catalogMap = new Map(catalog.map((a) => [a.action_key, { label: a.label, datapoint_schema: a.datapoint_schema }]));
-            const result = await _userJourney(adapter, { app_id, user_id, session_id, since, catalogMap });
+            const result = await _userJourney(adapter, { app_id, user_id, session_id, since, catalogMap, splitByPage, pageFlow });
+            return jsonOk(result);
+        },
+        /**
+         * GET /...?app_id=<id>[&since=<iso>][&top_n=<n>][&user_ids=<csv>]
+         * Returns search query analytics. Requires metrics.view.
+         */
+        async getSearchQueries(req) {
+            const url = new URL(req.url);
+            const app_id = url.searchParams.get('app_id') ?? '';
+            const since = url.searchParams.get('since') ?? undefined;
+            const topNParam = url.searchParams.get('top_n');
+            const topN = topNParam != null ? parseInt(topNParam, 10) : undefined;
+            const userIdsParam = url.searchParams.get('user_ids');
+            const userIds = userIdsParam ? userIdsParam.split(',').filter(Boolean) : undefined;
+            const gate = await gateAuth(req, {
+                required_permissions: ['metrics.view'],
+                app_id: app_id || undefined,
+                getAuth,
+            });
+            if (!gate.ok)
+                return gate.response;
+            if (!app_id)
+                return jsonError('BAD_REQUEST', 'app_id is required', 400);
+            const adapter = await options.getAdapter();
+            const result = await _searchQueries(adapter, { app_id, since, topN, userIds });
             return jsonOk(result);
         },
     };

package/dist/index.client.d.ts

@@ -18,6 +18,10 @@ export declare function useMetrics(): MetricsContextValue;
 export declare function getVariant(serverVariant: string): string;
 export declare function isEnabled(serverVariant: string): boolean;
 export declare function identify(userId: string): void;
+export declare function getIdentity(): {
+    session_id: string;
+    user_id: string | null;
+};
 export declare function recordStat(_key: string, _value: number, _opts?: {
     unit?: string;
 }): void;

package/dist/index.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../src/index.client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAoD1B,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACjF,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1G,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAClE;AASD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,wBAAwB,4EAsJxF;AAMD,wBAAgB,UAAU,IAAI,mBAAmB,CAEhD;AAMD,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAExF"}
+{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../src/index.client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAoD1B,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACjF,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1G,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAClE;AASD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,wBAAwB,4EAsJxF;AAMD,wBAAgB,UAAU,IAAI,mBAAmB,CAEhD;AAMD,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED,wBAAgB,WAAW,IAAI;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAE5E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAExF"}

package/dist/index.client.js

@@ -199,6 +199,9 @@ export function identify(userId) {
         localStorage.setItem('hazo_umetrics_uid', userId);
     }
 }
+export function getIdentity() {
+    return { session_id: getSessionId(), user_id: getUserId() };
+}
 export function recordStat(_key, _value, _opts) {
     // M1: client-side stat record via API
 }

package/dist/server/behavior.d.ts

@@ -63,7 +63,7 @@ export declare function topActions(adapter: HazoConnectAdapter, opts: BehaviorOp
 export declare function eventsOverTime(adapter: HazoConnectAdapter, opts: BehaviorOptions): Promise<EventDayBucket[]>;
 export interface JourneyStep {
     metric_key: string;
-    kind: 'action' | 'pageview' | 'error' | 'other';
+    kind: 'action' | 'pageview' | 'click' | 'error' | 'other';
     label: string;
     path?: string;
     captured_at: string;
@@ -81,8 +81,14 @@ export interface JourneySession {
 export interface JourneyGraphNode {
     id: string;
     label: string;
-    kind: 'action' | 'pageview' | 'error' | 'other';
+    kind: 'action' | 'pageview' | 'click' | 'error' | 'other';
     count: number;
+    /** Pages this event fired on, most frequent first. Lets the UI answer
+     * "which page is this click from?" for nodes keyed only by metric_key. */
+    paths?: Array<{
+        path: string;
+        count: number;
+    }>;
 }
 export interface JourneyGraphEdge {
     from: string;
@@ -108,6 +114,13 @@ export declare function userJourney(adapter: HazoConnectAdapter, opts: {
         label?: string;
         datapoint_schema?: DatapointSchema;
     }>;
+    /** When true, nodes/edges are keyed by (metric_key + page) so the same event
+     * on different pages becomes distinct boxes. Removes cross-page ambiguity. */
+    splitByPage?: boolean;
+    /** When true, only pageview events form the graph and each pageview links to
+     * the NEXT pageview in the session (intervening clicks are skipped), giving a
+     * connected page-to-page navigation flow. */
+    pageFlow?: boolean;
 }): Promise<JourneyResult>;
 export interface DatapointKeyStats {
     key: string;
@@ -143,4 +156,29 @@ export declare function datapointStats(adapter: HazoConnectAdapter, opts: {
     topN?: number;
     schema?: DatapointSchema;
 }): Promise<DatapointStatsResult>;
+export interface SearchTermEntry {
+    term: string;
+    count: number;
+    searchers: number;
+    zeroResults: number;
+    lastSearchedAt: string;
+}
+export interface SearchQueriesResult {
+    total_searches: number;
+    unique_terms: number;
+    unique_searchers: number;
+    zero_result_searches: number;
+    top_terms: SearchTermEntry[];
+    zero_result_terms: SearchTermEntry[];
+    over_time: EventDayBucket[];
+    per_user: Array<{
+        user_id: string;
+        count: number;
+        distinct_terms: number;
+        terms: string[];
+    }>;
+}
+export declare function searchQueries(adapter: HazoConnectAdapter, opts: BehaviorOptions & {
+    topN?: number;
+}): Promise<SearchQueriesResult>;
 //# sourceMappingURL=behavior.d.ts.map

package/dist/server/behavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../../src/server/behavior.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../../src/server/behavior.ts"],"names":[],"mappings":"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"}

package/dist/server/behavior.js

@@ -347,8 +347,11 @@ export async function eventsOverTime(adapter, opts) {
 function classifyKind(metric_key) {
     if (metric_key.startsWith('action.'))
         return 'action';
-    if (metric_key.startsWith('pageview'))
+    // Pageview keys are emitted as `ui.pageview.*` (also accept bare `pageview*`).
+    if (metric_key.startsWith('ui.pageview') || metric_key.startsWith('pageview'))
         return 'pageview';
+    if (metric_key.startsWith('ui.click.'))
+        return 'click';
     if (metric_key.startsWith('ui.error.') || metric_key.startsWith('error.'))
         return 'error';
     return 'other';
@@ -386,9 +389,22 @@ export async function userJourney(adapter, opts) {
     const nodeCountMap = new Map();
     const edgeAccMap = new Map();
     const sessions = [];
+    // Node/edge identity. In split-by-page mode the same event on two pages gets
+    // two distinct ids (NUL separator — never appears in a metric_key or path).
+    const scopedId = (mk, d) => {
+        if (!opts.splitByPage)
+            return mk;
+        const p = d.path;
+        return p ? `${mk}@@${p}` : mk;
+    };
     for (const [sessionKey, sessionRows] of sessionGroups) {
         // fetchWindow returns rows in ascending captured_at order
         const steps = [];
+        // Last node accumulated into the graph for this session. Edges connect it to
+        // the next accumulated node — so in page-flow mode (where non-pageviews are
+        // skipped) a pageview links to the next pageview, not the intervening click.
+        let prevNodeId = null;
+        let prevCapturedMs = null;
         for (let i = 0; i < sessionRows.length; i++) {
             const row = sessionRows[i];
             const dims = parseDims(row.dimensions);
@@ -397,7 +413,11 @@ export async function userJourney(adapter, opts) {
             // Look up catalog entry by action_key (strips 'action.' prefix)
             const actionKey = metric_key.startsWith('action.') ? metric_key.slice('action.'.length) : metric_key;
             const catalogEntry = opts.catalogMap?.get(actionKey);
-            const label = catalogEntry?.label ?? metric_key;
+            // Prefer a human label: curated catalog label → click text captured in
+            // dims.label → page path (for pageviews) → raw metric_key as last resort.
+            const dimLabel = typeof dims.label === 'string' && dims.label.trim() ? dims.label.trim() : undefined;
+            const prettyFallback = kind === 'pageview' ? (dims.path ?? metric_key) : metric_key;
+            const label = catalogEntry?.label ?? dimLabel ?? prettyFallback;
             // Duration to next step in this session
             const nextRow = sessionRows[i + 1];
             let durationMsToNext = null;
@@ -428,24 +448,32 @@ export async function userJourney(adapter, opts) {
                 session_id: dims.session_id ?? '__anon__',
                 user_id: dims.user_id,
             });
-            // Accumulate node count
-            if (!nodeCountMap.has(metric_key)) {
-                nodeCountMap.set(metric_key, { label, kind, count: 0 });
+            // In page-flow mode, only pageviews participate in the graph.
+            if (opts.pageFlow && kind !== 'pageview')
+                continue;
+            // Accumulate node count + per-page tally (keyed by scoped id)
+            const nodeId = scopedId(metric_key, dims);
+            if (!nodeCountMap.has(nodeId)) {
+                nodeCountMap.set(nodeId, { label, kind, count: 0, pathCounts: new Map() });
             }
-            nodeCountMap.get(metric_key).count++;
-            // Accumulate edge (from previous step to current)
-            if (i > 0) {
-                const fromKey = sessionRows[i - 1].metric_key;
-                const edgeKey = `${fromKey}→${metric_key}`;
+            const nodeAcc = nodeCountMap.get(nodeId);
+            nodeAcc.count++;
+            const stepPath = dims.path;
+            if (stepPath)
+                nodeAcc.pathCounts.set(stepPath, (nodeAcc.pathCounts.get(stepPath) ?? 0) + 1);
+            // Edge from the previous accumulated node to this one.
+            const nowMs = new Date(row.captured_at).getTime();
+            if (prevNodeId !== null) {
+                const edgeKey = `${prevNodeId}→${nodeId}`;
                 if (!edgeAccMap.has(edgeKey)) {
-                    edgeAccMap.set(edgeKey, { from: fromKey, to: metric_key, count: 0, totalMs: 0 });
+                    edgeAccMap.set(edgeKey, { from: prevNodeId, to: nodeId, count: 0, totalMs: 0 });
                 }
                 const edgeData = edgeAccMap.get(edgeKey);
                 edgeData.count++;
-                const t1 = new Date(sessionRows[i - 1].captured_at).getTime();
-                const t2 = new Date(row.captured_at).getTime();
-                edgeData.totalMs += (t2 - t1);
+                edgeData.totalMs += prevCapturedMs !== null ? (nowMs - prevCapturedMs) : 0;
             }
+            prevNodeId = nodeId;
+            prevCapturedMs = nowMs;
         }
         sessions.push({
             session_id: sessionKey,
@@ -455,7 +483,15 @@ export async function userJourney(adapter, opts) {
     }
     // Build sorted graph
     const nodes = [...nodeCountMap.entries()]
-        .map(([id, data]) => ({ id, label: data.label, kind: data.kind, count: data.count }))
+        .map(([id, data]) => ({
+        id,
+        label: data.label,
+        kind: data.kind,
+        count: data.count,
+        paths: [...data.pathCounts.entries()]
+            .map(([path, count]) => ({ path, count }))
+            .sort((a, b) => b.count - a.count),
+    }))
         .sort((a, b) => a.id.localeCompare(b.id));
     const edges = [...edgeAccMap.values()]
         .map(({ from, to, count, totalMs }) => ({ from, to, count, avgMs: count > 0 ? totalMs / count : 0 }))
@@ -475,8 +511,11 @@ export async function datapointStats(adapter, opts) {
         filtered = filtered.filter((r) => r.captured_at <= opts.until);
     }
     const total_events = filtered.length;
-    const schemaKeys = opts.schema ? new Set(opts.schema.map((f) => f.key)) : null;
-    const schemaMap = opts.schema ? new Map(opts.schema.map((f) => [f.key, f])) : null;
+    // An empty schema array means "no schema declared" — restrict to nothing would
+    // wrongly filter out every discovered dimension. Only constrain when non-empty.
+    const hasSchema = Array.isArray(opts.schema) && opts.schema.length > 0;
+    const schemaKeys = hasSchema ? new Set(opts.schema.map((f) => f.key)) : null;
+    const schemaMap = hasSchema ? new Map(opts.schema.map((f) => [f.key, f])) : null;
     const allValues = new Map();
     for (const row of filtered) {
         const dims = parseDims(row.dimensions);
@@ -539,3 +578,92 @@ export async function datapointStats(adapter, opts) {
     keys.sort((a, b) => a.key.localeCompare(b.key));
     return { action_key: opts.action_key, total_events, keys };
 }
+export async function searchQueries(adapter, opts) {
+    const { app_id, scope_id, since, limit = 10000 } = opts;
+    const topN_ = opts.topN ?? 20;
+    const rows = await fetchWindow(adapter, { app_id, scope_id, since: since ?? defaultSince(), cap: limit });
+    const searchRows = rows.filter((r) => r.metric_key === 'action.search');
+    const termMap = new Map();
+    const dayMap = new Map();
+    const userMap = new Map();
+    let zeroResultSearches = 0;
+    const allSearchers = new Set();
+    for (const row of searchRows) {
+        const dims = parseDims(row.dimensions);
+        const rawTerm = typeof dims.term === 'string' ? dims.term : String(dims.term ?? '');
+        if (!rawTerm)
+            continue;
+        const normTerm = rawTerm.trim().toLowerCase();
+        const uid = dims.user_id;
+        const sid = dims.session_id;
+        const identity = uid ?? sid;
+        const resultCount = dims.result_count != null ? Number(dims.result_count) : null;
+        const isZero = resultCount === 0;
+        if (identity)
+            allSearchers.add(identity);
+        // Term accumulator
+        if (!termMap.has(normTerm)) {
+            termMap.set(normTerm, {
+                count: 0,
+                searchers: new Set(),
+                zeroResults: 0,
+                firstCasing: rawTerm.trim(),
+                lastAt: row.captured_at,
+            });
+        }
+        const acc = termMap.get(normTerm);
+        acc.count++;
+        if (identity)
+            acc.searchers.add(identity);
+        if (isZero) {
+            acc.zeroResults++;
+            zeroResultSearches++;
+        }
+        if (row.captured_at > acc.lastAt)
+            acc.lastAt = row.captured_at;
+        // Day bucket
+        const day = dayBucket(row.captured_at);
+        dayMap.set(day, (dayMap.get(day) ?? 0) + 1);
+        // Per-user
+        if (uid) {
+            if (!userMap.has(uid))
+                userMap.set(uid, { count: 0, terms: new Set() });
+            const ua = userMap.get(uid);
+            ua.count++;
+            ua.terms.add(normTerm);
+        }
+    }
+    const allTermEntries = [...termMap.entries()].map(([, acc]) => ({
+        term: acc.firstCasing,
+        count: acc.count,
+        searchers: acc.searchers.size,
+        zeroResults: acc.zeroResults,
+        lastSearchedAt: acc.lastAt,
+    }));
+    const top_terms = [...allTermEntries].sort((a, b) => b.count - a.count).slice(0, topN_);
+    const zero_result_terms = allTermEntries
+        .filter((e) => e.zeroResults > 0)
+        .sort((a, b) => b.zeroResults - a.zeroResults)
+        .slice(0, topN_);
+    const over_time = [...dayMap.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([day, count]) => ({ day, count }));
+    const per_user = [...userMap.entries()]
+        .map(([user_id, { count, terms }]) => ({
+        user_id,
+        count,
+        distinct_terms: terms.size,
+        terms: [...terms],
+    }))
+        .sort((a, b) => b.count - a.count);
+    return {
+        total_searches: searchRows.length,
+        unique_terms: termMap.size,
+        unique_searchers: allSearchers.size,
+        zero_result_searches: zeroResultSearches,
+        top_terms,
+        zero_result_terms,
+        over_time,
+        per_user,
+    };
+}

package/dist/ui/index.d.ts

@@ -3,4 +3,5 @@ export * from './actions_panel.js';
 export * from './analytics_panel.js';
 export * from './datapoint_panel.js';
 export * from './journey_panel.js';
+export * from './search_queries_panel.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC"}

package/dist/ui/index.js

@@ -5,3 +5,4 @@ export * from './actions_panel.js';
 export * from './analytics_panel.js';
 export * from './datapoint_panel.js';
 export * from './journey_panel.js';
+export * from './search_queries_panel.js';

package/dist/ui/journey_panel.d.ts

@@ -1,6 +1,6 @@
 export interface JourneyStep {
     metric_key: string;
-    kind: 'action' | 'pageview' | 'error' | 'other';
+    kind: 'action' | 'pageview' | 'click' | 'error' | 'other';
     label: string;
     path?: string;
     captured_at: string;
@@ -18,8 +18,13 @@ export interface JourneySession {
 export interface JourneyGraphNode {
     id: string;
     label: string;
-    kind: 'action' | 'pageview' | 'error' | 'other';
+    kind: 'action' | 'pageview' | 'click' | 'error' | 'other';
     count: number;
+    /** Pages this event fired on, most frequent first. */
+    paths?: Array<{
+        path: string;
+        count: number;
+    }>;
 }
 export interface JourneyGraphEdge {
     from: string;
@@ -46,6 +51,10 @@ export interface JourneyPanelProps {
         name?: string;
         profile_picture_url?: string;
     }>>;
+    /** Let edges enter a node's top/bottom (not only its left) to reduce crossings. Default true. */
+    multiSidePorts?: boolean;
+    /** Route back edges forward out of the source before curving back. Default true. */
+    backEdgeLoop?: boolean;
 }
-export declare function JourneyPanel({ appId, apiBase, userId, sessionId, resolveUserProfiles }: JourneyPanelProps): import("react").JSX.Element;
+export declare function JourneyPanel({ appId, apiBase, userId, sessionId, resolveUserProfiles, multiSidePorts, backEdgeLoop }: JourneyPanelProps): import("react").JSX.Element;
 //# sourceMappingURL=journey_panel.d.ts.map

package/dist/ui/journey_panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journey_panel.d.ts","sourceRoot":"","sources":["../../src/ui/journey_panel.tsx"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;CACrB;AAMD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAC3I;AAiaD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,EAAE,iBAAiB,+BAoJzG"}
+{"version":3,"file":"journey_panel.d.ts","sourceRoot":"","sources":["../../src/ui/journey_panel.tsx"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;CACrB;AAMD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC1I,iGAAiG;IACjG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA4kBD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAqB,EAAE,YAAmB,EAAE,EAAE,iBAAiB,+BAiLrJ"}

package/dist/ui/journey_panel.js

@@ -18,6 +18,7 @@ function kindColor(kind) {
     switch (kind) {
         case 'action': return '#6366f1';
         case 'pageview': return '#10b981';
+        case 'click': return '#f59e0b';
         case 'error': return '#ef4444';
         default: return '#94a3b8';
     }
@@ -27,7 +28,14 @@ function clampZoom(z) { return Math.max(0.25, Math.min(3, z)); }
 // JourneyFlowGraph — SVG left-to-right DAG visualization
 // ---------------------------------------------------------------------------
 const NODE_W = 148;
-const NODE_H = 44;
+const NODE_H = 56;
+/** Shorten a page path for display inside a node (keeps the tail, which is the
+ * distinguishing part: /board-games/backgammon-timer → …/backgammon-timer). */
+function shortPath(path, max = 20) {
+    if (path.length <= max)
+        return path;
+    return '…' + path.slice(path.length - (max - 1));
+}
 const COL_GAP = 200;
 const ROW_GAP = 64;
 const PAD = 24;
@@ -103,13 +111,75 @@ function computeFlowLayout(nodes, edges) {
     }
     return pos;
 }
-function JourneyFlowGraph({ graph, userFilter }) {
+/** A node port: anchor point on a node side plus the outward unit normal. The
+ * normal drives the bezier control point so the line leaves/enters square to
+ * the side (arrowheads sit flush and curves don't clip the node corner). */
+function portPoint(x, y, side) {
+    switch (side) {
+        case 'left': return { px: x, py: y + NODE_H / 2, ux: -1, uy: 0 };
+        case 'right': return { px: x + NODE_W, py: y + NODE_H / 2, ux: 1, uy: 0 };
+        case 'top': return { px: x + NODE_W / 2, py: y, ux: 0, uy: -1 };
+        case 'bottom': return { px: x + NODE_W / 2, py: y + NODE_H, ux: 0, uy: 1 };
+    }
+}
+/** Pick exit/entry sides for an edge and emit its cubic-bezier path plus a
+ * label anchor (bezier midpoint). `sx,sy`/`tx,ty` are node top-left corners in
+ * screen space.
+ *
+ * - multiSidePorts: let steep forward edges enter the target's top/bottom, and
+ *   same-column neighbours connect bottom→top, instead of always entering the
+ *   left side. Cuts the fan of crossings that piles up on a single side.
+ * - backEdgeLoop: for back edges (target left of source) leave the source's
+ *   right side — going forward a little — then curve back into the target's
+ *   top/bottom, instead of cutting straight back across the source. */
+function buildEdgePath(sx, sy, tx, ty, multiSidePorts, backEdgeLoop) {
+    const dx = tx - sx;
+    const dyc = ty - sy; // top-left deltas; centers share the same delta
+    const COL_TOL = (NODE_W + COL_GAP) * 0.5;
+    let exitSide = 'right';
+    let entrySide = 'left';
+    if (dx > COL_TOL) {
+        // Forward edge. Steep ones enter top/bottom so they don't crowd the left.
+        if (multiSidePorts && Math.abs(dyc) > Math.max(NODE_H * 1.5, dx * 0.8)) {
+            entrySide = dyc > 0 ? 'top' : 'bottom';
+        }
+    }
+    else if (dx < -COL_TOL) {
+        // Back edge: target is to the left.
+        if (backEdgeLoop) {
+            exitSide = 'right'; // hook forward first
+            entrySide = dyc >= 0 ? 'top' : 'bottom';
+        }
+    }
+    else {
+        // Same column: vertical neighbours connect bottom↔top.
+        if (multiSidePorts || backEdgeLoop) {
+            exitSide = dyc >= 0 ? 'bottom' : 'top';
+            entrySide = dyc >= 0 ? 'top' : 'bottom';
+        }
+    }
+    const e = portPoint(sx, sy, exitSide);
+    const n = portPoint(tx, ty, entrySide);
+    const dist = Math.hypot(n.px - e.px, n.py - e.py);
+    const k = Math.max(40, dist * 0.5);
+    const c1x = e.px + e.ux * k, c1y = e.py + e.uy * k;
+    const c2x = n.px + n.ux * k, c2y = n.py + n.uy * k;
+    const d = `M${e.px},${e.py} C${c1x},${c1y} ${c2x},${c2y} ${n.px},${n.py}`;
+    // Cubic bezier midpoint (t=0.5): 0.125·P0 + 0.375·P1 + 0.375·P2 + 0.125·P3.
+    const lx = 0.125 * e.px + 0.375 * c1x + 0.375 * c2x + 0.125 * n.px;
+    const ly = 0.125 * e.py + 0.375 * c1y + 0.375 * c2y + 0.125 * n.py;
+    return { d, lx, ly };
+}
+function JourneyFlowGraph({ graph, userFilter, loading, multiSidePorts = true, backEdgeLoop = true }) {
     const [zoom, setZoom] = useState(1.0);
     const [pan, setPan] = useState({ x: 0, y: 0 });
     const [dragging, setDragging] = useState(false);
     const [dragStart, setDragStart] = useState({ x: 0, y: 0 });
     const [selectedNode, setSelectedNode] = useState(null);
     const [isFullscreen, setIsFullscreen] = useState(false);
+    const [visibleKinds, setVisibleKinds] = useState({
+        action: true, pageview: true, click: true, error: true, other: true,
+    });
     const wrapperRef = useRef(null);
     const containerRef = useRef(null);
     // Holds latest fitToScreen so the fullscreenchange effect can call it without
@@ -150,7 +220,11 @@ function JourneyFlowGraph({ graph, userFilter }) {
     }, []);
     if (graph.nodes.length === 0)
         return null;
-    const pos = computeFlowLayout(graph.nodes, graph.edges);
+    // Apply kind filters: drop hidden-kind nodes and any edge touching them.
+    const vNodes = graph.nodes.filter(n => visibleKinds[n.kind]);
+    const vIds = new Set(vNodes.map(n => n.id));
+    const vEdges = graph.edges.filter(e => vIds.has(e.from) && vIds.has(e.to));
+    const pos = computeFlowLayout(vNodes, vEdges);
     // Compute SVG dimensions
     let maxX = 0;
     let maxY = 0;
@@ -192,7 +266,7 @@ function JourneyFlowGraph({ graph, userFilter }) {
     const highlightedNodes = new Set();
     if (selectedNode) {
         highlightedNodes.add(selectedNode);
-        graph.edges.forEach((edge, i) => {
+        vEdges.forEach((edge, i) => {
             if (edge.from === selectedNode || edge.to === selectedNode) {
                 highlightedEdges.add(i);
                 highlightedNodes.add(edge.from);
@@ -201,44 +275,54 @@ function JourneyFlowGraph({ graph, userFilter }) {
         });
     }
     const hasSelection = selectedNode !== null;
-    const maxCount = Math.max(...graph.nodes.map(n => n.count), 1);
-    return (_jsxs("div", { ref: wrapperRef, className: "rounded-lg border bg-white", style: isFullscreen ? { display: 'flex', flexDirection: 'column', height: '100vh', borderRadius: 0 } : undefined, children: [_jsxs("div", { className: "px-4 py-2 border-b flex items-center gap-2 flex-wrap", children: [_jsx("span", { className: "text-xs font-semibold text-gray-600 uppercase tracking-wide", children: "Flow Graph" }), _jsxs("span", { className: "text-xs text-gray-400", children: ["(", graph.nodes.length, " nodes \u00B7 ", graph.edges.length, " transitions)"] }), isFullscreen && userFilter && (_jsx("div", { className: "flex items-center gap-1.5 text-xs text-gray-500", children: userFilter })), _jsxs("div", { className: "ml-auto flex items-center gap-3 text-[10px] text-gray-400", children: [_jsxs("span", { className: "flex items-center gap-1", children: [_jsx("span", { className: "inline-block w-2 h-2 rounded-sm", style: { backgroundColor: '#6366f1' } }), " action"] }), _jsxs("span", { className: "flex items-center gap-1", children: [_jsx("span", { className: "inline-block w-2 h-2 rounded-sm", style: { backgroundColor: '#10b981' } }), " pageview"] }), _jsxs("span", { className: "flex items-center gap-1", children: [_jsx("span", { className: "inline-block w-2 h-2 rounded-sm", style: { backgroundColor: '#ef4444' } }), " error"] }), _jsxs("div", { className: "flex items-center gap-1 ml-2", children: [_jsx("button", { onClick: () => setZoom(z => clampZoom(z * 1.25)), className: "px-1.5 py-0.5 text-xs border rounded hover:bg-gray-50", title: "Zoom in", children: "+" }), _jsx("button", { onClick: () => setZoom(z => clampZoom(z / 1.25)), className: "px-1.5 py-0.5 text-xs border rounded hover:bg-gray-50", title: "Zoom out", children: "\u2212" }), _jsx("button", { onClick: fitToScreen, className: "px-1.5 py-0.5 text-xs border rounded hover:bg-gray-50", title: "Fit to screen", children: "\u22A1" }), _jsx("button", { onClick: () => setSelectedNode(null), disabled: !hasSelection, className: `px-1.5 py-0.5 text-xs border rounded flex items-center ${hasSelection ? 'bg-indigo-50 border-indigo-300 text-indigo-600 hover:bg-indigo-100' : 'text-gray-300 cursor-default'}`, title: "Clear selection", children: _jsx(MousePointer2, { className: "w-3 h-3" }) }), _jsx("button", { onClick: toggleFullscreen, className: "px-1.5 py-0.5 text-xs border rounded flex items-center hover:bg-gray-50", title: isFullscreen ? 'Exit fullscreen' : 'Fullscreen', children: isFullscreen ? _jsx(Minimize2, { className: "w-3 h-3" }) : _jsx(Maximize2, { className: "w-3 h-3" }) })] })] })] }), _jsx("div", { ref: containerRef, style: { position: 'relative', height: isFullscreen ? undefined : '500px', flex: isFullscreen ? 1 : undefined, overflow: 'hidden', cursor: dragging ? 'grabbing' : 'grab' }, onMouseDown: handleMouseDown, onMouseMove: handleMouseMove, onMouseUp: handleMouseUp, onMouseLeave: handleMouseUp, children: _jsxs("svg", { width: svgW, height: Math.max(svgH, 200), style: { display: 'block', transform: `translate(${pan.x}px,${pan.y}px) scale(${zoom})`, transformOrigin: '0 0', userSelect: 'none' }, children: [_jsx("defs", { children: _jsx("marker", { id: "arrow", markerWidth: "8", markerHeight: "8", refX: "7", refY: "3", orient: "auto", children: _jsx("path", { d: "M0,0 L0,6 L8,3 z", fill: "#94a3b8" }) }) }), graph.edges.map((edge, i) => {
-                            const from = pos.get(edge.from);
-                            const to = pos.get(edge.to);
-                            if (!from || !to)
-                                return null;
-                            const x1 = from.x + NODE_W;
-                            const y1 = from.y + offsetY + NODE_H / 2;
-                            const x2 = to.x;
-                            const y2 = to.y + offsetY + NODE_H / 2;
-                            const cx = (x1 + x2) / 2;
-                            const isHighlighted = hasSelection ? highlightedEdges.has(i) : true;
-                            const edgeOpacity = isHighlighted ? Math.max(0.4, edge.count / maxCount) : 0.05;
-                            const edgeStroke = isHighlighted && hasSelection ? '#6366f1' : '#94a3b8';
-                            const edgeStrokeW = isHighlighted ? Math.max(1.5, Math.min(4, edge.count / maxCount * 4)) : 1;
-                            return (_jsxs("g", { children: [_jsx("path", { d: `M${x1},${y1} C${cx},${y1} ${cx},${y2} ${x2},${y2}`, fill: "none", stroke: edgeStroke, strokeWidth: edgeStrokeW, strokeOpacity: edgeOpacity, markerEnd: "url(#arrow)" }), (() => {
-                                        // On selection, label every connected edge (even 1×) boldly so
-                                        // occurrence counts are readable; otherwise keep the faint >1 hint.
-                                        const selectedEdge = hasSelection && isHighlighted;
-                                        const showLabel = hasSelection ? isHighlighted : edge.count > 1;
-                                        if (!showLabel)
-                                            return null;
-                                        return (_jsxs("text", { x: cx, y: (y1 + y2) / 2 - 4, textAnchor: "middle", fontSize: selectedEdge ? 12 : 9, fontWeight: selectedEdge ? 700 : 400, fill: selectedEdge ? '#4338ca' : '#94a3b8', opacity: selectedEdge ? 1 : edgeOpacity, stroke: selectedEdge ? '#ffffff' : undefined, strokeWidth: selectedEdge ? 3 : undefined, paintOrder: "stroke", children: [edge.count, "\u00D7"] }));
-                                    })()] }, i));
-                        }), graph.nodes.map((node) => {
-                            const p = pos.get(node.id);
-                            if (!p)
-                                return null;
-                            const x = p.x;
-                            const y = p.y + offsetY;
-                            const fill = kindColor(node.kind);
-                            const isNodeHighlighted = hasSelection ? highlightedNodes.has(node.id) : true;
-                            const nodeAlpha = isNodeHighlighted ? Math.max(0.55, node.count / maxCount) : 0.1;
-                            const nodeStrokeW = node.id === selectedNode ? 2.5 : 1.5;
-                            const nodeStrokeOpacity = isNodeHighlighted ? Math.min(1, nodeAlpha + 0.3) : 0.1;
-                            const label = node.label.length > 18 ? node.label.slice(0, 17) + '…' : node.label;
-                            return (_jsxs("g", { "data-node": "true", onClick: (e) => { e.stopPropagation(); setSelectedNode(prev => prev === node.id ? null : node.id); }, style: { cursor: 'pointer' }, children: [_jsx("rect", { x: x, y: y, width: NODE_W, height: NODE_H, rx: 6, fill: fill, fillOpacity: nodeAlpha, stroke: fill, strokeOpacity: nodeStrokeOpacity, strokeWidth: nodeStrokeW }), _jsx("text", { x: x + NODE_W / 2, y: y + NODE_H / 2 - 5, textAnchor: "middle", fontSize: "11", fontWeight: "600", fill: "#1e293b", children: label }), _jsxs("text", { x: x + NODE_W / 2, y: y + NODE_H / 2 + 9, textAnchor: "middle", fontSize: "9", fill: "#475569", children: [node.count, "\u00D7"] })] }, node.id));
-                        })] }) })] }));
+    const selectedNodeObj = selectedNode ? vNodes.find(n => n.id === selectedNode) ?? null : null;
+    const maxCount = Math.max(...vNodes.map(n => n.count), 1);
+    return (_jsxs("div", { ref: wrapperRef, className: "rounded-lg border bg-white", style: isFullscreen ? { display: 'flex', flexDirection: 'column', height: '100vh', borderRadius: 0 } : undefined, children: [_jsxs("div", { className: "px-4 py-2 border-b flex items-center gap-2 flex-wrap", children: [_jsx("span", { className: "text-xs font-semibold text-gray-600 uppercase tracking-wide", children: "Flow Graph" }), _jsxs("span", { className: "text-xs text-gray-400", children: ["(", vNodes.length, " nodes \u00B7 ", vEdges.length, " transitions)"] }), loading && _jsx("span", { className: "text-[10px] text-indigo-400 animate-pulse", children: "updating\u2026" }), isFullscreen && userFilter && (_jsx("div", { className: "flex items-center gap-1.5 text-xs text-gray-500", children: userFilter })), _jsxs("div", { className: "ml-auto flex items-center gap-3 text-[10px] text-gray-400", children: [[
+                                ['pageview', '#10b981'],
+                                ['click', '#f59e0b'],
+                                ['action', '#6366f1'],
+                                ['error', '#ef4444'],
+                                ['other', '#94a3b8'],
+                            ].map(([kind, color]) => (_jsxs("label", { className: "flex items-center gap-1 cursor-pointer select-none", title: `Toggle ${kind} nodes`, children: [_jsx("input", { type: "checkbox", checked: visibleKinds[kind], onChange: (e) => setVisibleKinds(v => ({ ...v, [kind]: e.target.checked })), className: "w-3 h-3 cursor-pointer", style: { accentColor: color } }), kind] }, kind))), _jsxs("div", { className: "flex items-center gap-1 ml-2", children: [_jsx("button", { onClick: () => setZoom(z => clampZoom(z * 1.25)), className: "px-1.5 py-0.5 text-xs border rounded hover:bg-gray-50", title: "Zoom in", children: "+" }), _jsx("button", { onClick: () => setZoom(z => clampZoom(z / 1.25)), className: "px-1.5 py-0.5 text-xs border rounded hover:bg-gray-50", title: "Zoom out", children: "\u2212" }), _jsx("button", { onClick: fitToScreen, className: "px-1.5 py-0.5 text-xs border rounded hover:bg-gray-50", title: "Fit to screen", children: "\u22A1" }), _jsx("button", { onClick: () => setSelectedNode(null), disabled: !hasSelection, className: `px-1.5 py-0.5 text-xs border rounded flex items-center ${hasSelection ? 'bg-indigo-50 border-indigo-300 text-indigo-600 hover:bg-indigo-100' : 'text-gray-300 cursor-default'}`, title: "Clear selection", children: _jsx(MousePointer2, { className: "w-3 h-3" }) }), _jsx("button", { onClick: toggleFullscreen, className: "px-1.5 py-0.5 text-xs border rounded flex items-center hover:bg-gray-50", title: isFullscreen ? 'Exit fullscreen' : 'Fullscreen', children: isFullscreen ? _jsx(Minimize2, { className: "w-3 h-3" }) : _jsx(Maximize2, { className: "w-3 h-3" }) })] })] })] }), _jsxs("div", { ref: containerRef, style: { position: 'relative', height: isFullscreen ? undefined : '500px', flex: isFullscreen ? 1 : undefined, overflow: 'hidden', cursor: dragging ? 'grabbing' : 'grab' }, onMouseDown: handleMouseDown, onMouseMove: handleMouseMove, onMouseUp: handleMouseUp, onMouseLeave: handleMouseUp, children: [_jsxs("svg", { width: svgW, height: Math.max(svgH, 200), style: { display: 'block', transform: `translate(${pan.x}px,${pan.y}px) scale(${zoom})`, transformOrigin: '0 0', userSelect: 'none' }, children: [_jsx("defs", { children: _jsx("marker", { id: "arrow", markerWidth: "8", markerHeight: "8", refX: "7", refY: "3", orient: "auto", children: _jsx("path", { d: "M0,0 L0,6 L8,3 z", fill: "#94a3b8" }) }) }), vEdges.map((edge, i) => {
+                                const from = pos.get(edge.from);
+                                const to = pos.get(edge.to);
+                                if (!from || !to)
+                                    return null;
+                                const route = buildEdgePath(from.x, from.y + offsetY, to.x, to.y + offsetY, multiSidePorts, backEdgeLoop);
+                                const isHighlighted = hasSelection ? highlightedEdges.has(i) : true;
+                                const edgeOpacity = isHighlighted ? Math.max(0.4, edge.count / maxCount) : 0.05;
+                                const edgeStroke = isHighlighted && hasSelection ? '#6366f1' : '#94a3b8';
+                                const edgeStrokeW = isHighlighted ? Math.max(1.5, Math.min(4, edge.count / maxCount * 4)) : 1;
+                                return (_jsxs("g", { children: [_jsx("path", { d: route.d, fill: "none", stroke: edgeStroke, strokeWidth: edgeStrokeW, strokeOpacity: edgeOpacity, markerEnd: "url(#arrow)" }), (() => {
+                                            // On selection, label every connected edge (even 1×) boldly so
+                                            // occurrence counts are readable; otherwise keep the faint >1 hint.
+                                            const selectedEdge = hasSelection && isHighlighted;
+                                            const showLabel = hasSelection ? isHighlighted : edge.count > 1;
+                                            if (!showLabel)
+                                                return null;
+                                            return (_jsxs("text", { x: route.lx, y: route.ly - 4, textAnchor: "middle", fontSize: selectedEdge ? 12 : 9, fontWeight: selectedEdge ? 700 : 400, fill: selectedEdge ? '#4338ca' : '#94a3b8', opacity: selectedEdge ? 1 : edgeOpacity, stroke: selectedEdge ? '#ffffff' : undefined, strokeWidth: selectedEdge ? 3 : undefined, paintOrder: "stroke", children: [edge.count, "\u00D7"] }));
+                                        })()] }, i));
+                            }), vNodes.map((node) => {
+                                const p = pos.get(node.id);
+                                if (!p)
+                                    return null;
+                                const x = p.x;
+                                const y = p.y + offsetY;
+                                const fill = kindColor(node.kind);
+                                const isNodeHighlighted = hasSelection ? highlightedNodes.has(node.id) : true;
+                                const nodeAlpha = isNodeHighlighted ? Math.max(0.55, node.count / maxCount) : 0.1;
+                                const nodeStrokeW = node.id === selectedNode ? 2.5 : 1.5;
+                                const nodeStrokeOpacity = isNodeHighlighted ? Math.min(1, nodeAlpha + 0.3) : 0.1;
+                                const label = node.label.length > 18 ? node.label.slice(0, 17) + '…' : node.label;
+                                // Dominant page shown inline on click/action/other nodes (a pageview
+                                // node IS its page, so the subtitle would be redundant there).
+                                const showPage = node.kind !== 'pageview' && node.paths && node.paths.length > 0;
+                                const topPath = showPage ? node.paths[0].path : null;
+                                const morePages = showPage ? node.paths.length - 1 : 0;
+                                return (_jsxs("g", { "data-node": "true", onClick: (e) => { e.stopPropagation(); setSelectedNode(prev => prev === node.id ? null : node.id); }, style: { cursor: 'pointer' }, children: [_jsxs("title", { children: [`${node.label} · ${node.count}×`, node.paths && node.paths.length > 0
+                                                    ? `\nPages:\n` + node.paths.slice(0, 8).map(p => `  ${p.path} (${p.count}×)`).join('\n')
+                                                    : ''] }), _jsx("rect", { x: x, y: y, width: NODE_W, height: NODE_H, rx: 6, fill: fill, fillOpacity: nodeAlpha, stroke: fill, strokeOpacity: nodeStrokeOpacity, strokeWidth: nodeStrokeW }), topPath ? (_jsxs(_Fragment, { children: [_jsx("text", { x: x + NODE_W / 2, y: y + 17, textAnchor: "middle", fontSize: "11", fontWeight: "600", fill: "#1e293b", children: label }), _jsxs("text", { x: x + NODE_W / 2, y: y + 31, textAnchor: "middle", fontSize: "8.5", fill: kindColor(node.kind), children: [shortPath(topPath), morePages > 0 ? `  +${morePages}` : ''] }), _jsxs("text", { x: x + NODE_W / 2, y: y + 46, textAnchor: "middle", fontSize: "9", fill: "#475569", children: [node.count, "\u00D7"] })] })) : (_jsxs(_Fragment, { children: [_jsx("text", { x: x + NODE_W / 2, y: y + NODE_H / 2 - 3, textAnchor: "middle", fontSize: "11", fontWeight: "600", fill: "#1e293b", children: label }), _jsxs("text", { x: x + NODE_W / 2, y: y + NODE_H / 2 + 12, textAnchor: "middle", fontSize: "9", fill: "#475569", children: [node.count, "\u00D7"] })] }))] }, node.id));
+                            })] }), selectedNodeObj && (_jsxs("div", { className: "absolute top-3 left-3 max-w-xs rounded-lg border bg-white/95 shadow-sm backdrop-blur px-3 py-2", style: { pointerEvents: 'auto' }, onMouseDown: (e) => e.stopPropagation(), children: [_jsxs("div", { className: "flex items-center gap-2 mb-1", children: [_jsx("span", { className: "inline-block w-2 h-2 rounded-sm flex-shrink-0", style: { backgroundColor: kindColor(selectedNodeObj.kind) } }), _jsx("span", { className: "text-xs font-semibold text-gray-700 truncate", children: selectedNodeObj.label }), _jsxs("span", { className: "text-[10px] text-gray-400 ml-auto flex-shrink-0", children: [selectedNodeObj.count, "\u00D7"] })] }), selectedNodeObj.paths && selectedNodeObj.paths.length > 0 ? (_jsxs(_Fragment, { children: [_jsx("p", { className: "text-[10px] uppercase tracking-wide text-gray-400 mb-1", children: "Pages" }), _jsx("ul", { className: "flex flex-col gap-0.5 max-h-48 overflow-auto", children: selectedNodeObj.paths.map((p) => (_jsxs("li", { className: "flex items-center gap-2 text-[11px]", children: [_jsx("span", { className: "font-mono text-gray-600 truncate", children: p.path }), _jsxs("span", { className: "text-gray-400 tabular-nums ml-auto flex-shrink-0", children: [p.count, "\u00D7"] })] }, p.path))) })] })) : (_jsx("p", { className: "text-[11px] text-gray-400", children: "No page attribution recorded." }))] }))] })] }));
 }
 function SessionDetail({ session, index, profile }) {
     const [open, setOpen] = useState(index === 0);
@@ -250,7 +334,7 @@ function SessionDetail({ session, index, profile }) {
 // ---------------------------------------------------------------------------
 // JourneyPanel — main export
 // ---------------------------------------------------------------------------
-export function JourneyPanel({ appId, apiBase, userId, sessionId, resolveUserProfiles }) {
+export function JourneyPanel({ appId, apiBase, userId, sessionId, resolveUserProfiles, multiSidePorts = true, backEdgeLoop = true }) {
     const [result, setResult] = useState(null);
     const [loading, setLoading] = useState(false);
     const [error, setError] = useState(null);
@@ -262,6 +346,10 @@ export function JourneyPanel({ appId, apiBase, userId, sessionId, resolveUserPro
     // Behavior tab's single-user selection).
     const [selectedUserId, setSelectedUserId] = useState('');
     const effectiveUserId = selectedUserId || userId;
+    // Split-by-page: ask the server to key nodes by event+page (refetch on change).
+    const [splitByPage, setSplitByPage] = useState(false);
+    // Page-flow: server returns only pageviews, linked page→page (skips clicks).
+    const [pageFlow, setPageFlow] = useState(false);
     function userLabel(id) {
         const p = userProfiles.get(id);
         return p?.name ?? p?.email ?? `${id.slice(0, 12)}…`;
@@ -277,6 +365,10 @@ export function JourneyPanel({ appId, apiBase, userId, sessionId, resolveUserPro
             params.set('user_id', effectiveUserId);
         if (sessionId)
             params.set('session_id', sessionId);
+        if (splitByPage)
+            params.set('split_by_page', '1');
+        if (pageFlow)
+            params.set('page_flow', '1');
         fetch(`${apiBase}/analytics/journey?${params.toString()}`, { credentials: 'include' })
             .then((r) => r.json().catch(() => null))
             .then((body) => {
@@ -313,11 +405,11 @@ export function JourneyPanel({ appId, apiBase, userId, sessionId, resolveUserPro
             setLoading(false);
         });
         return () => { cancelled = true; };
-    }, [appId, apiBase, effectiveUserId, sessionId]);
+    }, [appId, apiBase, effectiveUserId, sessionId, splitByPage, pageFlow]);
     const sessionCount = result?.sessions.length ?? 0;
     const totalSteps = result?.sessions.reduce((s, sess) => s + sess.steps.length, 0) ?? 0;
-    // Single source of truth for the user filter — rendered in the toolbar, and
-    // passed into the flow graph so it stays reachable in graph fullscreen.
-    const userFilterControl = knownUserIds.length > 0 ? (_jsxs(_Fragment, { children: [_jsx("label", { className: "text-gray-500", children: "User" }), _jsxs("select", { value: selectedUserId, onChange: (e) => setSelectedUserId(e.target.value), className: "rounded border px-2 py-1 text-xs focus:outline-none focus:ring-1 focus:ring-indigo-400", children: [_jsx("option", { value: "", children: "All users" }), knownUserIds.map((id) => (_jsx("option", { value: id, children: userLabel(id) }, id)))] })] })) : null;
-    return (_jsxs("div", { className: "flex flex-col gap-4 p-4", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-4 text-xs text-gray-500", children: [_jsxs("span", { children: [_jsx("span", { className: "font-semibold text-gray-700", children: sessionCount }), " session", sessionCount !== 1 ? 's' : ''] }), _jsxs("span", { children: [_jsx("span", { className: "font-semibold text-gray-700", children: totalSteps }), " total steps"] }), userFilterControl && (_jsx("div", { className: "ml-auto flex items-center gap-1.5", children: userFilterControl }))] }), error && (_jsx("div", { className: "rounded-lg border border-red-200 bg-red-50 p-3 text-xs text-red-700", children: error })), loading && (_jsx("div", { className: "p-4 text-xs text-gray-400", children: "Loading journey data\u2026" })), !loading && result && (_jsxs(_Fragment, { children: [result.graph.nodes.length > 0 && (_jsx(JourneyFlowGraph, { graph: result.graph, userFilter: userFilterControl })), result.sessions.length === 0 ? (_jsx("div", { className: "rounded-lg border p-6 text-center text-sm text-gray-400", children: "No journey sessions found." })) : (_jsxs("div", { className: "flex flex-col gap-3", children: [_jsx("h3", { className: "text-xs font-semibold text-gray-500 uppercase tracking-wide", children: "Sessions" }), result.sessions.map((session, i) => (_jsx(SessionDetail, { session: session, index: i, profile: session.user_id ? userProfiles.get(session.user_id) : undefined }, session.session_id)))] }))] })), !loading && !result && !error && (_jsx("div", { className: "rounded-lg border p-6 text-center text-sm text-gray-400", children: "No data yet." }))] }));
+    // Single source of truth for the data-fetch controls — rendered in the toolbar,
+    // and passed into the flow graph so they stay reachable in graph fullscreen.
+    const toolbarControls = (_jsxs(_Fragment, { children: [_jsxs("label", { className: "flex items-center gap-1 cursor-pointer select-none", title: "Show only page-to-page navigation (each page links to the next page visited)", children: [_jsx("input", { type: "checkbox", checked: pageFlow, onChange: (e) => setPageFlow(e.target.checked), className: "w-3 h-3 cursor-pointer", style: { accentColor: '#10b981' } }), "Pages only"] }), _jsxs("label", { className: "flex items-center gap-1 cursor-pointer select-none", title: "Split each event into one box per page", children: [_jsx("input", { type: "checkbox", checked: splitByPage, onChange: (e) => setSplitByPage(e.target.checked), className: "w-3 h-3 cursor-pointer" }), "Group by page"] }), knownUserIds.length > 0 && (_jsxs(_Fragment, { children: [_jsx("label", { className: "text-gray-500 ml-1", children: "User" }), _jsxs("select", { value: selectedUserId, onChange: (e) => setSelectedUserId(e.target.value), className: "rounded border px-2 py-1 text-xs focus:outline-none focus:ring-1 focus:ring-indigo-400", children: [_jsx("option", { value: "", children: "All users" }), knownUserIds.map((id) => (_jsx("option", { value: id, children: userLabel(id) }, id)))] })] }))] }));
+    return (_jsxs("div", { className: "flex flex-col gap-4 p-4", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-4 text-xs text-gray-500", children: [_jsxs("span", { children: [_jsx("span", { className: "font-semibold text-gray-700", children: sessionCount }), " session", sessionCount !== 1 ? 's' : ''] }), _jsxs("span", { children: [_jsx("span", { className: "font-semibold text-gray-700", children: totalSteps }), " total steps"] }), _jsx("div", { className: "ml-auto flex items-center gap-3", children: toolbarControls })] }), error && (_jsx("div", { className: "rounded-lg border border-red-200 bg-red-50 p-3 text-xs text-red-700", children: error })), loading && !result && (_jsx("div", { className: "p-4 text-xs text-gray-400", children: "Loading journey data\u2026" })), result && (_jsxs(_Fragment, { children: [result.graph.nodes.length > 0 && (_jsx(JourneyFlowGraph, { graph: result.graph, userFilter: toolbarControls, loading: loading, multiSidePorts: multiSidePorts, backEdgeLoop: backEdgeLoop })), result.sessions.length === 0 ? (_jsx("div", { className: "rounded-lg border p-6 text-center text-sm text-gray-400", children: "No journey sessions found." })) : (_jsxs("div", { className: "flex flex-col gap-3", children: [_jsx("h3", { className: "text-xs font-semibold text-gray-500 uppercase tracking-wide", children: "Sessions" }), result.sessions.map((session, i) => (_jsx(SessionDetail, { session: session, index: i, profile: session.user_id ? userProfiles.get(session.user_id) : undefined }, session.session_id)))] }))] })), !loading && !result && !error && (_jsx("div", { className: "rounded-lg border p-6 text-center text-sm text-gray-400", children: "No data yet." }))] }));
 }

package/dist/ui/search_queries_panel.d.ts

@@ -0,0 +1,15 @@
+interface UserProfile {
+    id: string;
+    name?: string;
+    email?: string;
+    avatar_url?: string;
+}
+export interface SearchQueriesPanelProps {
+    appId: string;
+    apiBase: string;
+    since?: string;
+    resolveUserProfiles?: (ids: string[]) => Promise<UserProfile[]>;
+}
+export declare function SearchQueriesPanel({ appId, apiBase, since, resolveUserProfiles }: SearchQueriesPanelProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=search_queries_panel.d.ts.map

package/dist/ui/search_queries_panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_queries_panel.d.ts","sourceRoot":"","sources":["../../src/ui/search_queries_panel.tsx"],"names":[],"mappings":"AA4BA,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8CD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACjE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,uBAAuB,+BAiJzG"}

package/dist/ui/search_queries_panel.js

@@ -0,0 +1,71 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+// ---------------------------------------------------------------------------
+// MiniBar
+// ---------------------------------------------------------------------------
+function MiniBar({ value, max, color = '#6366f1' }) {
+    const pct = max > 0 ? (value / max) * 100 : 0;
+    return (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("div", { className: "flex-1 h-2 rounded bg-gray-100 overflow-hidden", children: _jsx("div", { className: "h-full rounded", style: { width: `${pct}%`, backgroundColor: color } }) }), _jsx("span", { className: "text-xs tabular-nums text-gray-600 w-8 text-right", children: value })] }));
+}
+// ---------------------------------------------------------------------------
+// SummaryCard
+// ---------------------------------------------------------------------------
+function SummaryCard({ label, value }) {
+    return (_jsxs("div", { className: "rounded-lg border bg-white p-4 flex flex-col gap-1", children: [_jsx("p", { className: "text-[10px] text-gray-400 uppercase tracking-wide", children: label }), _jsx("p", { className: "text-2xl font-semibold text-gray-800 tabular-nums", children: value })] }));
+}
+export function SearchQueriesPanel({ appId, apiBase, since, resolveUserProfiles }) {
+    const [data, setData] = useState(null);
+    const [profiles, setProfiles] = useState(new Map());
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (!appId)
+            return;
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        const params = new URLSearchParams({ app_id: appId });
+        if (since)
+            params.set('since', since);
+        fetch(`${apiBase}/analytics/search-queries?${params}`, { credentials: 'include' })
+            .then((r) => r.json().catch(() => null))
+            .then((body) => {
+            if (cancelled)
+                return;
+            setData(body?.data ?? null);
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (cancelled)
+                return;
+            setError(err instanceof Error ? err.message : 'Load error');
+            setLoading(false);
+        });
+        return () => { cancelled = true; };
+    }, [appId, apiBase, since]);
+    // Resolve user profiles after data loads
+    useEffect(() => {
+        if (!data || !resolveUserProfiles || data.per_user.length === 0)
+            return;
+        const ids = data.per_user.map((u) => u.user_id);
+        resolveUserProfiles(ids).then((resolved) => {
+            const map = new Map(resolved.map((p) => [p.id, p]));
+            setProfiles(map);
+        }).catch(() => { });
+    }, [data, resolveUserProfiles]);
+    if (loading)
+        return _jsx("div", { className: "p-4 text-xs text-gray-400", children: "Loading\u2026" });
+    if (error)
+        return _jsx("div", { className: "rounded-lg border border-red-200 bg-red-50 p-3 text-xs text-red-700", children: error });
+    if (!data)
+        return _jsx("div", { className: "rounded-lg border p-6 text-center text-sm text-gray-400", children: "No data yet." });
+    const maxTermCount = data.top_terms.length > 0 ? Math.max(...data.top_terms.map((t) => t.count), 1) : 1;
+    const maxZeroCount = data.zero_result_terms.length > 0 ? Math.max(...data.zero_result_terms.map((t) => t.zeroResults), 1) : 1;
+    const maxDayCount = data.over_time.length > 0 ? Math.max(...data.over_time.map((d) => d.count), 1) : 1;
+    return (_jsxs("div", { className: "flex flex-col gap-6 p-4", children: [_jsxs("div", { className: "grid grid-cols-2 md:grid-cols-4 gap-4", children: [_jsx(SummaryCard, { label: "Total Searches", value: data.total_searches }), _jsx(SummaryCard, { label: "Unique Terms", value: data.unique_terms }), _jsx(SummaryCard, { label: "Unique Searchers", value: data.unique_searchers }), _jsx(SummaryCard, { label: "Zero-Result Searches", value: data.zero_result_searches })] }), _jsxs("div", { className: "rounded-lg border bg-white p-4 flex flex-col gap-3", children: [_jsx("h3", { className: "text-sm font-semibold text-gray-700", children: "Top Search Terms" }), data.top_terms.length === 0 ? (_jsx("p", { className: "text-xs text-gray-400", children: "No searches recorded yet." })) : (_jsx("div", { className: "flex flex-col gap-1", children: data.top_terms.map((t) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-gray-600 w-32 truncate", title: t.term, children: t.term }), _jsx(MiniBar, { value: t.count, max: maxTermCount })] }, t.term))) }))] }), data.zero_result_terms.length > 0 && (_jsxs("div", { className: "rounded-lg border border-amber-200 bg-amber-50 p-4 flex flex-col gap-3", children: [_jsxs("h3", { className: "text-sm font-semibold text-amber-800", children: ["Zero-Result Terms ", _jsx("span", { className: "text-xs font-normal text-amber-600", children: "(content gaps)" })] }), _jsx("div", { className: "flex flex-col gap-1", children: data.zero_result_terms.map((t) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-amber-700 w-32 truncate", title: t.term, children: t.term }), _jsx(MiniBar, { value: t.zeroResults, max: maxZeroCount, color: "#f59e0b" })] }, t.term))) })] })), data.over_time.length > 0 && (_jsxs("div", { className: "rounded-lg border bg-white p-4 flex flex-col gap-3", children: [_jsx("h3", { className: "text-sm font-semibold text-gray-700", children: "Searches Over Time" }), _jsx("div", { className: "flex flex-col gap-1", children: data.over_time.map((d) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-[10px] text-gray-400 w-20", children: d.day }), _jsx(MiniBar, { value: d.count, max: maxDayCount, color: "#10b981" })] }, d.day))) })] })), data.per_user.length > 0 && (_jsxs("div", { className: "rounded-lg border bg-white p-4 flex flex-col gap-3", children: [_jsx("h3", { className: "text-sm font-semibold text-gray-700", children: "Per-User Searches" }), _jsx("div", { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-xs border-collapse", children: [_jsx("thead", { children: _jsxs("tr", { className: "text-left text-gray-400 border-b", children: [_jsx("th", { className: "py-1 pr-4 font-medium", children: "User" }), _jsx("th", { className: "py-1 pr-4 font-medium tabular-nums", children: "Searches" }), _jsx("th", { className: "py-1 pr-4 font-medium tabular-nums", children: "Distinct Terms" }), _jsx("th", { className: "py-1 font-medium", children: "Recent Terms" })] }) }), _jsx("tbody", { children: data.per_user.map((u) => {
+                                        const profile = profiles.get(u.user_id);
+                                        const displayName = profile?.name ?? profile?.email ?? u.user_id.slice(0, 8) + '…';
+                                        return (_jsxs("tr", { className: "border-b border-gray-50", children: [_jsxs("td", { className: "py-1 pr-4 text-gray-700", children: [profile?.avatar_url && (_jsx("img", { src: profile.avatar_url, alt: "", className: "inline-block w-4 h-4 rounded-full mr-1 align-middle" })), displayName] }), _jsx("td", { className: "py-1 pr-4 tabular-nums text-gray-600", children: u.count }), _jsx("td", { className: "py-1 pr-4 tabular-nums text-gray-600", children: u.distinct_terms }), _jsxs("td", { className: "py-1 text-gray-500", children: [u.terms.slice(0, 5).join(', '), u.terms.length > 5 ? '…' : ''] })] }, u.user_id));
+                                    }) })] }) })] }))] }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_umetrics",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "Product analytics for hazo apps — GA4 hybrid + first-party stat store + feature flags",
   "type": "module",
   "module": "./dist/index.js",