hazo_umetrics 1.11.0 → 1.13.1

package/CHANGE_LOG.md

@@ -1,5 +1,53 @@
 # hazo_umetrics — Change Log
 
+## 1.13.1 — Insecure-context-safe session id (bugfix)
+
+**The client tracker no longer crashes the host app when opened over a bare-http origin (patch — no signature changes):**
+
+- `src/index.client.ts` `getSessionId()` used `crypto.randomUUID()`, which is only defined in a **secure context** (https or localhost). Opening the app over a bare-http LAN IP (e.g. `http://192.168.x.x:3025` while testing on another device) left `randomUUID` undefined, so generating the anonymous session id threw and took down the whole React tree with it.
+- New `safeUuid()` helper: uses `crypto.randomUUID()` when available (secure contexts), falls back to a v4 UUID built from `crypto.getRandomValues()` (available in insecure contexts too), and finally to a non-crypto id (fine for a throwaway anonymous session key). An analytics session id must never crash the host app.
+- Test: `__tests__/safe_uuid.test.ts` — covers the `randomUUID` path, the `getRandomValues` fallback (v4 shape), and the no-crypto last resort.
+
+## 1.13.0 — Generic manual-input field analyzer (`inputFieldAnalysis`)
+
+**Generalizes the search-query analysis to any manual-input field — free-text labels, numeric amounts, override targets — per `design/hazo_umetrics-input-analyzer-spec.md` (minor — additive, no signatures changed):**
+
+### Server (`src/server/behavior.ts`, `src/server/types.ts`)
+- `inputFieldAnalysis(adapter, opts)` — generic analyzer over `action.<metric_key>` events for any `value_dim`, with an optional numeric-distribution path (`numeric: true` + optional `numeric_dim`). New types `InputFieldQuery`, `InputValueEntry`, `NumericSummary` (`n, min, p25, median, p75, max, mean, histogram`), `InputFieldResult`.
+- `searchQueries` and `notFoundQueries` refactored into thin presets delegating to `inputFieldAnalysis`, mapped byte-identical to their frozen legacy shapes (`SearchQueriesResult`/`SearchTermEntry`, `NotFoundQueriesResult`) — no consumer-facing signature changes. New `case_sensitive` option on `InputFieldQuery` preserves `notFoundQueries`' raw-path dedup.
+- `AnalyzableField` (extends `DatapointField`): `{ metric_key, value_dim, numeric_dim?, aggregatable, flag? }` — the privacy gate. Only fields with `aggregatable: true` may ever be captured server-side or returned by the API. `app_id`/`scope_id` tenant isolation inherited unchanged.
+
+### API (`src/api/index.ts`)
+- `createBehaviorHandlers` gains `getInputField(req)` — `GET /...?app_id=<id>&field_key=<key>[&since=<iso>][&top_n=<n>]`, requires `metrics.view`. Resolves `field_key` against a new `analyzableFields?: Record<string, AnalyzableField>` registry on `ApiFactoryOptions`, rejects unknown fields (404) and non-aggregatable fields (403), then delegates to `inputFieldAnalysis`. Legacy `getSearchQueries`/`getNotFound` untouched (now delegating internally, same routes/shapes).
+
+### UI (`src/ui/input_field_panel.tsx`, new; exported from `src/ui/index.ts`)
+- `InputFieldPanel({ appId, apiBase, fieldKey, labels?, since?, resolveUserProfiles? })` — generalized `search_queries_panel` (extracted `SummaryCard`/`MiniBar` locals). Same summary-cards + top-values + over-time + per-subject layout, with configurable copy via `InputFieldPanelLabels`. New numeric mode: when `numeric_summary` is present, renders a percentile strip (min/p25/median/p75/max/mean) + histogram instead of the top-values list.
+- `SearchQueriesPanel` (`src/ui/search_queries_panel.tsx`, rewritten) is now `<InputFieldPanel fieldKey="search_query" labels={SEARCH_LABELS} .../>` — zero behaviour change. `InputFieldPanel` special-cases `fieldKey="search_query"` to keep talking to the legacy `GET /analytics/search-queries` route (byte-identical wire format, normalized client-side for shared rendering) instead of the new `/analytics/input-field` route, so existing consumer apps (gotimer/stocktools/kinstripe) keep working untouched on upgrade.
+
+### Tests
+- `__tests__/input_field_numeric.test.ts` — `inputFieldAnalysis` numeric path over synthetic `action.expense_other` rows (dim `amount`): percentiles + 10-bucket histogram against a hand-verified distribution, a single-bucket degenerate case, and categorical-path non-interference.
+- `__tests__/search_queries.test.ts` and `__tests__/not_found.test.ts` (pre-existing) continue to pass unmodified — parity proof that the preset wrappers are byte-identical through the new `inputFieldAnalysis` path.
+
+### Test-app
+- `test-app/app/api/hazo_umetrics/analytics/input-field/route.ts` (new) — mirrors the `analytics/datapoints` route pattern; registers a demo `timer_score` numeric field (reusing the existing "Seed datapoint events" quick-seed action) so `GET .../analytics/input-field?app_id=test_app&field_key=timer_score` exercises the numeric path end to end.
+
+## 1.12.0 — 404 / broken-link analytics
+
+**New behavioral cut for `action.404` events (minor — purely additive; no existing signatures changed):**
+
+### Server (`src/server/behavior.ts`)
+- `notFoundQueries(adapter, opts)` — app-side aggregation over `action.404` events (mirrors `searchQueries`). Reuses the existing `fetchWindow`/`parseDims`/`tsBucket`/`defaultSince` helpers. Filters `metric_key === 'action.404'`, skips rows with an empty/missing `requested_path`, defaults `referrer_kind` to `direct` and folds unrecognized kinds into `external`.
+- `NotFoundQueriesResult`: `total_404s`, `unique_paths`, `internal_referrer_count`, `top_paths` (`{ path, count, lastAt, internalCount, sampleReferrer }`, desc by count), `by_source` (`{ internal, search, external, direct }`), `over_time` (`EventDayBucket[]`, second-precision, most-recent 100 chronological). New exported types `NotFoundPathEntry`, `NotFoundSourceBreakdown`.
+
+### API (`src/api/index.ts`)
+- `createBehaviorHandlers` gains `getNotFound(req)` — `GET /...?app_id=<id>[&since=<iso>][&top_n=<n>]`, requires `metrics.view`, returns `jsonOk(result)`. No per-user cut (404s have no `user_ids` param).
+
+### UI (`src/ui/not_found_panel.tsx`, new; exported from `src/ui/index.ts`)
+- `NotFoundPanel({ appId, apiBase })` — self-contained window tabs (Total / 24h / 7d / 28d / 90d), summary cards (Total 404s / Unique Paths / Internal Broken Links / Direct-Typed), Top Missing Paths (amber "broken internal link" badge when `internalCount > 0`), Traffic Source breakdown, and 404s Over Time. Consumes `GET {apiBase}/analytics/not-found`.
+
+### Tests
+- `__tests__/not_found.test.ts` — mirrors `search_queries.test.ts` (counts, `internal_referrer_count`, `by_source`, `top_paths` ordering, empty-path skip).
+
 ## 1.11.0 — M1 GA4 live (OAuth connect + Admin provisioner + Data API funnels + windowed ga4 metrics)
 
 **M1 GA4 half shipped (minor — stubs replaced with real implementations; signatures widened, not broken):**

package/dist/api/index.d.ts

@@ -1,4 +1,5 @@
 import type { HazoConnectAdapter } from 'hazo_connect/server';
+import type { AnalyzableField } from '../server/types.js';
 export type GetAuthFn = (req: Request, opts: {
     required_permissions?: string[];
     scope_id?: string;
@@ -37,6 +38,24 @@ export interface ApiFactoryOptions {
      * ```
      */
     defaultActionLabels?: Record<string, string>;
+    /**
+     * Registry of manual-input fields analyzable via `getInputField`
+     * (`GET /analytics/input-field?field_key=<key>`), keyed by field_key.
+     * Only entries with `aggregatable: true` are ever returned by the API —
+     * getInputField rejects a resolved field with `aggregatable: false`.
+     *
+     * Example:
+     * ```ts
+     * analyzableFields: {
+     *   expense_other: {
+     *     key: 'expense_other', label: 'Expense (Other)', type: 'number',
+     *     metric_key: 'action.expense_other', value_dim: 'label',
+     *     numeric_dim: 'amount', aggregatable: true,
+     *   },
+     * }
+     * ```
+     */
+    analyzableFields?: Record<string, AnalyzableField>;
 }
 export declare function createStatHandlers(options: ApiFactoryOptions): {
     /**
@@ -208,5 +227,18 @@ export declare function createBehaviorHandlers(options: ApiFactoryOptions): {
      * Returns search query analytics. Requires metrics.view.
      */
     getSearchQueries(req: Request): Promise<Response>;
+    /**
+     * GET /...?app_id=<id>[&since=<iso>][&top_n=<n>]
+     * Returns 404 / broken-link analytics. Requires metrics.view.
+     */
+    getNotFound(req: Request): Promise<Response>;
+    /**
+     * GET /...?app_id=<id>&field_key=<key>[&since=<iso>][&top_n=<n>]
+     * Generic manual-input field analytics — resolves field_key against the
+     * analyzableFields registry (see ApiFactoryOptions), enforces the
+     * aggregatable privacy gate, then delegates to inputFieldAnalysis.
+     * Requires metrics.view.
+     */
+    getInputField(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

@@ -11,7 +11,7 @@ import { createGa4MetricWindowReader } from '../server/ga4_metrics.js';
 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, searchQueries as _searchQueries, } 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, notFoundQueries as _notFoundQueries, inputFieldAnalysis as _inputFieldAnalysis, } from '../server/behavior.js';
 import { createGa4Client } from '../server/ga4.js';
 import { createGa4Provisioner } from '../server/ga4_provision.js';
 import { getFunnel } from '../server/funnel.js';
@@ -1144,5 +1144,73 @@ export function createBehaviorHandlers(options) {
             const result = await _searchQueries(adapter, { app_id, since, topN, userIds });
             return jsonOk(result);
         },
+        /**
+         * GET /...?app_id=<id>[&since=<iso>][&top_n=<n>]
+         * Returns 404 / broken-link analytics. Requires metrics.view.
+         */
+        async getNotFound(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 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 _notFoundQueries(adapter, { app_id, since, topN });
+            return jsonOk(result);
+        },
+        /**
+         * GET /...?app_id=<id>&field_key=<key>[&since=<iso>][&top_n=<n>]
+         * Generic manual-input field analytics — resolves field_key against the
+         * analyzableFields registry (see ApiFactoryOptions), enforces the
+         * aggregatable privacy gate, then delegates to inputFieldAnalysis.
+         * Requires metrics.view.
+         */
+        async getInputField(req) {
+            const url = new URL(req.url);
+            const app_id = url.searchParams.get('app_id') ?? '';
+            const field_key = url.searchParams.get('field_key') ?? '';
+            const since = url.searchParams.get('since') ?? undefined;
+            const topNParam = url.searchParams.get('top_n');
+            const topN = topNParam != null ? parseInt(topNParam, 10) : 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 || !field_key) {
+                return jsonError('BAD_REQUEST', 'app_id and field_key are required', 400);
+            }
+            const field = options.analyzableFields?.[field_key];
+            if (!field) {
+                return jsonError('NOT_FOUND', `Unknown field_key "${field_key}"`, 404);
+            }
+            if (!field.aggregatable) {
+                return jsonError('FORBIDDEN', `Field "${field_key}" is not aggregatable`, 403);
+            }
+            const adapter = await options.getAdapter();
+            const result = await _inputFieldAnalysis(adapter, {
+                app_id,
+                since,
+                metric_key: field.metric_key,
+                value_dim: field.value_dim,
+                numeric: field.type === 'number',
+                numeric_dim: field.numeric_dim,
+                flag_dim: field.flag?.dim,
+                flag_predicate: field.flag?.predicate,
+                topN,
+            });
+            return jsonOk(result);
+        },
     };
 }

package/dist/index.client.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 export { trackFlowStep } from './lib/track_flow_step.js';
 export type { TrackFlowStepParams } from './lib/track_flow_step.js';
+export declare function safeUuid(): string;
 interface MetricsContextValue {
     appId: string | null | undefined;
     track: (metricKey: string, dimensions?: Record<string, string | number>) => 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;AAG1B,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAmDpE,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"}
+{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../src/index.client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAYpE,wBAAgB,QAAQ,IAAI,MAAM,CAiBjC;AA+CD,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

@@ -7,13 +7,38 @@ export { trackFlowStep } from './lib/track_flow_step.js';
 // ---------------------------------------------------------------------------
 // Anonymous session identity (localStorage, SSR-guarded)
 // ---------------------------------------------------------------------------
+// `crypto.randomUUID` only exists in a *secure context* (https or localhost).
+// When the app is opened over a bare-http origin — e.g. a LAN IP like
+// http://192.168.x.x:3025 while testing on another device — it is `undefined`,
+// and calling it throws. An anonymous analytics session id must never crash the
+// host app, so fall back to `getRandomValues` (available in insecure contexts)
+// and finally to a non-crypto id (fine for a throwaway session key).
+export function safeUuid() {
+    const c = typeof crypto !== 'undefined' ? crypto : undefined;
+    if (c && typeof c.randomUUID === 'function') {
+        try {
+            return c.randomUUID();
+        }
+        catch {
+            /* secure-context throw — fall through */
+        }
+    }
+    if (c && typeof c.getRandomValues === 'function') {
+        const b = c.getRandomValues(new Uint8Array(16));
+        b[6] = (b[6] & 0x0f) | 0x40; // version 4
+        b[8] = (b[8] & 0x3f) | 0x80; // variant 10
+        const h = Array.from(b, (x) => x.toString(16).padStart(2, '0'));
+        return `${h[0]}${h[1]}${h[2]}${h[3]}-${h[4]}${h[5]}-${h[6]}${h[7]}-${h[8]}${h[9]}-${h[10]}${h[11]}${h[12]}${h[13]}${h[14]}${h[15]}`;
+    }
+    return `sid-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
 function getSessionId() {
     if (typeof window === 'undefined')
         return '';
     const key = 'hazo_umetrics_sid';
     let sid = localStorage.getItem(key);
     if (!sid) {
-        sid = crypto.randomUUID();
+        sid = safeUuid();
         localStorage.setItem(key, sid);
     }
     return sid;

package/dist/server/behavior.d.ts

@@ -159,6 +159,62 @@ export declare function datapointStats(adapter: HazoConnectAdapter, opts: {
     topN?: number;
     schema?: DatapointSchema;
 }): Promise<DatapointStatsResult>;
+export interface InputFieldQuery {
+    app_id: string;
+    scope_id?: string;
+    since?: string;
+    metric_key: string;
+    value_dim: string;
+    numeric?: boolean;
+    numeric_dim?: string;
+    subject_dims?: string[];
+    flag_dim?: string;
+    flag_predicate?: (v: unknown) => boolean;
+    topN?: number;
+    /** Dedup key casing for value_dim. Default false = case-insensitive (the
+     * original searchQueries behavior: values are trim()+toLowerCase()'d for
+     * the dedup key, with the first-seen casing preserved for display). When
+     * true, the dedup key is the raw trimmed value — no case folding — which
+     * is what notFoundQueries needs ('/Foo' and '/foo' must stay separate). */
+    case_sensitive?: boolean;
+}
+export interface InputValueEntry {
+    value: string;
+    count: number;
+    subjects: number;
+    flagged: number;
+    lastAt: string;
+}
+export interface NumericSummary {
+    n: number;
+    min: number;
+    p25: number;
+    median: number;
+    p75: number;
+    max: number;
+    mean: number;
+    histogram: Array<{
+        bucket: string;
+        count: number;
+    }>;
+}
+export interface InputFieldResult {
+    total: number;
+    unique_values: number;
+    unique_subjects: number;
+    flagged_count: number;
+    top_values: InputValueEntry[];
+    flagged_values: InputValueEntry[];
+    over_time: EventDayBucket[];
+    per_subject: Array<{
+        subject_id: string;
+        count: number;
+        distinct_values: number;
+        values: string[];
+    }>;
+    numeric_summary?: NumericSummary;
+}
+export declare function inputFieldAnalysis(adapter: HazoConnectAdapter, opts: InputFieldQuery): Promise<InputFieldResult>;
 export interface SearchTermEntry {
     term: string;
     count: number;
@@ -184,4 +240,28 @@ export interface SearchQueriesResult {
 export declare function searchQueries(adapter: HazoConnectAdapter, opts: BehaviorOptions & {
     topN?: number;
 }): Promise<SearchQueriesResult>;
+export interface NotFoundPathEntry {
+    path: string;
+    count: number;
+    lastAt: string;
+    internalCount: number;
+    sampleReferrer: string;
+}
+export interface NotFoundSourceBreakdown {
+    internal: number;
+    search: number;
+    external: number;
+    direct: number;
+}
+export interface NotFoundQueriesResult {
+    total_404s: number;
+    unique_paths: number;
+    internal_referrer_count: number;
+    top_paths: NotFoundPathEntry[];
+    by_source: NotFoundSourceBreakdown;
+    over_time: EventDayBucket[];
+}
+export declare function notFoundQueries(adapter: HazoConnectAdapter, opts: BehaviorOptions & {
+    topN?: number;
+}): Promise<NotFoundQueriesResult>;
 //# 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

@@ -586,94 +586,249 @@ 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 NUMERIC_HISTOGRAM_BUCKETS = 10;
+function percentile(sortedAsc, p) {
+    const n = sortedAsc.length;
+    if (n === 0)
+        return 0;
+    if (n === 1)
+        return sortedAsc[0];
+    const idx = (p / 100) * (n - 1);
+    const lo = Math.floor(idx);
+    const hi = Math.ceil(idx);
+    if (lo === hi)
+        return sortedAsc[lo];
+    const frac = idx - lo;
+    return sortedAsc[lo] + (sortedAsc[hi] - sortedAsc[lo]) * frac;
+}
+function computeNumericSummary(values) {
+    const n = values.length;
+    if (n === 0) {
+        return { n: 0, min: 0, p25: 0, median: 0, p75: 0, max: 0, mean: 0, histogram: [] };
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const min = sorted[0];
+    const max = sorted[n - 1];
+    const mean = sorted.reduce((a, b) => a + b, 0) / n;
+    const p25 = percentile(sorted, 25);
+    const median = percentile(sorted, 50);
+    const p75 = percentile(sorted, 75);
+    const numBuckets = min === max ? 1 : NUMERIC_HISTOGRAM_BUCKETS;
+    const binWidth = min === max ? 1 : (max - min) / numBuckets;
+    const counts = new Array(numBuckets).fill(0);
+    for (const v of sorted) {
+        let idx = binWidth > 0 ? Math.floor((v - min) / binWidth) : 0;
+        if (idx >= numBuckets)
+            idx = numBuckets - 1;
+        if (idx < 0)
+            idx = 0;
+        counts[idx]++;
+    }
+    const histogram = counts.map((count, i) => {
+        const lo = min + i * binWidth;
+        const hi = i === numBuckets - 1 ? max : lo + binWidth;
+        return { bucket: `${round2(lo)}–${round2(hi)}`, count };
+    });
+    return { n, min, p25, median, p75, max, mean, histogram };
+}
+function round2(v) {
+    return Math.round(v * 100) / 100;
+}
+export async function inputFieldAnalysis(adapter, opts) {
+    const { app_id, scope_id, since, metric_key, value_dim } = 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 subjectDims = opts.subject_dims ?? ['user_id', 'session_id'];
+    const primaryDim = subjectDims[0];
+    const fallbackDim = subjectDims[1];
+    const rows = await fetchWindow(adapter, { app_id, scope_id, since: since ?? defaultSince(), cap: 10000 });
+    const fieldRows = rows.filter((r) => r.metric_key === metric_key);
+    const valueMap = new Map();
+    const tsMap = new Map();
+    const subjectMap = new Map();
+    const numericValues = [];
+    let flaggedCount = 0;
+    const allSubjects = new Set();
+    for (const row of fieldRows) {
         const dims = parseDims(row.dimensions);
-        const rawTerm = typeof dims.term === 'string' ? dims.term : String(dims.term ?? '');
-        if (!rawTerm)
+        const rawValue = typeof dims[value_dim] === 'string' ? dims[value_dim] : String(dims[value_dim] ?? '');
+        if (!rawValue)
             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;
+        const normValue = opts.case_sensitive ? rawValue.trim() : rawValue.trim().toLowerCase();
+        const primary = primaryDim ? dims[primaryDim] : undefined;
+        const fallback = fallbackDim ? dims[fallbackDim] : undefined;
+        const identity = primary ?? fallback;
+        const isFlagged = opts.flag_dim != null && opts.flag_predicate != null
+            ? Boolean(opts.flag_predicate(dims[opts.flag_dim]))
+            : false;
         if (identity)
-            allSearchers.add(identity);
-        // Term accumulator
-        if (!termMap.has(normTerm)) {
-            termMap.set(normTerm, {
+            allSubjects.add(identity);
+        // Value accumulator
+        if (!valueMap.has(normValue)) {
+            valueMap.set(normValue, {
                 count: 0,
-                searchers: new Set(),
-                zeroResults: 0,
-                firstCasing: rawTerm.trim(),
+                subjects: new Set(),
+                flagged: 0,
+                firstCasing: rawValue.trim(),
                 lastAt: row.captured_at,
             });
         }
-        const acc = termMap.get(normTerm);
+        const acc = valueMap.get(normValue);
         acc.count++;
         if (identity)
-            acc.searchers.add(identity);
-        if (isZero) {
-            acc.zeroResults++;
-            zeroResultSearches++;
+            acc.subjects.add(identity);
+        if (isFlagged) {
+            acc.flagged++;
+            flaggedCount++;
         }
         if (row.captured_at > acc.lastAt)
             acc.lastAt = row.captured_at;
         // Timestamp bucket (second precision) for fine-grained "over time"
         const ts = tsBucket(row.captured_at);
-        dayMap.set(ts, (dayMap.get(ts) ?? 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);
+        tsMap.set(ts, (tsMap.get(ts) ?? 0) + 1);
+        // Per-subject (real primary-identity only — no session fallback)
+        if (primary) {
+            if (!subjectMap.has(primary))
+                subjectMap.set(primary, { count: 0, values: new Set() });
+            const sa = subjectMap.get(primary);
+            sa.count++;
+            sa.values.add(normValue);
+        }
+        if (opts.numeric) {
+            const numDim = opts.numeric_dim ?? value_dim;
+            const n = Number(dims[numDim]);
+            if (isFinite(n))
+                numericValues.push(n);
         }
     }
-    const allTermEntries = [...termMap.entries()].map(([, acc]) => ({
-        term: acc.firstCasing,
+    const allValueEntries = [...valueMap.entries()].map(([, acc]) => ({
+        value: acc.firstCasing,
         count: acc.count,
-        searchers: acc.searchers.size,
-        zeroResults: acc.zeroResults,
-        lastSearchedAt: acc.lastAt,
+        subjects: acc.subjects.size,
+        flagged: acc.flagged,
+        lastAt: 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)
+    const top_values = [...allValueEntries].sort((a, b) => b.count - a.count).slice(0, topN_);
+    const flagged_values = allValueEntries
+        .filter((e) => e.flagged > 0)
+        .sort((a, b) => b.flagged - a.flagged)
         .slice(0, topN_);
     // Keep the most recent 100 timestamp buckets, chronological order.
-    const over_time = [...dayMap.entries()]
+    const over_time = [...tsMap.entries()]
         .sort((a, b) => a[0].localeCompare(b[0]))
         .slice(-100)
         .map(([day, count]) => ({ day, count }));
-    const per_user = [...userMap.entries()]
-        .map(([user_id, { count, terms }]) => ({
-        user_id,
+    const per_subject = [...subjectMap.entries()]
+        .map(([subject_id, { count, values }]) => ({
+        subject_id,
         count,
-        distinct_terms: terms.size,
-        terms: [...terms],
+        distinct_values: values.size,
+        values: [...values],
     }))
         .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,
+    const result = {
+        total: fieldRows.length,
+        unique_values: valueMap.size,
+        unique_subjects: allSubjects.size,
+        flagged_count: flaggedCount,
+        top_values,
+        flagged_values,
         over_time,
-        per_user,
+        per_subject,
+    };
+    if (opts.numeric) {
+        result.numeric_summary = computeNumericSummary(numericValues);
+    }
+    return result;
+}
+function toSearchTermEntry(e) {
+    return {
+        term: e.value,
+        count: e.count,
+        searchers: e.subjects,
+        zeroResults: e.flagged,
+        lastSearchedAt: e.lastAt,
+    };
+}
+function mapToLegacySearchShape(r) {
+    return {
+        total_searches: r.total,
+        unique_terms: r.unique_values,
+        unique_searchers: r.unique_subjects,
+        zero_result_searches: r.flagged_count,
+        top_terms: r.top_values.map(toSearchTermEntry),
+        zero_result_terms: r.flagged_values.map(toSearchTermEntry),
+        over_time: r.over_time,
+        per_user: r.per_subject.map((s) => ({
+            user_id: s.subject_id,
+            count: s.count,
+            distinct_terms: s.distinct_values,
+            terms: s.values,
+        })),
+    };
+}
+export async function searchQueries(adapter, opts) {
+    const result = await inputFieldAnalysis(adapter, {
+        app_id: opts.app_id,
+        scope_id: opts.scope_id,
+        since: opts.since,
+        metric_key: 'action.search',
+        value_dim: 'term',
+        flag_dim: 'result_count',
+        flag_predicate: (v) => Number(v) === 0,
+        topN: opts.topN,
+    });
+    return mapToLegacySearchShape(result);
+}
+export async function notFoundQueries(adapter, opts) {
+    const { app_id, scope_id, since, limit = 10000 } = opts;
+    const topN_ = opts.topN ?? 20;
+    const generic = await inputFieldAnalysis(adapter, {
+        app_id,
+        scope_id,
+        since,
+        metric_key: 'action.404',
+        value_dim: 'requested_path',
+        flag_dim: 'referrer_kind',
+        flag_predicate: (v) => v === 'internal',
+        topN: topN_,
+        case_sensitive: true, // paths are case-sensitive — '/Foo' and '/foo' must stay separate
+    });
+    const rows = await fetchWindow(adapter, { app_id, scope_id, since: since ?? defaultSince(), cap: limit });
+    const notFoundRows = rows.filter((r) => r.metric_key === 'action.404');
+    const bySource = { internal: 0, search: 0, external: 0, direct: 0 };
+    const sampleReferrerMap = new Map();
+    let total404s = 0;
+    for (const row of notFoundRows) {
+        const dims = parseDims(row.dimensions);
+        const requestedPath = typeof dims.requested_path === 'string' ? dims.requested_path : '';
+        if (!requestedPath)
+            continue;
+        total404s++;
+        const referrerKind = typeof dims.referrer_kind === 'string' && dims.referrer_kind ? dims.referrer_kind : 'direct';
+        const referrer = typeof dims.referrer === 'string' ? dims.referrer : '';
+        if (referrerKind === 'internal' || referrerKind === 'search' || referrerKind === 'external' || referrerKind === 'direct') {
+            bySource[referrerKind]++;
+        }
+        else {
+            bySource.external++;
+        }
+        if (!sampleReferrerMap.has(requestedPath) && referrer) {
+            sampleReferrerMap.set(requestedPath, referrer);
+        }
+    }
+    const top_paths = generic.top_values.map((v) => ({
+        path: v.value,
+        count: v.count,
+        lastAt: v.lastAt,
+        internalCount: v.flagged,
+        sampleReferrer: sampleReferrerMap.get(v.value) ?? '',
+    }));
+    return {
+        total_404s: total404s,
+        unique_paths: generic.unique_values,
+        internal_referrer_count: generic.flagged_count,
+        top_paths,
+        by_source: bySource,
+        over_time: generic.over_time,
     };
 }

package/dist/server/types.d.ts

@@ -66,6 +66,21 @@ export interface DatapointField {
     options?: string[];
 }
 export type DatapointSchema = DatapointField[];
+export interface AnalyzableField extends DatapointField {
+    /** Event name this field's values are captured under, e.g. 'action.search'. */
+    metric_key: string;
+    /** Dimension holding the value to analyze, e.g. 'term' | 'label'. */
+    value_dim: string;
+    /** Optional separate numeric dimension (defaults to value_dim), e.g. 'amount'. */
+    numeric_dim?: string;
+    /** Privacy gate — false means never captured server-side or returned by the API. */
+    aggregatable: boolean;
+    /** Optional "content gap" signal, e.g. zero-result searches or broken internal links. */
+    flag?: {
+        dim: string;
+        predicate: (v: unknown) => boolean;
+    };
+}
 export interface ActionDef {
     action_key: string;
     app_id: string;

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

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

package/dist/ui/index.d.ts

@@ -4,6 +4,8 @@ export * from './actions_panel.js';
 export * from './analytics_panel.js';
 export * from './datapoint_panel.js';
 export * from './journey_panel.js';
+export * from './input_field_panel.js';
 export * from './search_queries_panel.js';
+export * from './not_found_panel.js';
 export * from './ga4_connection_card.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,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}

package/dist/ui/index.js

@@ -6,5 +6,7 @@ export * from './actions_panel.js';
 export * from './analytics_panel.js';
 export * from './datapoint_panel.js';
 export * from './journey_panel.js';
+export * from './input_field_panel.js';
 export * from './search_queries_panel.js';
+export * from './not_found_panel.js';
 export * from './ga4_connection_card.js';

package/dist/ui/input_field_panel.d.ts

@@ -0,0 +1,43 @@
+export interface UserProfile {
+    id: string;
+    name?: string;
+    email?: string;
+    avatar_url?: string;
+}
+export declare function MiniBar({ value, max, color }: {
+    value: number;
+    max: number;
+    color?: string;
+}): import("react").JSX.Element;
+export declare function SummaryCard({ label, value }: {
+    label: string;
+    value: number | string;
+}): import("react").JSX.Element;
+export interface InputFieldPanelLabels {
+    totalLabel: string;
+    uniqueValuesLabel: string;
+    uniqueSubjectsLabel: string;
+    flaggedLabel: string;
+    topValuesTitle: string;
+    emptyTopValues: string;
+    flaggedSectionTitle: string;
+    flaggedSectionSubtitle: string;
+    overTimeTitle: string;
+    perSubjectTitle: string;
+    subjectColumnLabel: string;
+    countColumnLabel: string;
+    distinctColumnLabel: string;
+    recentValuesColumnLabel: string;
+    distributionTitle: string;
+}
+export declare const SEARCH_LABELS: InputFieldPanelLabels;
+export interface InputFieldPanelProps {
+    appId: string;
+    apiBase: string;
+    fieldKey: string;
+    labels?: Partial<InputFieldPanelLabels>;
+    since?: string;
+    resolveUserProfiles?: (ids: string[]) => Promise<UserProfile[]>;
+}
+export declare function InputFieldPanel({ appId, apiBase, fieldKey, labels: labelsOverride, since, resolveUserProfiles }: InputFieldPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=input_field_panel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input_field_panel.d.ts","sourceRoot":"","sources":["../../src/ui/input_field_panel.tsx"],"names":[],"mappings":"AAyGA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAiB,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,+BAUxG;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,+BAOtF;AAMD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAuBD,eAAO,MAAM,aAAa,EAAE,qBAgB3B,CAAC;AAMF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACjE;AAWD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,oBAAoB,+BAsKrI"}

package/dist/ui/input_field_panel.js

@@ -0,0 +1,173 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// hazo_umetrics/src/ui/input_field_panel.tsx — generic manual-input field
+// analytics panel. Generalizes search_queries_panel.tsx per input-analyzer
+// spec §7: same summary-cards + top-values + over-time + per-subject layout,
+// configurable labels, plus a numeric mode (percentile strip + histogram)
+// for fields analyzed with `numeric: true` (e.g. expense amounts).
+import { useState, useEffect } from 'react';
+function normalizeSearchQueriesResult(r) {
+    const toEntry = (t) => ({
+        value: t.term,
+        count: t.count,
+        subjects: t.searchers,
+        flagged: t.zeroResults,
+        lastAt: t.lastSearchedAt,
+    });
+    return {
+        total: r.total_searches,
+        unique_values: r.unique_terms,
+        unique_subjects: r.unique_searchers,
+        flagged_count: r.zero_result_searches,
+        top_values: r.top_terms.map(toEntry),
+        flagged_values: r.zero_result_terms.map(toEntry),
+        over_time: r.over_time,
+        per_subject: r.per_user.map((u) => ({
+            subject_id: u.user_id,
+            count: u.count,
+            distinct_values: u.distinct_terms,
+            values: u.terms,
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// Shared primitives (extracted from the original search_queries_panel)
+// ---------------------------------------------------------------------------
+// Format a stored timestamp ("…T…Z" or "YYYY-MM-DD HH:MM:SS") to second precision.
+function fmtTs(iso) {
+    if (!iso)
+        return '';
+    return iso.slice(0, 19).replace('T', ' ');
+}
+export 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 })] }));
+}
+export 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 })] }));
+}
+const DEFAULT_LABELS = {
+    totalLabel: 'Total',
+    uniqueValuesLabel: 'Unique Values',
+    uniqueSubjectsLabel: 'Unique Subjects',
+    flaggedLabel: 'Flagged',
+    topValuesTitle: 'Top Values',
+    emptyTopValues: 'No values recorded yet.',
+    flaggedSectionTitle: 'Flagged Values',
+    flaggedSectionSubtitle: '(content gaps)',
+    overTimeTitle: 'Over Time',
+    perSubjectTitle: 'Per-Subject',
+    subjectColumnLabel: 'Subject',
+    countColumnLabel: 'Count',
+    distinctColumnLabel: 'Distinct Values',
+    recentValuesColumnLabel: 'Recent Values',
+    distributionTitle: 'Distribution',
+};
+// The exact copy the original search_queries_panel shipped — reused by the
+// SearchQueriesPanel preset wrapper (search_queries_panel.tsx) so its labels
+// are unchanged.
+export const SEARCH_LABELS = {
+    totalLabel: 'Total Searches',
+    uniqueValuesLabel: 'Unique Terms',
+    uniqueSubjectsLabel: 'Unique Searchers',
+    flaggedLabel: 'Zero-Result Searches',
+    topValuesTitle: 'Top Search Terms',
+    emptyTopValues: 'No searches recorded yet.',
+    flaggedSectionTitle: 'Zero-Result Terms',
+    flaggedSectionSubtitle: '(content gaps)',
+    overTimeTitle: 'Searches Over Time',
+    perSubjectTitle: 'Per-User Searches',
+    subjectColumnLabel: 'User',
+    countColumnLabel: 'Searches',
+    distinctColumnLabel: 'Distinct Terms',
+    recentValuesColumnLabel: 'Recent Terms',
+    distributionTitle: 'Distribution',
+};
+// field_key -> endpoint. Only 'search_query' talks to the legacy
+// GET /analytics/search-queries route (byte-identical wire format to the
+// original SearchQueriesPanel) so existing consumer apps keep working
+// untouched on upgrade. Every other field_key hits the generic
+// GET /analytics/input-field route.
+function endpointFor(fieldKey) {
+    return fieldKey === 'search_query' ? '/analytics/search-queries' : '/analytics/input-field';
+}
+export function InputFieldPanel({ appId, apiBase, fieldKey, labels: labelsOverride, since, resolveUserProfiles }) {
+    const labels = { ...DEFAULT_LABELS, ...labelsOverride };
+    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 endpoint = endpointFor(fieldKey);
+        const params = new URLSearchParams({ app_id: appId });
+        if (since)
+            params.set('since', since);
+        if (endpoint === '/analytics/input-field')
+            params.set('field_key', fieldKey);
+        fetch(`${apiBase}${endpoint}?${params}`, { credentials: 'include' })
+            .then((r) => r.json().catch(() => null))
+            .then((body) => {
+            if (cancelled)
+                return;
+            const raw = body?.data;
+            const normalized = raw == null
+                ? null
+                : endpoint === '/analytics/search-queries'
+                    ? normalizeSearchQueriesResult(raw)
+                    : raw;
+            setData(normalized);
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (cancelled)
+                return;
+            setError(err instanceof Error ? err.message : 'Load error');
+            setLoading(false);
+        });
+        return () => { cancelled = true; };
+    }, [appId, apiBase, fieldKey, since]);
+    // Resolve user profiles after data loads
+    useEffect(() => {
+        if (!data || !resolveUserProfiles || data.per_subject.length === 0)
+            return;
+        const ids = data.per_subject.map((s) => s.subject_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 isNumeric = data.numeric_summary != null;
+    const maxValueCount = data.top_values.length > 0 ? Math.max(...data.top_values.map((t) => t.count), 1) : 1;
+    const maxFlaggedCount = data.flagged_values.length > 0 ? Math.max(...data.flagged_values.map((t) => t.flagged), 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: labels.totalLabel, value: data.total }), _jsx(SummaryCard, { label: labels.uniqueValuesLabel, value: data.unique_values }), _jsx(SummaryCard, { label: labels.uniqueSubjectsLabel, value: data.unique_subjects }), _jsx(SummaryCard, { label: labels.flaggedLabel, value: data.flagged_count })] }), isNumeric ? (_jsx(NumericSummarySection, { summary: data.numeric_summary, title: labels.distributionTitle })) : (_jsxs(_Fragment, { children: [_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: labels.topValuesTitle }), data.top_values.length === 0 ? (_jsx("p", { className: "text-xs text-gray-400", children: labels.emptyTopValues })) : (_jsx("div", { className: "flex flex-col gap-1", children: data.top_values.map((t) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-gray-600 w-32 truncate", title: t.value, children: t.value }), _jsx(MiniBar, { value: t.count, max: maxValueCount }), _jsx("span", { className: "text-[10px] text-gray-400 tabular-nums whitespace-nowrap w-32 text-right", title: `Last seen ${t.lastAt}`, children: fmtTs(t.lastAt) })] }, t.value))) }))] }), data.flagged_values.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: [labels.flaggedSectionTitle, " ", _jsx("span", { className: "text-xs font-normal text-amber-600", children: labels.flaggedSectionSubtitle })] }), _jsx("div", { className: "flex flex-col gap-1", children: data.flagged_values.map((t) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-amber-700 w-32 truncate", title: t.value, children: t.value }), _jsx(MiniBar, { value: t.flagged, max: maxFlaggedCount, color: "#f59e0b" }), _jsx("span", { className: "text-[10px] text-amber-600 tabular-nums whitespace-nowrap w-32 text-right", title: `Last seen ${t.lastAt}`, children: fmtTs(t.lastAt) })] }, t.value))) })] }))] })), 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: labels.overTimeTitle }), _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 tabular-nums w-36 whitespace-nowrap", children: fmtTs(d.day) }), _jsx(MiniBar, { value: d.count, max: maxDayCount, color: "#10b981" })] }, d.day))) })] })), data.per_subject.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: labels.perSubjectTitle }), _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: labels.subjectColumnLabel }), _jsx("th", { className: "py-1 pr-4 font-medium tabular-nums", children: labels.countColumnLabel }), _jsx("th", { className: "py-1 pr-4 font-medium tabular-nums", children: labels.distinctColumnLabel }), _jsx("th", { className: "py-1 font-medium", children: labels.recentValuesColumnLabel })] }) }), _jsx("tbody", { children: data.per_subject.map((s) => {
+                                        const profile = profiles.get(s.subject_id);
+                                        const displayName = profile?.name ?? profile?.email ?? s.subject_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: s.count }), _jsx("td", { className: "py-1 pr-4 tabular-nums text-gray-600", children: s.distinct_values }), _jsxs("td", { className: "py-1 text-gray-500", children: [s.values.slice(0, 5).join(', '), s.values.length > 5 ? '…' : ''] })] }, s.subject_id));
+                                    }) })] }) })] }))] }));
+}
+// ---------------------------------------------------------------------------
+// NumericSummarySection — percentile strip + histogram, replaces the
+// top-values list when the field is numeric (e.g. expense amounts).
+// ---------------------------------------------------------------------------
+function fmtNum(v) {
+    return (Math.round(v * 100) / 100).toLocaleString();
+}
+function NumericSummarySection({ summary, title }) {
+    const maxBucketCount = summary.histogram.length > 0 ? Math.max(...summary.histogram.map((b) => b.count), 1) : 1;
+    return (_jsxs("div", { className: "rounded-lg border bg-white p-4 flex flex-col gap-4", children: [_jsx("h3", { className: "text-sm font-semibold text-gray-700", children: title }), _jsxs("div", { className: "grid grid-cols-3 md:grid-cols-6 gap-3", children: [_jsx(PercentileStat, { label: "Min", value: summary.min }), _jsx(PercentileStat, { label: "P25", value: summary.p25 }), _jsx(PercentileStat, { label: "Median", value: summary.median }), _jsx(PercentileStat, { label: "P75", value: summary.p75 }), _jsx(PercentileStat, { label: "Max", value: summary.max }), _jsx(PercentileStat, { label: "Mean", value: summary.mean })] }), summary.histogram.length > 0 && (_jsx("div", { className: "flex flex-col gap-1", children: summary.histogram.map((b) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-[10px] text-gray-400 tabular-nums w-28 whitespace-nowrap", title: b.bucket, children: b.bucket }), _jsx(MiniBar, { value: b.count, max: maxBucketCount, color: "#8b5cf6" })] }, b.bucket))) }))] }));
+}
+function PercentileStat({ label, value }) {
+    return (_jsxs("div", { className: "flex flex-col gap-0.5", children: [_jsx("p", { className: "text-[10px] text-gray-400 uppercase tracking-wide", children: label }), _jsx("p", { className: "text-sm font-semibold text-gray-800 tabular-nums", children: fmtNum(value) })] }));
+}

package/dist/ui/not_found_panel.d.ts

@@ -0,0 +1,6 @@
+export interface NotFoundPanelProps {
+    appId: string;
+    apiBase: string;
+}
+export declare function NotFoundPanel({ appId, apiBase }: NotFoundPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=not_found_panel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"not_found_panel.d.ts","sourceRoot":"","sources":["../../src/ui/not_found_panel.tsx"],"names":[],"mappings":"AA4FA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,kBAAkB,+BAiKnE"}

package/dist/ui/not_found_panel.js

@@ -0,0 +1,79 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+const WINDOW_KEYS = ['Total', '24h', '7d', '28d', '90d'];
+function windowKeyToSince(key) {
+    if (key === 'Total')
+        return undefined;
+    const days = key === '24h' ? 1 : key === '7d' ? 7 : key === '28d' ? 28 : 90;
+    const d = new Date();
+    d.setDate(d.getDate() - days);
+    return d.toISOString();
+}
+// ---------------------------------------------------------------------------
+// MiniBar
+// ---------------------------------------------------------------------------
+// Format a stored timestamp ("…T…Z" or "YYYY-MM-DD HH:MM:SS") to second precision.
+function fmtTs(iso) {
+    if (!iso)
+        return '';
+    return iso.slice(0, 19).replace('T', ' ');
+}
+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 NotFoundPanel({ appId, apiBase }) {
+    const [windowKey, setWindowKey] = useState('Total');
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const since = windowKeyToSince(windowKey);
+    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/not-found?${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]);
+    const windowTabs = (_jsx("div", { className: "flex flex-wrap gap-2", children: WINDOW_KEYS.map((key) => (_jsx("button", { type: "button", onClick: () => setWindowKey(key), className: key === windowKey
+                ? 'px-3 py-1 rounded text-xs font-medium bg-gray-800 text-white'
+                : 'px-3 py-1 rounded text-xs font-medium border border-gray-200 text-gray-500 hover:bg-gray-50', children: key }, key))) }));
+    if (loading) {
+        return (_jsxs("div", { className: "flex flex-col gap-6 p-4", children: [windowTabs, _jsx("div", { className: "p-4 text-xs text-gray-400", children: "Loading\u2026" })] }));
+    }
+    if (error) {
+        return (_jsxs("div", { className: "flex flex-col gap-6 p-4", children: [windowTabs, _jsx("div", { className: "rounded-lg border border-red-200 bg-red-50 p-3 text-xs text-red-700", children: error })] }));
+    }
+    if (!data) {
+        return (_jsxs("div", { className: "flex flex-col gap-6 p-4", children: [windowTabs, _jsx("div", { className: "rounded-lg border p-6 text-center text-sm text-gray-400", children: "No data yet." })] }));
+    }
+    const maxPathCount = data.top_paths.length > 0 ? Math.max(...data.top_paths.map((p) => p.count), 1) : 1;
+    const maxDayCount = data.over_time.length > 0 ? Math.max(...data.over_time.map((d) => d.count), 1) : 1;
+    const maxSourceCount = Math.max(data.by_source.internal, data.by_source.search, data.by_source.external, data.by_source.direct, 1);
+    return (_jsxs("div", { className: "flex flex-col gap-6 p-4", children: [windowTabs, _jsxs("div", { className: "grid grid-cols-2 md:grid-cols-4 gap-4", children: [_jsx(SummaryCard, { label: "Total 404s", value: data.total_404s }), _jsx(SummaryCard, { label: "Unique Paths", value: data.unique_paths }), _jsx(SummaryCard, { label: "Internal Broken Links", value: data.internal_referrer_count }), _jsx(SummaryCard, { label: "Direct / Typed", value: data.by_source.direct })] }), _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 Missing Paths" }), data.top_paths.length === 0 ? (_jsx("p", { className: "text-xs text-gray-400", children: "No 404s recorded yet." })) : (_jsx("div", { className: "flex flex-col gap-1", children: data.top_paths.map((p) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-gray-600 w-40 truncate", title: p.path, children: p.path }), p.internalCount > 0 && (_jsx("span", { className: "text-[10px] font-medium px-1.5 py-0.5 rounded-full border border-amber-200 bg-amber-50 text-amber-800 whitespace-nowrap", children: "broken internal link" })), _jsx(MiniBar, { value: p.count, max: maxPathCount }), _jsx("span", { className: "text-[10px] text-gray-400 tabular-nums whitespace-nowrap", title: `Last seen ${p.lastAt}`, children: fmtTs(p.lastAt) })] }, p.path))) }))] }), _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: "Traffic Source" }), _jsxs("div", { className: "flex flex-col gap-1", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-gray-600 w-40", children: "Internal (broken links)" }), _jsx(MiniBar, { value: data.by_source.internal, max: maxSourceCount, color: "#f59e0b" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-gray-600 w-40", children: "Search" }), _jsx(MiniBar, { value: data.by_source.search, max: maxSourceCount })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-gray-600 w-40", children: "External" }), _jsx(MiniBar, { value: data.by_source.external, max: maxSourceCount })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-gray-600 w-40", children: "Direct" }), _jsx(MiniBar, { value: data.by_source.direct, max: maxSourceCount })] })] })] }), 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: "404s 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 tabular-nums w-36 whitespace-nowrap", children: fmtTs(d.day) }), _jsx(MiniBar, { value: d.count, max: maxDayCount, color: "#10b981" })] }, d.day))) })] }))] }));
+}

package/dist/ui/search_queries_panel.d.ts

@@ -1,9 +1,4 @@
-interface UserProfile {
-    id: string;
-    name?: string;
-    email?: string;
-    avatar_url?: string;
-}
+import type { UserProfile } from './input_field_panel.js';
 export interface SearchQueriesPanelProps {
     appId: string;
     apiBase: string;
@@ -11,5 +6,4 @@ export interface SearchQueriesPanelProps {
     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

@@ -1 +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;AAoDD,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,+BAmJzG"}
+{"version":3,"file":"search_queries_panel.d.ts","sourceRoot":"","sources":["../../src/ui/search_queries_panel.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,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,+BAWzG"}

package/dist/ui/search_queries_panel.js

@@ -1,77 +1,15 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState, useEffect } from 'react';
-// ---------------------------------------------------------------------------
-// MiniBar
-// ---------------------------------------------------------------------------
-// Format a stored timestamp ("…T…Z" or "YYYY-MM-DD HH:MM:SS") to second precision.
-function fmtTs(iso) {
-    if (!iso)
-        return '';
-    return iso.slice(0, 19).replace('T', ' ');
-}
-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 })] }));
-}
+import { jsx as _jsx } from "react/jsx-runtime";
+// hazo_umetrics/src/ui/search_queries_panel.tsx — back-compat preset.
+//
+// Generalized into ui/input_field_panel.tsx (input-analyzer spec §7). This
+// file is now a thin wrapper around InputFieldPanel so existing consumer
+// apps (gotimer/stocktools/kinstripe) keep importing SearchQueriesPanel with
+// unchanged props, unchanged copy, and — critically — an unchanged wire
+// format: InputFieldPanel special-cases fieldKey="search_query" to keep
+// talking to the original GET /analytics/search-queries route rather than
+// the new generic /analytics/input-field route. Zero behaviour change.
+import { InputFieldPanel, SEARCH_LABELS } from './input_field_panel.js';
 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 }), _jsx("span", { className: "text-[10px] text-gray-400 tabular-nums whitespace-nowrap w-32 text-right", title: `Last searched ${t.lastSearchedAt}`, children: fmtTs(t.lastSearchedAt) })] }, 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" }), _jsx("span", { className: "text-[10px] text-amber-600 tabular-nums whitespace-nowrap w-32 text-right", title: `Last searched ${t.lastSearchedAt}`, children: fmtTs(t.lastSearchedAt) })] }, 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 tabular-nums w-36 whitespace-nowrap", children: fmtTs(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));
-                                    }) })] }) })] }))] }));
+    return (_jsx(InputFieldPanel, { appId: appId, apiBase: apiBase, fieldKey: "search_query", labels: SEARCH_LABELS, since: since, resolveUserProfiles: resolveUserProfiles }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_umetrics",
-  "version": "1.11.0",
+  "version": "1.13.1",
   "description": "Product analytics for hazo apps — GA4 hybrid + first-party stat store + feature flags",
   "type": "module",
   "module": "./dist/index.js",
@@ -51,11 +51,11 @@
     "hazo_logs": "^2.1.1",
     "hazo_config": "^2.4.1",
     "hazo_connect": "^3.9.2",
-    "hazo_api": "^2.5.1",
-    "hazo_auth": "^10.8.2",
+    "hazo_api": "^2.6.0",
+    "hazo_auth": "^10.9.0",
     "hazo_secure": "^1.4.0",
     "hazo_audit": "^2.1.2",
-    "hazo_ui": "^6.0.0",
+    "hazo_ui": "^6.1.0",
     "next": "^14.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"