hazo_umetrics 1.9.0 → 1.10.0

package/CHANGE_LOG.md

@@ -1,5 +1,49 @@
 # hazo_umetrics — Change Log
 
+## 1.10.0 — Per-app windowed metrics (registry + Total/24h/7d/28d/90d + graph)
+
+**New features (minor — additive; existing `MetricsPanel`/`statSnapshotJob` unaffected):**
+
+### Per-app metric registry + windowed read (`src/server/metrics.ts`, new)
+- `registerMetrics({ app_id, metrics })` / `getRegisteredMetrics(app_id)` — module-level `Map<app_id, MetricDef[]>`, idempotent/merge-by-`(app_id, key)` (HMR/cold-start safe). Mirrors `registerStatCollector` but keyed per app; code is the single source of truth (`stat_def` stays dormant).
+- `getMetricWindows(adapter, { app_id, scope_id?, days=90 })` → `MetricWindow[]`. Per registered metric: `ga4` → `pending` (all-null, empty series); `db` → per-key `getStatSeries`, collapse to one point per UTC day (last-write-wins), `total = latest`, `delta_Nd = total − value_as_of(now−Nd)` where `value_as_of` walks back to the last daily point `≤ target` (gap-day safe); no point ≤ target → `null`. Per-key reads only — never pulls `ui.*`/`action.*` rows from the shared table.
+- `runMetricSnapshot(adapter, { app_id })` — records one row per `db` metric via `collect`; **idempotent per UTC day** (skips a metric already snapshotted today). Guards nightly + manual re-runs.
+- `metricSnapshotJob: MaintenanceJob` — `type: 'hazo_umetrics.metric_snapshot'`, `defaultCron: '0 3 * * *'`.
+- `backfillDailySnapshots(adapter, { app_id, metric_key, valueAsOf, from, to? })` — one-time historical fill, one row per UTC day, skips days already present.
+
+### Types (`src/server/types.ts`)
+- Added `MetricDef` (`key/label/format/source:'db'|'ga4'/collect?/backfill?`), `MetricSeriesPoint`, `MetricWindow`.
+
+### `recordStat` (`src/server/stats.ts`) — optional `captured_at`
+- Added an optional `captured_at?: string` param (non-breaking; defaults to now) so snapshot/backfill can write day-stamped rows.
+
+### API (`src/api/index.ts`)
+- `createStatHandlers` gains `getMetricWindows` — `GET …/stats/windows?app_id=&days=`, gated on `metrics.view`, returns `{ windows }`. Mirrors the `getStatSeries` handler.
+
+### UI (`src/ui/metrics_tab.tsx`, new)
+- `MetricsTab({ appId })` — fetches `/api/hazo_umetrics/stats/windows`, renders **WindowGrid** (row per metric: `Total | 24h | 7d | 28d | 90d`, sign-coloured deltas, `null`→"—", `ga4` rows show a muted "GA4 pending" badge) + **Graph** (metric `<select>` + `[24h][7d][28d][90d][All]` filter → `LineChart`). 401/403 → same `metrics.view` empty state as `MetricsPanel`.
+
+### Tests / test-app
+- New `__tests__/metrics.test.ts` (8 cases: window diffing, gap days, before-first-point null, ga4 pending, same-day collapse, snapshot idempotency, backfill idempotency).
+- Test-app: new `/metrics-windows` demo page + `stats/windows` route + `register_window_metrics` module; seeder now emits 90-day daily snapshots (with deliberate gap days) for demo `db` metrics.
+
+## 1.9.2 — Journey panel: name-first user labels, calmer flow-graph arrows
+
+**Fixes / UI polish (patch — no public API or type changes):**
+
+### `IdentityDropdown` — show name before email
+- `labelFor(id)` now falls back **name → email → short-uuid** (was email → name → short-uuid), matching `SessionDetail`'s ordering. The raw uuid only shows when a profile resolves to neither a name nor an email.
+
+### `JourneyFlowGraph` — arrows no longer render "messed up"
+- Arrowhead `<marker>` now sets `markerUnits="userSpaceOnUse"` so the head stays a constant size instead of scaling with edge `strokeWidth` (thick edges previously got oversized, broken-looking heads).
+- Edge routing simplified: forward edges always use a clean right→left horizontal cubic (steep forward edges no longer get shoved into top/bottom ports). Back-edge and same-column vertical routing unchanged; both `multiSidePorts`/`backEdgeLoop` props remain as escape hatches.
+- Curvature clamped: control distance is now `max(30, min(dist*0.4, 120))` (was `max(40, dist*0.5)`) so long edges don't balloon.
+
+## 1.9.1 — Journey panel: absolute per-step timestamps
+
+### `SessionDetail` — absolute per-step timestamps
+- Each step row now shows a local `HH:MM:SS` clock time (`fmtClock`) alongside the existing relative gap; the session header shows the start date (`fmtDateTime`). Data (`step.captured_at`) was already present, just unrendered.
+
 ## 1.9.0 — Search queries: per-term last-searched timestamps, second-precision "over time"
 
 **New features (minor — no code-level breaking changes):**

package/dist/api/index.d.ts

@@ -55,6 +55,12 @@ export declare function createStatHandlers(options: ApiFactoryOptions): {
      * Appends a new stat reading.
      */
     recordStat(req: Request): Promise<Response>;
+    /**
+     * GET /...?app_id=<id>[&days=<n>]
+     * Returns windowed roll-ups (total/d1/d7/d28/d90 + daily series) for
+     * every metric registered against app_id via registerMetrics().
+     */
+    getMetricWindows(req: Request): Promise<Response>;
 };
 export declare function createExperimentHandlers(options: ApiFactoryOptions): {
     /**

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

@@ -6,6 +6,7 @@
 // or callers supply their own `getAuth` implementation.
 import { createCrudService } from 'hazo_connect/server';
 import { recordStat as _recordStat, getLatestStat as _getLatestStat, getStatSeries as _getStatSeries, } from '../server/stats.js';
+import { getMetricWindows as _getMetricWindows } from '../server/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';
@@ -162,6 +163,30 @@ export function createStatHandlers(options) {
             });
             return jsonOk({ recorded: true }, 201);
         },
+        /**
+         * GET /...?app_id=<id>[&days=<n>]
+         * Returns windowed roll-ups (total/d1/d7/d28/d90 + daily series) for
+         * every metric registered against app_id via registerMetrics().
+         */
+        async getMetricWindows(req) {
+            const url = new URL(req.url);
+            const app_id = url.searchParams.get('app_id') ?? '';
+            const daysParam = url.searchParams.get('days');
+            const days = daysParam != null ? parseInt(daysParam, 10) : 90;
+            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 windows = await _getMetricWindows(adapter, { app_id, days });
+            return jsonOk({ windows });
+        },
     };
 }
 export function createExperimentHandlers(options) {

package/dist/lib/index.d.ts

@@ -1,5 +1,6 @@
 export * from '../server/types.js';
 export * from '../server/stats.js';
+export * from '../server/metrics.js';
 export * from '../server/actions.js';
 export * from '../server/flags.js';
 export * from '../server/cookie.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/lib/index.js

@@ -1,6 +1,7 @@
 // hazo_umetrics/src/lib/index.ts — re-exports server-side modules
 export * from '../server/types.js';
 export * from '../server/stats.js';
+export * from '../server/metrics.js';
 export * from '../server/actions.js';
 export * from '../server/flags.js';
 export * from '../server/cookie.js';

package/dist/server/metrics.d.ts

@@ -0,0 +1,62 @@
+import type { HazoConnectAdapter } from 'hazo_connect/server';
+import type { MetricDef, MetricWindow, MaintenanceJob } from './types.js';
+/** Formats a Date as a 'YYYY-MM-DD' string in UTC. */
+export declare function dayString(d: Date): string;
+/** Returns the 'YYYY-MM-DD' string for `days` days before `from` (UTC). */
+export declare function daysAgoString(days: number, from?: Date): string;
+/**
+ * Registers metric definitions for an app. Idempotent by (app_id, key):
+ * re-registering replaces the def with the same key, leaves others intact.
+ * Safe to call repeatedly (HMR / cold-start) — last registration per key wins.
+ */
+export declare function registerMetrics(params: {
+    app_id: string;
+    metrics: MetricDef[];
+}): void;
+/** Returns the metric defs registered for an app (empty array if none). */
+export declare function getRegisteredMetrics(app_id: string): MetricDef[];
+/**
+ * Returns a MetricWindow (total + d1/d7/d28/d90 deltas + daily series) for
+ * each metric registered against app_id. ga4-sourced metrics are returned as
+ * pending stubs (M1 wires GA4 Data API reads). db-sourced metrics are read
+ * from the stat store per-key via getStatSeries (never a shared query), then
+ * collapsed to one point per UTC day before diffing.
+ */
+export declare function getMetricWindows(adapter: HazoConnectAdapter, params: {
+    app_id: string;
+    scope_id?: string;
+    days?: number;
+}): Promise<MetricWindow[]>;
+/**
+ * Runs collect() for every registered db metric (those with a `collect` fn)
+ * and appends one stat row per metric — unless a snapshot for today (UTC)
+ * already exists, in which case it's skipped. ga4 metrics are never touched.
+ */
+export declare function runMetricSnapshot(adapter: HazoConnectAdapter, params: {
+    app_id: string;
+}): Promise<Array<{
+    key: string;
+    value: number;
+    skipped: boolean;
+}>>;
+/**
+ * MaintenanceJob-shaped export for M1 job wiring — daily metric snapshots.
+ */
+export declare const metricSnapshotJob: MaintenanceJob;
+/**
+ * Backfills daily snapshot rows for a db metric over [from, to] (UTC,
+ * 'YYYY-MM-DD', inclusive; `to` defaults to today). For each day, if a
+ * snapshot already exists it's skipped (idempotent); otherwise `valueAsOf`
+ * is called for that day and recorded with captured_at = day @ 00:00:00Z.
+ */
+export declare function backfillDailySnapshots(adapter: HazoConnectAdapter, params: {
+    app_id: string;
+    metric_key: string;
+    valueAsOf: (date: string) => Promise<number>;
+    from: string;
+    to?: string;
+}): Promise<{
+    inserted: number;
+    skipped: number;
+}>;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/server/metrics.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAqB,YAAY,EAAE,cAAc,EAAQ,MAAM,YAAY,CAAC;AAOnG,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAEzC;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,CAE3E;AAyDD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAYtF;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAEhE;AAMD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,YAAY,EAAE,CAAC,CAoDzB;AA0BD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CA+BlE;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAM/B,CAAC;AAMF;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BhD"}

package/dist/server/metrics.js

@@ -0,0 +1,243 @@
+// hazo_umetrics/src/server/metrics.ts — metric registry, windowed roll-ups
+// (total / d1 / d7 / d28 / d90), daily snapshot job, and historical backfill.
+//
+// Mirrors src/server/stats.ts conventions: append-only readings via
+// recordStat/getStatSeries, module-level registry, MaintenanceJob export.
+import { recordStat, getStatSeries } from './stats.js';
+// ---------------------------------------------------------------------------
+// Day-string helpers (UTC throughout, pure + testable)
+// ---------------------------------------------------------------------------
+/** Formats a Date as a 'YYYY-MM-DD' string in UTC. */
+export function dayString(d) {
+    return d.toISOString().slice(0, 10);
+}
+/** Returns the 'YYYY-MM-DD' string for `days` days before `from` (UTC). */
+export function daysAgoString(days, from = new Date()) {
+    return dayString(new Date(from.getTime() - days * 86400000));
+}
+/** Enumerates 'YYYY-MM-DD' strings from `from` to `to` inclusive (UTC). */
+function iterateDaysUTC(from, to) {
+    const days = [];
+    let cursor = new Date(`${from}T00:00:00.000Z`).getTime();
+    const end = new Date(`${to}T00:00:00.000Z`).getTime();
+    while (cursor <= end) {
+        days.push(new Date(cursor).toISOString().slice(0, 10));
+        cursor += 86400000;
+    }
+    return days;
+}
+// ---------------------------------------------------------------------------
+// Series helpers
+// ---------------------------------------------------------------------------
+/**
+ * Collapses raw (ascending-by-captured_at) stat readings to one point per
+ * UTC day. Last-write-wins: when multiple readings land on the same day,
+ * the one with the latest captured_at (the last one encountered, since
+ * input is ascending) wins. Result is sorted ascending by date.
+ */
+function collapseToDailyPoints(stats) {
+    const byDay = new Map();
+    for (const s of stats) {
+        byDay.set(s.captured_at.slice(0, 10), s.value);
+    }
+    return Array.from(byDay.entries())
+        .map(([date, value]) => ({ date, value }))
+        .sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : 0));
+}
+/**
+ * Value of the metric as of `targetDate` — the last daily point whose date
+ * is <= targetDate (walks back over gap days). Returns null when no such
+ * point exists (targetDate predates the first point, or there are no points).
+ */
+function valueAsOfDate(points, targetDate) {
+    let result = null;
+    for (const p of points) {
+        if (p.date <= targetDate) {
+            result = p.value;
+        }
+        else {
+            break;
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Metric registry
+// ---------------------------------------------------------------------------
+const _metricsRegistry = new Map();
+/**
+ * Registers metric definitions for an app. Idempotent by (app_id, key):
+ * re-registering replaces the def with the same key, leaves others intact.
+ * Safe to call repeatedly (HMR / cold-start) — last registration per key wins.
+ */
+export function registerMetrics(params) {
+    const existing = _metricsRegistry.get(params.app_id) ?? [];
+    const merged = [...existing];
+    for (const def of params.metrics) {
+        const idx = merged.findIndex((m) => m.key === def.key);
+        if (idx >= 0) {
+            merged[idx] = def;
+        }
+        else {
+            merged.push(def);
+        }
+    }
+    _metricsRegistry.set(params.app_id, merged);
+}
+/** Returns the metric defs registered for an app (empty array if none). */
+export function getRegisteredMetrics(app_id) {
+    return _metricsRegistry.get(app_id) ?? [];
+}
+// ---------------------------------------------------------------------------
+// Windowed roll-ups
+// ---------------------------------------------------------------------------
+/**
+ * Returns a MetricWindow (total + d1/d7/d28/d90 deltas + daily series) for
+ * each metric registered against app_id. ga4-sourced metrics are returned as
+ * pending stubs (M1 wires GA4 Data API reads). db-sourced metrics are read
+ * from the stat store per-key via getStatSeries (never a shared query), then
+ * collapsed to one point per UTC day before diffing.
+ */
+export async function getMetricWindows(adapter, params) {
+    const { app_id, scope_id, days = 90 } = params;
+    const now = new Date();
+    const since = new Date(now.getTime() - days * 86400000).toISOString();
+    const windows = [];
+    for (const def of getRegisteredMetrics(app_id)) {
+        if (def.source === 'ga4') {
+            windows.push({
+                metric_key: def.key,
+                label: def.label,
+                format: def.format,
+                source: 'ga4',
+                pending: true,
+                total: null,
+                d1: null,
+                d7: null,
+                d28: null,
+                d90: null,
+                series: [],
+            });
+            continue;
+        }
+        const stats = await getStatSeries(adapter, { app_id, scope_id, metric_key: def.key, since });
+        const points = collapseToDailyPoints(stats);
+        const total = points.length > 0 ? points[points.length - 1].value : null;
+        const delta = (n) => {
+            if (total == null)
+                return null;
+            const asOf = valueAsOfDate(points, daysAgoString(n, now));
+            if (asOf == null)
+                return null;
+            return total - asOf;
+        };
+        windows.push({
+            metric_key: def.key,
+            label: def.label,
+            format: def.format,
+            source: 'db',
+            pending: false,
+            total,
+            d1: delta(1),
+            d7: delta(7),
+            d28: delta(28),
+            d90: delta(90),
+            series: points,
+        });
+    }
+    return windows;
+}
+// ---------------------------------------------------------------------------
+// Daily snapshot job
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether a snapshot row already exists for (app_id, metric_key) on
+ * `day` ('YYYY-MM-DD', UTC). Relies on getStatSeries returning rows ascending
+ * by captured_at: the first row at/after the start of `day` is either on
+ * `day` (a match) or a later day (no match) — so limit:1 suffices.
+ */
+async function hasSnapshotForDay(adapter, params) {
+    const rows = await getStatSeries(adapter, {
+        app_id: params.app_id,
+        scope_id: params.scope_id,
+        metric_key: params.metric_key,
+        since: `${params.day}T00:00:00.000Z`,
+        limit: 1,
+    });
+    return rows.length > 0 && rows[0].captured_at.slice(0, 10) === params.day;
+}
+/**
+ * Runs collect() for every registered db metric (those with a `collect` fn)
+ * and appends one stat row per metric — unless a snapshot for today (UTC)
+ * already exists, in which case it's skipped. ga4 metrics are never touched.
+ */
+export async function runMetricSnapshot(adapter, params) {
+    const now = new Date();
+    const today = dayString(now);
+    const results = [];
+    const dbMetrics = getRegisteredMetrics(params.app_id).filter((m) => m.source === 'db' && typeof m.collect === 'function');
+    for (const metric of dbMetrics) {
+        const already = await hasSnapshotForDay(adapter, {
+            app_id: params.app_id,
+            metric_key: metric.key,
+            day: today,
+        });
+        if (already) {
+            results.push({ key: metric.key, value: 0, skipped: true });
+            continue;
+        }
+        const value = await metric.collect(params.app_id);
+        await recordStat(adapter, {
+            app_id: params.app_id,
+            metric_key: metric.key,
+            value,
+            captured_at: now.toISOString(),
+        });
+        results.push({ key: metric.key, value, skipped: false });
+    }
+    return results;
+}
+/**
+ * MaintenanceJob-shaped export for M1 job wiring — daily metric snapshots.
+ */
+export const metricSnapshotJob = {
+    type: 'hazo_umetrics.metric_snapshot',
+    defaultCron: '0 3 * * *',
+    handler: async ({ app_id, adapter }) => {
+        return runMetricSnapshot(adapter, { app_id });
+    },
+};
+// ---------------------------------------------------------------------------
+// Historical backfill
+// ---------------------------------------------------------------------------
+/**
+ * Backfills daily snapshot rows for a db metric over [from, to] (UTC,
+ * 'YYYY-MM-DD', inclusive; `to` defaults to today). For each day, if a
+ * snapshot already exists it's skipped (idempotent); otherwise `valueAsOf`
+ * is called for that day and recorded with captured_at = day @ 00:00:00Z.
+ */
+export async function backfillDailySnapshots(adapter, params) {
+    const to = params.to ?? dayString(new Date());
+    let inserted = 0;
+    let skipped = 0;
+    for (const day of iterateDaysUTC(params.from, to)) {
+        const already = await hasSnapshotForDay(adapter, {
+            app_id: params.app_id,
+            metric_key: params.metric_key,
+            day,
+        });
+        if (already) {
+            skipped++;
+            continue;
+        }
+        const value = await params.valueAsOf(day);
+        await recordStat(adapter, {
+            app_id: params.app_id,
+            metric_key: params.metric_key,
+            value,
+            captured_at: `${day}T00:00:00.000Z`,
+        });
+        inserted++;
+    }
+    return { inserted, skipped };
+}

package/dist/server/stats.d.ts

@@ -2,6 +2,8 @@ import type { HazoConnectAdapter } from 'hazo_connect/server';
 import type { Stat, StatCollectorDef, MaintenanceJob } from './types.js';
 /**
  * Records a new stat reading. Always inserts — append-only, never upserts.
+ * Pass `captured_at` to backdate/day-stamp a row (e.g. for backfill or
+ * daily snapshots); defaults to the current timestamp.
  */
 export declare function recordStat(adapter: HazoConnectAdapter, params: {
     app_id: string;
@@ -10,6 +12,7 @@ export declare function recordStat(adapter: HazoConnectAdapter, params: {
     value: number;
     unit?: string;
     dimensions?: Record<string, string | number>;
+    captured_at?: string;
 }): Promise<void>;
 /**
  * Returns the most recent reading for a metric in an app, or null if none.

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

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/server/stats.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmDzE;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC9C,GACA,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAatB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,IAAI,EAAE,CAAC,CAmBjB;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAMjE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAchD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/server/stats.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmDzE;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAatB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,IAAI,EAAE,CAAC,CAmBjB;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAMjE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAchD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC"}

package/dist/server/stats.js

@@ -33,6 +33,8 @@ function getCrud(adapter) {
 // ---------------------------------------------------------------------------
 /**
  * Records a new stat reading. Always inserts — append-only, never upserts.
+ * Pass `captured_at` to backdate/day-stamp a row (e.g. for backfill or
+ * daily snapshots); defaults to the current timestamp.
  */
 export async function recordStat(adapter, params) {
     const crud = getCrud(adapter);
@@ -46,7 +48,7 @@ export async function recordStat(adapter, params) {
         value: params.value,
         unit: params.unit ?? null,
         dimensions: dimensionsJson,
-        captured_at: new Date().toISOString(),
+        captured_at: params.captured_at ?? new Date().toISOString(),
     });
 }
 /**

package/dist/server/types.d.ts

@@ -99,4 +99,30 @@ export interface StatCollectorDef {
     cadence?: string;
     collect: (app_id: string) => Promise<number>;
 }
+export interface MetricDef {
+    key: string;
+    label: string;
+    format: StatDef['format'];
+    source: 'db' | 'ga4';
+    description?: string;
+    collect?: (app_id: string) => Promise<number>;
+    backfill?: (app_id: string, date: string) => Promise<number>;
+}
+export interface MetricSeriesPoint {
+    date: string;
+    value: number;
+}
+export interface MetricWindow {
+    metric_key: string;
+    label: string;
+    format: MetricDef['format'];
+    source: 'db' | 'ga4';
+    pending: boolean;
+    total: number | null;
+    d1: number | null;
+    d7: number | null;
+    d28: number | null;
+    d90: number | null;
+    series: MetricSeriesPoint[];
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1,4 +1,5 @@
 export * from './metrics_panel.js';
+export * from './metrics_tab.js';
 export * from './actions_panel.js';
 export * from './analytics_panel.js';
 export * from './datapoint_panel.js';

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;AACnC,cAAc,2BAA2B,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,2BAA2B,CAAC"}

package/dist/ui/index.js

@@ -1,6 +1,7 @@
 // hazo_umetrics/src/ui/index.ts — Client-safe UI components (no Node.js imports).
 // Full MetricsPanel wiring is deferred to M1 interactive session.
 export * from './metrics_panel.js';
+export * from './metrics_tab.js';
 export * from './actions_panel.js';
 export * from './analytics_panel.js';
 export * from './datapoint_panel.js';

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,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;AAotBD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAqB,EAAE,YAAmB,EAAE,EAAE,iBAAiB,+BA+QrJ"}
+{"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;AAitBD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAqB,EAAE,YAAmB,EAAE,EAAE,iBAAiB,+BA+QrJ"}

package/dist/ui/journey_panel.js

@@ -162,10 +162,7 @@ function buildEdgePath(sx, sy, tx, ty, multiSidePorts, backEdgeLoop) {
     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';
-        }
+        // Forward edge: clean right -> left horizontal cubic. Keep default ports.
     }
     else if (dx < -COL_TOL) {
         // Back edge: target is to the left.
@@ -184,7 +181,7 @@ function buildEdgePath(sx, sy, tx, ty, multiSidePorts, backEdgeLoop) {
     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 k = Math.max(30, Math.min(dist * 0.4, 120));
     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}`;
@@ -306,7 +303,7 @@ function JourneyFlowGraph({ graph, userFilter, loading, multiSidePorts = true, b
                                 ['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) => {
+                            ].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", markerUnits: "userSpaceOnUse", 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)
@@ -387,7 +384,7 @@ function IdentityDropdown({ value, onChange, userIds, userSessions, anonCount, p
         if (id === ANON_IDENTITY)
             return 'Anonymous';
         const p = profiles.get(id);
-        return p?.email ?? p?.name ?? `${id.slice(0, 12)}…`;
+        return p?.name ?? p?.email ?? `${id.slice(0, 12)}…`;
     }
     function avatarFor(id) {
         if (id === '' || id === ANON_IDENTITY)

package/dist/ui/metrics_tab.d.ts

@@ -0,0 +1,30 @@
+interface MetricWindow {
+    metric_key: string;
+    label: string;
+    format: 'count' | 'currency' | 'duration' | 'percent';
+    source: 'db' | 'ga4';
+    pending: boolean;
+    total: number | null;
+    d1: number | null;
+    d7: number | null;
+    d28: number | null;
+    d90: number | null;
+    series: {
+        date: string;
+        value: number;
+    }[];
+}
+export interface WindowGridProps {
+    windows: MetricWindow[];
+}
+export declare function WindowGrid({ windows }: WindowGridProps): import("react").JSX.Element;
+export interface GraphProps {
+    windows: MetricWindow[];
+}
+export declare function Graph({ windows }: GraphProps): import("react").JSX.Element;
+export interface MetricsTabProps {
+    appId: string;
+}
+export declare function MetricsTab({ appId }: MetricsTabProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=metrics_tab.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics_tab.d.ts","sourceRoot":"","sources":["../../src/ui/metrics_tab.tsx"],"names":[],"mappings":"AAUA,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,MAAM,EAAE,IAAI,GAAG,KAAK,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAwDD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,eAAe,+BAwDtD;AAMD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAOD,wBAAgB,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,UAAU,+BAgF5C;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAgBD,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,eAAe,+BAiHpD"}

package/dist/ui/metrics_tab.js

@@ -0,0 +1,147 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useCallback, useMemo } from 'react';
+import { RotateCw } from 'lucide-react';
+import { LineChart } from 'hazo_dataviz/client';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatValue(value, format) {
+    switch (format) {
+        case 'currency': return `$${value.toLocaleString()}`;
+        case 'percent': return `${value}%`;
+        case 'duration': return `${value}s`;
+        default: return value.toLocaleString();
+    }
+}
+function formatDelta(value, format) {
+    if (value == null) {
+        return { text: '—', className: 'text-muted-foreground' };
+    }
+    if (value === 0) {
+        return { text: formatValue(0, format), className: 'text-muted-foreground' };
+    }
+    const sign = value > 0 ? '+' : '-';
+    const magnitude = formatValue(Math.abs(value), format);
+    return {
+        text: `${sign}${magnitude}`,
+        className: value > 0 ? 'text-green-600' : 'text-red-600',
+    };
+}
+function formatTrendLabel(date) {
+    const d = new Date(date);
+    if (Number.isNaN(d.getTime()))
+        return date;
+    return d.toLocaleString(undefined, { month: 'short', day: 'numeric' });
+}
+const TIME_FILTERS = [
+    { key: '1d', label: '24h', days: 1 },
+    { key: '7d', label: '7d', days: 7 },
+    { key: '28d', label: '28d', days: 28 },
+    { key: '90d', label: '90d', days: 90 },
+    { key: 'all', label: 'All', days: null },
+];
+export function WindowGrid({ windows }) {
+    if (windows.length === 0) {
+        return (_jsx("div", { className: "rounded-lg border p-4 text-sm text-muted-foreground", children: "No metrics yet" }));
+    }
+    return (_jsx("div", { className: "overflow-x-auto rounded-lg border", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { children: _jsxs("tr", { className: "border-b text-xs uppercase tracking-wide text-muted-foreground", children: [_jsx("th", { className: "px-3 py-2 text-left font-medium", children: "Metric" }), _jsx("th", { className: "px-3 py-2 text-right font-medium", children: "Total" }), _jsx("th", { className: "px-3 py-2 text-right font-medium", children: "24h" }), _jsx("th", { className: "px-3 py-2 text-right font-medium", children: "7d" }), _jsx("th", { className: "px-3 py-2 text-right font-medium", children: "28d" }), _jsx("th", { className: "px-3 py-2 text-right font-medium", children: "90d" })] }) }), _jsx("tbody", { children: windows.map((w) => {
+                        if (w.pending) {
+                            return (_jsxs("tr", { className: "border-b last:border-b-0", children: [_jsx("td", { className: "px-3 py-2 font-medium", children: w.label }), _jsx("td", { colSpan: 5, className: "px-3 py-2", children: _jsx("span", { className: "inline-flex items-center gap-1.5 rounded bg-muted px-1.5 py-0.5 text-xs text-muted-foreground", children: "\u25A2 GA4 pending \u2014 connect GA4 to enable" }) })] }, w.metric_key));
+                        }
+                        const d1 = formatDelta(w.d1, w.format);
+                        const d7 = formatDelta(w.d7, w.format);
+                        const d28 = formatDelta(w.d28, w.format);
+                        const d90 = formatDelta(w.d90, w.format);
+                        return (_jsxs("tr", { className: "border-b last:border-b-0", children: [_jsx("td", { className: "px-3 py-2 font-medium", children: w.label }), _jsx("td", { className: "px-3 py-2 text-right font-semibold", children: w.total == null ? '—' : formatValue(w.total, w.format) }), _jsx("td", { className: `px-3 py-2 text-right ${d1.className}`, children: d1.text }), _jsx("td", { className: `px-3 py-2 text-right ${d7.className}`, children: d7.text }), _jsx("td", { className: `px-3 py-2 text-right ${d28.className}`, children: d28.text }), _jsx("td", { className: `px-3 py-2 text-right ${d90.className}`, children: d90.text })] }, w.metric_key));
+                    }) })] }) }));
+}
+function sliceSeries(series, days) {
+    if (days == null)
+        return series;
+    return series.slice(-days);
+}
+export function Graph({ windows }) {
+    const graphable = useMemo(() => windows.filter((w) => !w.pending && w.series.length > 0), [windows]);
+    const [metricKey, setMetricKey] = useState(() => graphable[0]?.metric_key ?? null);
+    const [timeFilter, setTimeFilter] = useState('28d');
+    useEffect(() => {
+        if (metricKey == null || !graphable.some((w) => w.metric_key === metricKey)) {
+            setMetricKey(graphable[0]?.metric_key ?? null);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [graphable]);
+    if (graphable.length === 0) {
+        return (_jsx("div", { className: "rounded-lg border p-4 text-sm text-muted-foreground", children: "No trend data yet" }));
+    }
+    const selected = graphable.find((w) => w.metric_key === metricKey) ?? graphable[0];
+    const filterDef = TIME_FILTERS.find((f) => f.key === timeFilter) ?? TIME_FILTERS[2];
+    const points = sliceSeries(selected.series, filterDef.days);
+    return (_jsxs("div", { className: "flex flex-col gap-3", children: [_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [_jsx("div", { className: "flex items-center gap-1", children: TIME_FILTERS.map((f) => (_jsx("button", { onClick: () => setTimeFilter(f.key), className: `rounded-md border px-2.5 py-1 text-xs transition-colors ${timeFilter === f.key
+                                ? 'border-indigo-500 bg-indigo-50 text-indigo-700'
+                                : 'text-muted-foreground hover:bg-muted'}`, children: f.label }, f.key))) }), _jsxs("label", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: ["metric:", _jsx("select", { value: selected.metric_key, onChange: (e) => setMetricKey(e.target.value), className: "rounded-md border px-2 py-1 text-xs", children: graphable.map((w) => (_jsx("option", { value: w.metric_key, children: w.label }, w.metric_key))) })] })] }), points.length < 2 ? (_jsx("div", { className: "rounded-lg border p-4 text-sm text-muted-foreground", children: "No trend data yet" })) : (_jsx("div", { className: "rounded-lg border p-4", children: _jsx(LineChart, { data: points.map((p) => p.value), dates: points.map((p) => formatTrendLabel(p.date)), color: "#6366f1", showTooltip: true }) }))] }));
+}
+const INITIAL_STATE = {
+    loading: true,
+    unauthenticated: false,
+    error: null,
+    windows: [],
+};
+export function MetricsTab({ appId }) {
+    const [state, setState] = useState(INITIAL_STATE);
+    const [refreshKey, setRefreshKey] = useState(0);
+    const refresh = useCallback(() => setRefreshKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!appId)
+            return;
+        let cancelled = false;
+        async function fetchAll() {
+            setState(INITIAL_STATE);
+            const res = await fetch(`/api/hazo_umetrics/stats/windows?app_id=${encodeURIComponent(appId)}&days=90`).catch(() => null);
+            if (res == null) {
+                if (!cancelled)
+                    setState({ ...INITIAL_STATE, loading: false, error: 'Network error' });
+                return;
+            }
+            if (res.status === 401 || res.status === 403) {
+                if (!cancelled)
+                    setState({ ...INITIAL_STATE, loading: false, unauthenticated: true });
+                return;
+            }
+            if (!res.ok) {
+                const body = (await res.json().catch(() => null));
+                if (!cancelled)
+                    setState({ ...INITIAL_STATE, loading: false, error: body?.error?.message ?? `HTTP ${res.status}` });
+                return;
+            }
+            const body = (await res.json());
+            const windows = body.data?.windows ?? [];
+            if (!cancelled) {
+                setState({ loading: false, unauthenticated: false, error: null, windows });
+            }
+        }
+        fetchAll().catch((err) => {
+            if (!cancelled) {
+                const message = err instanceof Error ? err.message : 'Unexpected error';
+                setState({ ...INITIAL_STATE, loading: false, error: message });
+            }
+        });
+        return () => { cancelled = true; };
+    }, [appId, refreshKey]);
+    // -------------------------------------------------------------------------
+    // Render states
+    // -------------------------------------------------------------------------
+    if (state.loading) {
+        return (_jsx("div", { className: "flex items-center justify-center p-8 text-sm text-muted-foreground", children: "Loading metrics\u2026" }));
+    }
+    if (state.unauthenticated) {
+        return (_jsxs("div", { className: "flex items-center justify-center rounded-lg border p-8 text-sm text-muted-foreground", children: ["Log in with ", _jsx("span", { className: "mx-1 font-mono", children: "metrics.view" }), " permission to see this page."] }));
+    }
+    if (state.error != null) {
+        return (_jsxs("div", { className: "rounded-lg border border-red-200 bg-red-50 p-4 text-sm text-red-700", children: ["Failed to load metrics: ", state.error] }));
+    }
+    // -------------------------------------------------------------------------
+    // Main render
+    // -------------------------------------------------------------------------
+    return (_jsxs("div", { className: "flex flex-col gap-6 p-4", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("h2", { className: "text-sm font-semibold uppercase tracking-wide text-muted-foreground", children: "Metrics" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "font-mono text-xs text-muted-foreground", children: appId }), _jsxs("button", { onClick: refresh, className: "flex items-center gap-1.5 rounded-md border px-2.5 py-1.5 text-xs text-muted-foreground hover:bg-muted transition-colors", title: "Refresh metrics", children: [_jsx(RotateCw, { className: "h-3.5 w-3.5" }), "Refresh"] })] })] }), _jsx("section", { children: _jsx(WindowGrid, { windows: state.windows }) }), _jsxs("section", { children: [_jsx("h2", { className: "mb-3 text-sm font-semibold uppercase tracking-wide text-muted-foreground", children: "Graph" }), _jsx(Graph, { windows: state.windows })] })] }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_umetrics",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Product analytics for hazo apps — GA4 hybrid + first-party stat store + feature flags",
   "type": "module",
   "module": "./dist/index.js",
@@ -48,10 +48,10 @@
     "hazo_config": "^2.4.1",
     "hazo_connect": "^3.9.2",
     "hazo_api": "^2.5.1",
-    "hazo_auth": "^10.8.0",
+    "hazo_auth": "^10.8.2",
     "hazo_secure": "^1.3.0",
     "hazo_audit": "^2.1.2",
-    "hazo_ui": "^4.10.0",
+    "hazo_ui": "^6.0.0",
     "next": "^14.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"