@uptimizr/db 1.0.1 → 2.0.0

package/dist/query/aggregations.js

@@ -8,6 +8,14 @@
  *
  * Invariant: no multi-tenant concepts here. Filtering is by `project_id` and the
  * optional scene/source/session dimensions only.
+ *
+ * Every builder tags its `QuerySpec` with the registry `metric` id it computes
+ * (ADR 0051 §1). That tag is what lets each store's query runner apply numeric
+ * coercion at the single point rows leave the driver (`query/coerce.ts`) without
+ * the store call sites having to name the metric. The tag and the registry's
+ * `builder` field are two halves of one mapping — `src/__tests__/registry.test.ts`
+ * fails if they disagree, so a new aggregation still is not done until it has a
+ * registry entry.
  */
 import { ParamBag, cameraModeClause, dayRangeClause, meshClause, rangeClause, regionClause, sceneClause, sessionClause, sourceClause, } from "./dialect.js";
 /** World/gaze voxel coordinates derive from the raycast `hit_point` vector. */
@@ -52,6 +60,7 @@ export function buildListSessions(projectId, opts, d) {
       ORDER BY started_at DESC
       LIMIT ${limit}
     `,
+        metric: "list_sessions",
         query_params: bag.values,
     };
 }
@@ -81,6 +90,7 @@ export function buildPointerHeatmap(projectId, opts, d) {
       GROUP BY gx, gy
       ORDER BY count DESC
     `,
+        metric: "pointer_heatmap",
         query_params: bag.values,
     };
 }
@@ -123,6 +133,7 @@ export function buildMeshUvHeatmap(projectId, opts, d) {
       GROUP BY gx, gy
       ORDER BY count DESC
     `,
+        metric: "mesh_uv_heatmap",
         query_params: bag.values,
     };
 }
@@ -156,6 +167,7 @@ export function buildWorldHeatmap(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "world_heatmap",
         query_params: bag.values,
     };
 }
@@ -191,6 +203,7 @@ export function buildWorldHeatmapStats(projectId, opts, d) {
         GROUP BY vx, vy, vz
       ) t
     `,
+        metric: "world_heatmap_stats",
         query_params: bag.values,
     };
 }
@@ -229,6 +242,7 @@ export function buildGazeHeatmap(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "gaze_heatmap",
         query_params: bag.values,
     };
 }
@@ -262,6 +276,7 @@ export function buildGazeHeatmapStats(projectId, opts, d) {
         GROUP BY vx, vy, vz
       ) t
     `,
+        metric: "gaze_heatmap_stats",
         query_params: bag.values,
     };
 }
@@ -290,6 +305,7 @@ export function buildCameraDirectionHeatmap(projectId, opts, d) {
       GROUP BY azimuth_bin, elevation_bin
       ORDER BY count DESC
     `,
+        metric: "camera_heatmap",
         query_params: bag.values,
     };
 }
@@ -339,6 +355,7 @@ export function buildViewCoverageHistogram(projectId, opts, d) {
       GROUP BY bucket
       ORDER BY bucket ASC
     `,
+        metric: "view_coverage_histogram",
         query_params: bag.values,
     };
 }
@@ -373,6 +390,7 @@ export function buildCameraPositionHeatmap(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "position_heatmap",
         query_params: bag.values,
     };
 }
@@ -403,6 +421,7 @@ export function buildSessionTrajectory(projectId, opts, d) {
       ORDER BY ts ASC
       LIMIT ${limit}
     `,
+        metric: "session_trajectory",
         query_params: bag.values,
     };
 }
@@ -440,6 +459,7 @@ export function buildAggregateTrajectories(projectId, opts, d) {
       ORDER BY session_id ASC, ts ASC
       LIMIT ${limit}
     `,
+        metric: "aggregate_paths",
         query_params: bag.values,
     };
 }
@@ -566,6 +586,7 @@ export function buildClickGazeRay(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${bag.add("limit", "u32", opts.limit ?? 500)}
     `,
+        metric: "click_rays",
         query_params: bag.values,
     };
 }
@@ -629,6 +650,7 @@ export function buildFlowHeatmap(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+            metric: "flow_links",
             query_params: bag.values,
         };
     }
@@ -695,6 +717,7 @@ export function buildFlowHeatmap(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "flow_links",
         query_params: bag.values,
     };
 }
@@ -714,6 +737,7 @@ export function buildTopMeshes(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "top_meshes",
         query_params: bag.values,
     };
 }
@@ -745,6 +769,7 @@ export function buildTopMeshesBySource(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "mesh_sources",
         query_params: bag.values,
     };
 }
@@ -780,6 +805,7 @@ export function buildTopMeshesTrend(projectId, opts, d) {
       ORDER BY bucket ASC
       LIMIT ${limit}
     `,
+        metric: "mesh_trend",
         query_params: bag.values,
     };
 }
@@ -809,6 +835,7 @@ export function buildMeshDwell(projectId, opts, d) {
       ORDER BY sum(visible_ms) DESC
       LIMIT ${limit}
     `,
+        metric: "mesh_dwell",
         query_params: bag.values,
     };
 }
@@ -862,6 +889,7 @@ export function buildMeshBlindSpots(projectId, opts, d) {
         sum(CASE WHEN event_type = 'mesh_visibility' THEN visible_ms ELSE 0 END) DESC
       LIMIT ${limit}
     `,
+        metric: "mesh_blind_spots",
         query_params: bag.values,
     };
 }
@@ -894,6 +922,7 @@ export function buildMeshInteractionKinds(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "mesh_interaction_kinds",
         query_params: bag.values,
     };
 }
@@ -968,6 +997,7 @@ export function buildReachability(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "mesh_reachability",
         query_params: bag.values,
     };
 }
@@ -992,6 +1022,7 @@ export function buildDeadClicks(projectId, opts, d) {
       FROM events
       WHERE project_id = ${pid} AND event_type = 'pointer_click'${range}${scene}${source}${session}
     `,
+        metric: "dead_clicks",
         query_params: bag.values,
     };
 }
@@ -1028,6 +1059,7 @@ export function buildRageClicks(projectId, opts, d) {
       ORDER BY clicks DESC
       LIMIT ${limit}
     `,
+        metric: "rage_clicks",
         query_params: bag.values,
     };
 }
@@ -1060,6 +1092,7 @@ export function buildHoverDwell(projectId, opts, d) {
       ORDER BY dwell_ms DESC
       LIMIT ${limit}
     `,
+        metric: "hover_dwell",
         query_params: bag.values,
     };
 }
@@ -1092,6 +1125,7 @@ export function buildCompileStalls(projectId, opts, d) {
       ORDER BY total_ms DESC
       LIMIT ${limit}
     `,
+        metric: "compile_stalls",
         query_params: bag.values,
     };
 }
@@ -1124,6 +1158,7 @@ export function buildResourceSummary(projectId, opts, d) {
       FROM events
       WHERE project_id = ${pid} AND event_type = 'resource_sample'${range}${session}
     `,
+        metric: "resource_summary",
         query_params: bag.values,
     };
 }
@@ -1168,6 +1203,7 @@ export function buildResourcePercentiles(projectId, opts, d) {
         GROUP BY session_id
       ) per_session
     `,
+        metric: "resource_percentiles",
         query_params: bag.values,
     };
 }
@@ -1193,6 +1229,7 @@ export function buildStabilityCounts(projectId, opts, d) {
       FROM events
       WHERE project_id = ${pid} AND event_type IN ('context_lost', 'compile_stall')${range}${scene}${session}
     `,
+        metric: "stability_counts",
         query_params: bag.values,
     };
 }
@@ -1235,6 +1272,7 @@ export function buildGraphicsDiagnosticCounts(projectId, opts, d) {
       GROUP BY severity, category, backend
       ORDER BY incidents DESC
     `,
+        metric: "graphics_diagnostics",
         query_params: bag.values,
     };
 }
@@ -1291,6 +1329,7 @@ export function buildErrorHeatmap(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "error_heatmap",
         query_params: bag.values,
     };
 }
@@ -1333,6 +1372,7 @@ export function buildBoundaryHeatmap(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "boundary_heatmap",
         query_params: bag.values,
     };
 }
@@ -1367,6 +1407,7 @@ export function buildBoundaryHeatmapStats(projectId, opts, d) {
         GROUP BY vx, vy, vz
       ) t
     `,
+        metric: "boundary_heatmap_stats",
         query_params: bag.values,
     };
 }
@@ -1403,6 +1444,7 @@ export function buildBoundaryContacts(projectId, opts, d) {
       ORDER BY contacts DESC
       LIMIT ${limit}
     `,
+        metric: "xr_boundary_contacts",
         query_params: bag.values,
     };
 }
@@ -1441,6 +1483,7 @@ export function buildRenderingTechnology(projectId, opts, d) {
       GROUP BY api, backend, api_version, shading_language
       ORDER BY sessions DESC
     `,
+        metric: "rendering_technology",
         query_params: bag.values,
     };
 }
@@ -1471,6 +1514,7 @@ export function buildCapabilityChanges(projectId, opts, d) {
       ORDER BY changes DESC
       LIMIT ${limit}
     `,
+        metric: "capability_changes",
         query_params: bag.values,
     };
 }
@@ -1505,6 +1549,7 @@ export function buildCameraGestures(projectId, opts, d) {
       ORDER BY gestures DESC
       LIMIT ${limit}
     `,
+        metric: "camera_gestures",
         query_params: bag.values,
     };
 }
@@ -1524,6 +1569,7 @@ export function buildPerfSummary(projectId, opts, d) {
       FROM events
       WHERE project_id = ${pid} AND event_type = 'frame_perf'${range}${session}
     `,
+        metric: "perf_summary",
         query_params: bag.values,
     };
 }
@@ -1558,6 +1604,7 @@ export function buildRenderScaleTruth(projectId, opts, d) {
       FROM events
       WHERE project_id = ${pid} AND event_type = 'frame_perf'${range}${session}
     `,
+        metric: "render_scale_truth",
         query_params: bag.values,
     };
 }
@@ -1595,6 +1642,7 @@ export function buildPerfDistribution(projectId, opts, d) {
         GROUP BY session_id
       ) per_session
     `,
+        metric: "perf_distribution",
         query_params: bag.values,
     };
 }
@@ -1629,6 +1677,7 @@ export function buildFpsHistogram(projectId, opts, d) {
       GROUP BY bucket
       ORDER BY bucket ASC
     `,
+        metric: "fps_histogram",
         query_params: bag.values,
     };
 }
@@ -1665,6 +1714,7 @@ export function buildFrameTimePercentiles(projectId, opts, d) {
         GROUP BY session_id
       ) per_session
     `,
+        metric: "frame_time_percentiles",
         query_params: bag.values,
     };
 }
@@ -1699,6 +1749,7 @@ export function buildJankRate(projectId, opts, d) {
         GROUP BY session_id
       ) per_session
     `,
+        metric: "jank_rate",
         query_params: bag.values,
     };
 }
@@ -1775,6 +1826,7 @@ export function buildPerfChurn(projectId, opts, d) {
         sum(had_stall) AS stall_churn_sessions
       FROM correlated
     `,
+        metric: "perf_churn",
         query_params: bag.values,
     };
 }
@@ -1836,6 +1888,7 @@ export function buildPerfByDevice(projectId, opts, d) {
       GROUP BY engine, is_mobile, renderer, browser, os
       ORDER BY sessions DESC
     `,
+        metric: "perf_by_device",
         query_params: bag.values,
     };
 }
@@ -1872,6 +1925,7 @@ export function buildPerfByScene(projectId, opts, d) {
       GROUP BY scene_id
       ORDER BY sessions DESC
     `,
+        metric: "perf_by_scene",
         query_params: bag.values,
     };
 }
@@ -1898,6 +1952,7 @@ export function buildPerfDaily(projectId, opts, d) {
       ORDER BY day DESC
       LIMIT ${limit}
     `,
+        metric: "perf_daily",
         query_params: bag.values,
     };
 }
@@ -1922,6 +1977,7 @@ export function buildEventsDaily(projectId, opts, d) {
       ORDER BY day DESC, sum(events) DESC
       LIMIT ${limit}
     `,
+        metric: "events_daily",
         query_params: bag.values,
     };
 }
@@ -1946,6 +2002,7 @@ export function buildDistinctScenes(projectId, opts, d) {
       ORDER BY events DESC
       LIMIT ${limit}
     `,
+        metric: "list_scenes",
         query_params: bag.values,
     };
 }
@@ -1974,6 +2031,7 @@ export function buildTimeseries(projectId, opts, d) {
       GROUP BY bucket
       ORDER BY bucket ASC
     `,
+        metric: "timeseries",
         query_params: bag.values,
     };
 }
@@ -1994,6 +2052,7 @@ export function buildEventTypeCounts(projectId, opts, d) {
       GROUP BY event_type
       ORDER BY count DESC
     `,
+        metric: "event_counts",
         query_params: bag.values,
     };
 }
@@ -2028,6 +2087,7 @@ export function buildSceneCoverage(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "scene_coverage",
         query_params: bag.values,
     };
 }
@@ -2069,6 +2129,7 @@ export function buildPerfHeatmap(projectId, opts, d) {
       ORDER BY avg_fps ASC
       LIMIT ${limit}
     `,
+        metric: "perf_heatmap",
         query_params: bag.values,
     };
 }
@@ -2108,6 +2169,7 @@ export function buildCameraDistance(projectId, opts, d) {
       ORDER BY bucket ASC
       LIMIT ${limit}
     `,
+        metric: "camera_distance",
         query_params: bag.values,
     };
 }
@@ -2166,6 +2228,7 @@ export function buildNavigationStats(projectId, opts, d) {
       ORDER BY total_distance DESC
       LIMIT ${limit}
     `,
+        metric: "navigation_stats",
         query_params: bag.values,
     };
 }
@@ -2258,6 +2321,7 @@ export function buildBacktrackRatio(projectId, opts, d) {
       ORDER BY backtrack_ratio DESC, entries DESC
       LIMIT ${limit}
     `,
+        metric: "backtrack_ratio",
         query_params: bag.values,
     };
 }
@@ -2301,6 +2365,7 @@ export function buildInteractionsBySource(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "interaction_sources",
         query_params: bag.values,
     };
 }
@@ -2333,6 +2398,7 @@ export function buildTopInputActions(projectId, opts, d) {
       ORDER BY count DESC
       LIMIT ${limit}
     `,
+        metric: "top_input_actions",
         query_params: bag.values,
     };
 }
@@ -2394,6 +2460,7 @@ export function buildXrRotationRate(projectId, opts, d) {
       ORDER BY total_turn_rad DESC
       LIMIT ${limit}
     `,
+        metric: "xr_rotation",
         query_params: bag.values,
     };
 }
@@ -2424,6 +2491,7 @@ export function buildXrSourceUsage(projectId, opts, d) {
       ORDER BY interactions DESC
       LIMIT ${limit}
     `,
+        metric: "xr_sources",
         query_params: bag.values,
     };
 }
@@ -2462,6 +2530,7 @@ export function buildXrAbandonment(projectId, opts, d) {
       ORDER BY started_at DESC
       LIMIT ${limit}
     `,
+        metric: "xr_abandonment",
         query_params: bag.values,
     };
 }
@@ -2510,6 +2579,7 @@ export function buildXrLocomotionComfort(projectId, opts, d) {
       ORDER BY locomotion_ms DESC
       LIMIT ${limit}
     `,
+        metric: "xr_locomotion",
         query_params: bag.values,
     };
 }
@@ -2563,6 +2633,7 @@ export function buildTrackingQuality(projectId, opts, d) {
       ORDER BY degraded_ms DESC
       LIMIT ${limit}
     `,
+        metric: "xr_tracking_quality",
         query_params: bag.values,
     };
 }
@@ -2636,6 +2707,7 @@ export function buildArPlacementTimeToPlace(projectId, opts, d) {
       GROUP BY bucket
       ORDER BY bucket ASC
     `,
+        metric: "ar_placement_time_to_place",
         query_params: bag.values,
     };
 }
@@ -2666,6 +2738,7 @@ export function buildArPlacementAttempts(projectId, opts, d) {
       GROUP BY attempts
       ORDER BY attempts ASC
     `,
+        metric: "ar_placement_attempts",
         query_params: bag.values,
     };
 }
@@ -2699,6 +2772,7 @@ export function buildArPlacementSurfaces(projectId, opts, d) {
       GROUP BY surface
       ORDER BY placements DESC
     `,
+        metric: "ar_placement_surfaces",
         query_params: bag.values,
     };
 }
@@ -2741,6 +2815,7 @@ export function buildFunnel(projectId, opts, d) {
       ${counts}
       ORDER BY step ASC
     `,
+        metric: "funnel",
         query_params: bag.values,
     };
 }
@@ -2798,6 +2873,7 @@ export function buildSceneRetention(projectId, opts, d) {
       ORDER BY sessions DESC, from_scene ASC, to_scene ASC
       LIMIT ${limit}
     `,
+        metric: "scene_retention",
         query_params: bag.values,
     };
 }
@@ -2875,6 +2951,7 @@ export function buildLoadBounceFunnel(projectId, opts, d) {
       GROUP BY band
       ORDER BY band ASC
     `,
+        metric: "load_bounce_funnel",
         query_params: bag.values,
     };
 }
@@ -3024,6 +3101,7 @@ export function buildVariantLeaderboard(projectId, opts, d) {
       ORDER BY vc.views DESC, vc.variant ASC
       LIMIT ${limit}
     `,
+        metric: "variant_leaderboard",
         query_params: bag.values,
     };
 }