@uptimizr/db 2.0.1 → 2.1.0

package/dist/query/dsl/compile.js

@@ -0,0 +1,174 @@
+/**
+ * **The delegated query compiler** (ADR 0051 §3, design sketch §C.2, tier 1).
+ *
+ * A validated `queryV1` document becomes a `QuerySpec` by way of the metric's
+ * *existing* aggregation builder: the registry says which `build*` computes the
+ * metric, `FILTER_TARGETS` says which option field each filter drives, and the
+ * builder renders the SQL it has always rendered, through the same `Dialect`.
+ *
+ * That is the point of the delegated tier. Every registry metric is reachable
+ * through the DSL on day one at exactly the power its canned endpoint has — no
+ * second SQL path, no "DSL-only" subset of metrics, and nothing new for the
+ * cross-engine parity harness to cover, because the specs it compiles *are* the
+ * specs the parity cases already pin (`src/__tests__/queryDsl.test.ts` asserts
+ * that equality builder by builder, on all four dialects).
+ *
+ * It also means the DSL inherits the two properties that matter most and cannot
+ * be bolted on afterwards: every value reaches SQL as a bound parameter (the
+ * builders' `ParamBag`), and the returned spec carries its `metric`, so the
+ * store edge coerces the rows (`coerceRows`, ADR 0051 §2) without knowing a DSL
+ * exists.
+ *
+ * What this module does **not** do: validate. A query must already have passed
+ * `queryV1Schema` (shape) and `validateQuery` (vocabulary) — by the time it gets
+ * here, the metric exists, has a builder, accepts every filter named, and asks
+ * for a grain it can produce. The two `throw`s below are guards against a caller
+ * skipping that, not a client-facing error path.
+ */
+import { FILTER_TARGETS, getMetric, queryTier, } from "@uptimizr/metrics";
+import { builderFor } from "./builders.js";
+import { compileGenericGroupBy } from "./generic.js";
+/**
+ * The dashboard's camera-mode toggle → the `scene.cameraType` the events carry
+ * (ADR 0026). The same mapping the canned routes apply; it lives here too so a
+ * DSL query and a `?cameraMode=` request produce the identical spec.
+ */
+export function cameraTypeForMode(mode) {
+    if (mode === "first-person")
+        return "free";
+    if (mode === "viewer")
+        return "arc-rotate";
+    return undefined;
+}
+/**
+ * Assign `value` to `field` on the option bag. Almost every `FILTER_TARGETS`
+ * field is a plain property name; the three `center[i]` entries address one
+ * element of a tuple option (the reference point `camera_distance` measures
+ * from), which is the only indexed form the registry uses.
+ */
+function assign(options, field, value) {
+    const indexed = /^([A-Za-z0-9_]+)\[(\d+)\]$/.exec(field);
+    if (!indexed) {
+        options[field] = value;
+        return;
+    }
+    const [, name, index] = indexed;
+    const tuple = Array.isArray(options[name]) ? options[name] : [];
+    tuple[Number(index)] = value;
+    options[name] = tuple;
+}
+/**
+ * Turn a validated query into the option bag its builder takes.
+ *
+ * The mapping is the registry's, not this file's: for each filter the query
+ * carries, `FILTER_TARGETS[filter].field` names the option field it drives. Only
+ * two values are transformed on the way — the camera-mode toggle becomes the
+ * stored `cameraType`, and a region id becomes the bounds the caller resolved.
+ */
+export function toBuilderOptions(query, resolved = {}, tier = "delegated") {
+    const options = {
+        since: query.range.since,
+        until: query.range.until,
+    };
+    for (const [key, value] of Object.entries(query.filters ?? {})) {
+        if (value === undefined)
+            continue;
+        // The two generic-tier filters are not builder options at all: no `build*`
+        // takes an event predicate or a device attribute. They ride in the bag under
+        // their own names and are read by the generic builder alone.
+        if (key === "event" || key === "device") {
+            if (tier === "generic")
+                options[key] = value;
+            continue;
+        }
+        const target = FILTER_TARGETS[key];
+        if (!target)
+            continue;
+        if (key === "cameraMode") {
+            assign(options, target.field, cameraTypeForMode(value));
+            continue;
+        }
+        if (key === "region") {
+            const region = typeof value === "string" ? resolved.region : value;
+            if (region == null) {
+                throw new Error("filters.region names a registered region id, which must be resolved to bounds before compiling");
+            }
+            assign(options, target.field, region);
+            continue;
+        }
+        assign(options, target.field, value);
+    }
+    // A `segment` is a set of equality filters with a name. Where the metric
+    // already has a filter for the dimension, it *is* that filter — so it lands on
+    // the same option field and a delegated query never has to know the difference.
+    // Anything else is a dimension only the generic builder can hold fixed.
+    const segment = {};
+    for (const [dimension, value] of Object.entries(query.segment ?? {})) {
+        const target = FILTER_TARGETS[dimension];
+        if (target != null) {
+            if (dimension === "cameraMode") {
+                assign(options, target.field, cameraTypeForMode(value));
+            }
+            else {
+                assign(options, target.field, value);
+            }
+            continue;
+        }
+        segment[dimension] = value;
+    }
+    if (query.limit != null)
+        options.limit = query.limit;
+    if (resolved.cellSize != null && options.cellSize == null)
+        options.cellSize = resolved.cellSize;
+    if (tier === "generic") {
+        // The generic builder reads its grain, its order and its segment from the
+        // same bag; `compileMetric` dispatches on `tier`, which is the one field
+        // that is about compilation rather than about the query.
+        options.tier = "generic";
+        options.dimensions = query.dimensions == null ? undefined : [...query.dimensions];
+        if (query.order != null)
+            options.order = { ...query.order };
+        if (Object.keys(segment).length > 0)
+            options.segment = segment;
+    }
+    return options;
+}
+/**
+ * Render the `QuerySpec` for one metric and an already-assembled option bag.
+ *
+ * This is the seam the stores use: a store's `runMetric` is exactly
+ * `run<Engine>Query(compileMetric(metric, projectId, options, <engine>Dialect))`,
+ * so the DSL reaches every engine through the one code path aggregations already
+ * take — and therefore through the same parity harness and the same numeric
+ * coercion.
+ */
+export function compileMetric(metric, projectId, options, dialect) {
+    const definition = getMetric(metric);
+    if (!definition?.builder) {
+        throw new Error(`metric '${metric}' has no aggregation builder and cannot be compiled`);
+    }
+    // `tier` is the one field of the bag that describes the *compilation* rather
+    // than the query, and it is set only by `toBuilderOptions` after
+    // `validateQuery` decided the metric can answer at another grain. A store
+    // calling `runMetric` with a plain option bag therefore keeps the delegated
+    // behaviour it has always had.
+    if (options.tier === "generic") {
+        return compileGenericGroupBy(definition, projectId, options, dialect);
+    }
+    return builderFor(definition.builder)(projectId, { ...options }, dialect);
+}
+/**
+ * Compile a validated query end to end: filters → option bag → the metric's
+ * builder (or the generic one) → a `QuerySpec`.
+ *
+ * The tier is derived here rather than passed in, so a caller that has a
+ * validated query cannot compile it onto the wrong compiler; the collector,
+ * which already has the tier from `validateQuery`, may pass it to save the
+ * lookup.
+ */
+export function compileQuery(projectId, query, dialect, resolved = {}, tier) {
+    const definition = getMetric(query.metric);
+    const effective = tier ?? (definition == null ? "delegated" : queryTier(definition, query));
+    return compileMetric(query.metric, projectId, toBuilderOptions(query, resolved, effective), dialect);
+}
+//# sourceMappingURL=compile.js.map

package/dist/query/dsl/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../../src/query/dsl/compile.ts"],"names":[],"mappings":"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"}

package/dist/query/dsl/explain.d.ts

@@ -0,0 +1,115 @@
+/**
+ * **`explain`: can I trust this?** (ADR 0051 §3, design sketch §C.2).
+ *
+ * The second thing an agent cannot do today. A result that came back empty
+ * because the capture channel is switched off looks exactly like a result that
+ * came back empty because nothing happened — and a model will report the second
+ * either way. `explain: true` answers the request with the **plan** instead of
+ * the rows: which tier would run, the SQL that tier renders for this store's
+ * dialect, the parameters it binds, how much data is behind the window, and
+ * every reason the answer might not mean what it looks like.
+ *
+ * ## Why the SQL can be shown at all
+ *
+ * Because it contains nothing to redact. The DSL's whole design is that no
+ * caller-supplied value ever reaches the SQL text: a scene id, a mesh name, an
+ * event predicate and a row cap are all bound parameters, and
+ * `src/__tests__/queryDsl.test.ts` proves it by pushing a hostile string through
+ * every filter and asserting it appears only in `query_params`. So the rendered
+ * plan is the *shape* of the query with placeholders where the values are, and
+ * {@link explainSpec} lists the parameters by **name and logical type only** —
+ * never their values, which may be a session id or a mesh name the caller is not
+ * entitled to see echoed into a shared transcript.
+ *
+ * That is also what makes `explain` worth having: a reader can check for
+ * themselves that the filter they asked for is in the `WHERE`, and that nothing
+ * else is.
+ *
+ * ## `rowsScanned`
+ *
+ * No supported engine reports rows scanned without either a second pass or a
+ * dialect-specific `EXPLAIN ANALYZE`, and paying for either on a read endpoint
+ * would be a poor trade. What the collector *can* answer cheaply is the honest
+ * version of the same question — how many events of the metric's own capture
+ * channels exist in the window — from the `event_counts` pass it already runs to
+ * detect a disabled channel. `null` where the metric declares no channels (a
+ * derived rollup).
+ */
+import type { EventType } from "@uptimizr/schema";
+import type { MetricDefinition, MetricId, QueryTier } from "@uptimizr/metrics";
+import type { QuerySpec } from "../types.js";
+import type { SampleSize } from "../summary/types.js";
+/** The logical type of a bound parameter, as the plan reports it. */
+export type ExplainParamType = "string" | "number" | "timestamp" | "boolean" | "json";
+/** One bound parameter, named and typed — never valued. */
+export interface ExplainParam {
+    name: string;
+    type: ExplainParamType;
+}
+/** The plan `explain: true` answers with. */
+export interface QueryPlan {
+    metric: MetricId;
+    /** Which compiler would run it (design sketch §C.2). */
+    tier: QueryTier;
+    /** The store's engine, so the SQL below is readable in context. */
+    dialect: string;
+    /** The rendered SQL, parameters left as placeholders. */
+    sql: string;
+    /** Every parameter the SQL binds, by name and logical type. */
+    params: readonly ExplainParam[];
+    /**
+     * Events of the metric's own capture channels in the window — the cheap,
+     * honest stand-in for "rows scanned". `null` when the metric declares no
+     * channels, or when the collector could not count them.
+     */
+    rowsScanned: number | null;
+    /** How much data is behind the window, on the metric's own terms. */
+    sampleSize: SampleSize;
+    /** Every reason the answer might not mean what it looks like. */
+    warnings: readonly string[];
+}
+/** Everything the collector knows that the plan should say. */
+export interface PlanContext {
+    tier: QueryTier;
+    /** The store's dialect name (`duckdb`, `clickhouse`, …). */
+    dialect: string;
+    /** Per-event-type counts over the query's range, for the channel warnings. */
+    channelCounts?: Readonly<Record<string, number>>;
+    /** How much data is behind the result. */
+    sampleSize?: SampleSize;
+    /** The row cap in force, and the rows the query produced, for truncation. */
+    limit?: number;
+    rows?: number;
+    /** Whether the project has the scene geometry a spatial label would need. */
+    spatial?: {
+        proxy: boolean;
+        regions: number;
+    };
+    /** Extra warnings the route knows and this module cannot. */
+    extra?: readonly string[];
+}
+/** The SQL and the parameter list of a compiled spec, with values withheld. */
+export declare function explainSpec(spec: QuerySpec): {
+    sql: string;
+    params: ExplainParam[];
+};
+/**
+ * The capture channels that produced nothing in this window.
+ *
+ * A channel with a zero count is the single most common reason an Uptimizr
+ * answer is empty and wrong: capture is a per-project dial (ADR 0012), and a
+ * project that never turned on gaze raycasting has no attention data at all —
+ * which is a different statement from "nobody looked at anything".
+ */
+export declare function silentChannels(metric: MetricDefinition, counts: Readonly<Record<string, number>> | undefined): readonly EventType[];
+/** Events of the metric's own channels in the window; `null` when unknowable. */
+export declare function channelRows(metric: MetricDefinition, counts: Readonly<Record<string, number>> | undefined): number | null;
+/**
+ * Every reason this result might not mean what it looks like, in the order a
+ * reader should weigh them: no data at all, then too little data, then data that
+ * has been cut off, then a presentational limit.
+ */
+export declare function planWarnings(metric: MetricDefinition, ctx: PlanContext, sampleSize: SampleSize): string[];
+/** Assemble the plan `explain: true` answers with. */
+export declare function explainQuery(metric: MetricDefinition, spec: QuerySpec, ctx: PlanContext): QueryPlan;
+//# sourceMappingURL=explain.d.ts.map

package/dist/query/dsl/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/query/dsl/explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtF,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC;;;;OAIG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qEAAqE;IACrE,UAAU,EAAE,UAAU,CAAC;IACvB,iEAAiE;IACjE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,0CAA0C;IAC1C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AA2BD,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAOpF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACnD,SAAS,SAAS,EAAE,CAGtB;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CACzB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACnD,MAAM,GAAG,IAAI,CAGf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,UAAU,GACrB,MAAM,EAAE,CA6CV;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,WAAW,GACf,SAAS,CAaX"}

package/dist/query/dsl/explain.js

@@ -0,0 +1,143 @@
+/**
+ * **`explain`: can I trust this?** (ADR 0051 §3, design sketch §C.2).
+ *
+ * The second thing an agent cannot do today. A result that came back empty
+ * because the capture channel is switched off looks exactly like a result that
+ * came back empty because nothing happened — and a model will report the second
+ * either way. `explain: true` answers the request with the **plan** instead of
+ * the rows: which tier would run, the SQL that tier renders for this store's
+ * dialect, the parameters it binds, how much data is behind the window, and
+ * every reason the answer might not mean what it looks like.
+ *
+ * ## Why the SQL can be shown at all
+ *
+ * Because it contains nothing to redact. The DSL's whole design is that no
+ * caller-supplied value ever reaches the SQL text: a scene id, a mesh name, an
+ * event predicate and a row cap are all bound parameters, and
+ * `src/__tests__/queryDsl.test.ts` proves it by pushing a hostile string through
+ * every filter and asserting it appears only in `query_params`. So the rendered
+ * plan is the *shape* of the query with placeholders where the values are, and
+ * {@link explainSpec} lists the parameters by **name and logical type only** —
+ * never their values, which may be a session id or a mesh name the caller is not
+ * entitled to see echoed into a shared transcript.
+ *
+ * That is also what makes `explain` worth having: a reader can check for
+ * themselves that the filter they asked for is in the `WHERE`, and that nothing
+ * else is.
+ *
+ * ## `rowsScanned`
+ *
+ * No supported engine reports rows scanned without either a second pass or a
+ * dialect-specific `EXPLAIN ANALYZE`, and paying for either on a read endpoint
+ * would be a poor trade. What the collector *can* answer cheaply is the honest
+ * version of the same question — how many events of the metric's own capture
+ * channels exist in the window — from the `event_counts` pass it already runs to
+ * detect a disabled channel. `null` where the metric declares no channels (a
+ * derived rollup).
+ */
+/** Collapse the rendered SQL to something a human can read in a transcript. */
+function tidy(sql) {
+    return sql
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .filter((line) => line.trim().length > 0)
+        .map((line) => line.replace(/^ {6}/, ""))
+        .join("\n")
+        .trim();
+}
+/** The logical type of a bound value, without ever reporting the value. */
+function typeOf(value) {
+    if (value instanceof Date)
+        return "timestamp";
+    if (typeof value === "number")
+        return "number";
+    if (typeof value === "boolean")
+        return "boolean";
+    if (typeof value === "string") {
+        // Every dialect binds a timestamp as either a `Date` or an ISO-8601 /
+        // naive-UTC string; `2024-06-16T10:00:00.000` is not a value anyone supplied
+        // as text, so reporting it as a timestamp is more useful than "string".
+        return /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}/.test(value) ? "timestamp" : "string";
+    }
+    return "json";
+}
+/** The SQL and the parameter list of a compiled spec, with values withheld. */
+export function explainSpec(spec) {
+    return {
+        sql: tidy(spec.query),
+        params: Object.entries(spec.query_params)
+            .map(([name, value]) => ({ name, type: typeOf(value) }))
+            .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0)),
+    };
+}
+/**
+ * The capture channels that produced nothing in this window.
+ *
+ * A channel with a zero count is the single most common reason an Uptimizr
+ * answer is empty and wrong: capture is a per-project dial (ADR 0012), and a
+ * project that never turned on gaze raycasting has no attention data at all —
+ * which is a different statement from "nobody looked at anything".
+ */
+export function silentChannels(metric, counts) {
+    if (counts == null)
+        return [];
+    return metric.sourceChannels.filter((channel) => (counts[channel] ?? 0) === 0);
+}
+/** Events of the metric's own channels in the window; `null` when unknowable. */
+export function channelRows(metric, counts) {
+    if (counts == null || metric.sourceChannels.length === 0)
+        return null;
+    return metric.sourceChannels.reduce((sum, channel) => sum + (counts[channel] ?? 0), 0);
+}
+/**
+ * Every reason this result might not mean what it looks like, in the order a
+ * reader should weigh them: no data at all, then too little data, then data that
+ * has been cut off, then a presentational limit.
+ */
+export function planWarnings(metric, ctx, sampleSize) {
+    const warnings = [];
+    const silent = silentChannels(metric, ctx.channelCounts);
+    if (silent.length > 0) {
+        warnings.push(`No \`${silent.join("`, `")}\` events exist in this project over the selected range, and ` +
+            `"${metric.id}" is computed from ${metric.sourceChannels.map((c) => `\`${c}\``).join(", ")}. ` +
+            "That is almost always a capture channel switched off (ADR 0012), not an absence of " +
+            "behaviour — check the project's capture options before reporting a zero.");
+    }
+    const minSample = metric.comparable?.minSample;
+    const observed = sampleSize.events ?? sampleSize.sessions;
+    if (minSample != null && observed != null && observed < minSample) {
+        warnings.push(`Only ${observed} events of this metric's capture channels exist in the selected window; ` +
+            `"${metric.id}" declares ${minSample} as the minimum at which a change is worth ` +
+            "reporting. Treat the numbers as directional.");
+    }
+    if ((metric.grain === "voxel" || metric.grain === "bin") &&
+        ctx.spatial != null &&
+        !ctx.spatial.proxy &&
+        ctx.spatial.regions === 0) {
+        warnings.push("This project has no scene proxy and no registered regions, so spatial results can only be " +
+            "reported as grid indices — there is nothing to name a hotspot after. Upload a scene " +
+            "proxy (`PUT /api/v1/scenes/:sceneId/proxy`) or register regions to get labels.");
+    }
+    if (ctx.limit != null && ctx.rows != null && ctx.rows >= ctx.limit) {
+        warnings.push(`The result hit its ${ctx.limit}-row cap, so totals and shares describe the returned rows ` +
+            "only. Narrow the query with a filter rather than raising the cap.");
+    }
+    warnings.push(...(ctx.extra ?? []));
+    return warnings;
+}
+/** Assemble the plan `explain: true` answers with. */
+export function explainQuery(metric, spec, ctx) {
+    const sampleSize = ctx.sampleSize ?? { sessions: null, events: null };
+    const { sql, params } = explainSpec(spec);
+    return {
+        metric: metric.id,
+        tier: ctx.tier,
+        dialect: ctx.dialect,
+        sql,
+        params,
+        rowsScanned: channelRows(metric, ctx.channelCounts),
+        sampleSize,
+        warnings: planWarnings(metric, ctx, sampleSize),
+    };
+}
+//# sourceMappingURL=explain.js.map

package/dist/query/dsl/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/query/dsl/explain.ts"],"names":[],"mappings":"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"}

package/dist/query/dsl/generic.d.ts

@@ -0,0 +1,127 @@
+/**
+ * **The generic group-by compiler** (ADR 0051 §3, design sketch §C.2, tier 2).
+ *
+ * The delegated tier (`compile.ts`) can run any metric, but only at the grain
+ * its builder renders: `top_meshes` is one row per mesh and nothing else. That
+ * is right for a spatial binning or a percentile — those measures *are* their
+ * grain — but wrong for a count. "How many mesh interactions per input source"
+ * and "…per scene" are the same question about the same events, and the only
+ * reason they needed two endpoints is that somebody wrote two `GROUP BY`s.
+ *
+ * So a metric that declares `genericGroupBy` in the registry (a portable
+ * `count` / `count(DISTINCT session_id)` / `sum` / `avg` / `max` over promoted
+ * columns) gets one shared, dialect-authored builder that renders
+ *
+ * ```sql
+ * SELECT <dimensions>, <measures>
+ *   FROM events [LEFT JOIN session_attrs …]
+ *  WHERE project_id = ? AND <event types> AND <scope> AND <range> AND <filters>
+ *  GROUP BY <dimensions>
+ *  ORDER BY <measure> DESC, <dimensions>
+ *  LIMIT ?
+ * ```
+ *
+ * for **any** subset of the dimensions that metric declares.
+ *
+ * ## Why this is still only one SQL path
+ *
+ * Everything variable in the SQL above comes from **registry data**, never from
+ * the request: the event types and the scope predicate are the metric's
+ * `genericGroupBy`, the measures are its declared columns, and each dimension's
+ * expression is chosen from a closed table keyed by `DimensionId`. Every value a
+ * caller supplies — a scene id, a mesh name, an event predicate — reaches the
+ * SQL as a bound parameter through the same {@link ParamBag} the canned
+ * aggregations use. There is no string interpolation of caller input anywhere in
+ * this file, which is what makes a grammar with a `GROUP BY` in it still a
+ * closed grammar.
+ *
+ * ## Portability
+ *
+ * The promoted dimensions (`scene_id`, `session_id`, `mesh`, `name`, `source`,
+ * `event_type`) are plain columns on every engine. The session attributes
+ * (`cameraMode`, `device.*`) live in the `session_start` payload, so they are
+ * read through `Dialect.jsonText` in one CTE and `LEFT JOIN`ed on `session_id`
+ * — the same shape `buildPerfByDevice` has always used. `GROUP BY` repeats the
+ * expressions rather than naming the output aliases, because T-SQL rejects the
+ * latter (the mssql dialect rewrites it, but not relying on the rewrite is
+ * cheaper than relying on it).
+ *
+ * ## Why it is not called `build*`
+ *
+ * Every `build*` export of this package is a dialect-agnostic aggregation with
+ * the signature `(projectId, opts, dialect)`, and the optional stores' suites
+ * enumerate them by that prefix to run each one against DuckDB. This one takes a
+ * `MetricDefinition` first, because the metric *is* its configuration — so it is
+ * a `compile*`, next to `compileMetric` and `compileQuery`, and the prefix keeps
+ * meaning what it has always meant.
+ *
+ * The one session attribute deliberately left out is `device.isMobile`: it is a
+ * boolean, and a group-by on it would key rows by `"true"` on one engine and `1`
+ * on another. `GENERIC_DIMENSIONS` in the registry says so, and `validateQuery`
+ * refuses it by name.
+ */
+import { type DimensionId, type MetricDefinition } from "@uptimizr/metrics";
+import { type Dialect } from "../dialect.js";
+import type { QuerySpec } from "../types.js";
+/**
+ * A funnel-step predicate (ADR 0038) as the generic tier takes it. Structurally
+ * the schema's `FunnelStep`, restated as a local shape so this module keeps no
+ * dependency on `@uptimizr/schema`.
+ */
+export interface GenericEventPredicate {
+    type: string;
+    name?: string;
+    mesh?: string;
+}
+/** Device attributes a generic query can be scoped to. */
+export interface GenericDeviceFilter {
+    os?: string;
+    browser?: string;
+}
+/**
+ * The option bag the generic builder takes. Assembled by
+ * {@link import("./compile.js").toBuilderOptions} from a validated query; every
+ * field is already registry-checked by the time it gets here.
+ */
+export interface GenericQueryOptions {
+    /** Inclusive lower bound (epoch ms). */
+    since?: number;
+    /** Exclusive upper bound (epoch ms). */
+    until?: number;
+    /** The grain to group by. Empty means "one row for the whole range". */
+    dimensions?: readonly DimensionId[];
+    scene?: string;
+    session?: string;
+    source?: string;
+    mesh?: string;
+    /** The stored `scene.cameraType`, already mapped from the DSL's `cameraMode`. */
+    cameraType?: string;
+    /** Restrict to sessions whose `session_start` declares these attributes. */
+    device?: GenericDeviceFilter;
+    /** Restrict to sessions in which at least one matching event occurred. */
+    event?: GenericEventPredicate;
+    /** Dimensions held fixed at a value, keyed by `DimensionId`. */
+    segment?: Readonly<Record<string, string>>;
+    /** Result order; defaults to the first measure, descending. */
+    order?: {
+        by: string;
+        dir: "asc" | "desc";
+    };
+    /** Row cap. Always applied — a generic group-by is unbounded without one. */
+    limit?: number;
+}
+/**
+ * Compile a generic group-by query for one metric.
+ *
+ * `metric` must declare `genericGroupBy` — the caller (`compileMetric`) has
+ * already checked that, and `validateQuery` before it, so the throw below guards
+ * a programming error rather than a client one.
+ */
+export declare function compileGenericGroupBy(metric: MetricDefinition, projectId: string, opts: GenericQueryOptions, d: Dialect): QuerySpec;
+/**
+ * The columns a generic group-by result carries, in order: the grouping
+ * dimensions, then the metric's measures. Used by the explain plan and by the
+ * tests that assert a generic row is self-describing.
+ */
+export declare function genericResultColumns(metric: MetricDefinition, dimensions: readonly DimensionId[]): readonly string[];
+//# sourceMappingURL=generic.d.ts.map

package/dist/query/dsl/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../src/query/dsl/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,gBAAgB,EAEtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA2C,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,gEAAgE;IAChE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,+DAA+D;IAC/D,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC;IAC5C,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4OD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,EACzB,CAAC,EAAE,OAAO,GACT,SAAS,CA+DX;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,WAAW,EAAE,GACjC,SAAS,MAAM,EAAE,CAKnB"}