@atscript/db 0.1.147 → 0.1.148

package/dist/{agg-CV7y8nC6.d.cts → agg-42CSpGDR.d.cts}

@@ -1,4 +1,4 @@
-import { AggregateControls, AggregateExpr as AggregateExpr$1, AggregateFn, AggregateFn as AggregateFn$1, AggregateQuery as AggregateQuery$1, AggregateResult, BucketExpr, BucketUnit as BucketUnit$1, CalendarBucketLabel, ComputedExpr, ResolvedBucket as ResolvedBucket$1, WeekStart, isAggregateExpr, isBucketExpr, resolveAlias } from "@uniqu/core";
+import { AggregateControls, AggregateExpr, AggregateExpr as AggregateExpr$1, AggregateFn, AggregateFn as AggregateFn$1, AggregateQuery as AggregateQuery$1, AggregateResult, BucketExpr, BucketUnit as BucketUnit$1, CalendarBucketLabel, ComputedExpr, ResolvedBucket as ResolvedBucket$1, WeekStart, isAggregateExpr, isBucketExpr, resolveAlias } from "@uniqu/core";
 
 //#region src/query/aggregate-fns.d.ts
 /**
@@ -8,7 +8,7 @@ import { AggregateControls, AggregateExpr as AggregateExpr$1, AggregateFn, Aggre
 type TDbAggregateFn = AggregateFn;
 /**
  * Every aggregate function — what an adapter that renders them all returns
- * from `aggregateFns()`.
+ * from `aggregateFns()` (`first` / `last` since 0.1.148).
  *
  * @since 0.1.136
  */

package/dist/{agg-D5DHsAby.d.mts → agg-Wo-smrYV.d.mts}

@@ -1,4 +1,4 @@
-import { AggregateControls, AggregateExpr as AggregateExpr$1, AggregateFn, AggregateFn as AggregateFn$1, AggregateQuery as AggregateQuery$1, AggregateResult, BucketExpr, BucketUnit as BucketUnit$1, CalendarBucketLabel, ComputedExpr, ResolvedBucket as ResolvedBucket$1, WeekStart, isAggregateExpr as isAggregateExpr$1, isBucketExpr as isBucketExpr$1, resolveAlias } from "@uniqu/core";
+import { AggregateControls, AggregateExpr, AggregateExpr as AggregateExpr$1, AggregateFn, AggregateFn as AggregateFn$1, AggregateQuery as AggregateQuery$1, AggregateResult, BucketExpr, BucketUnit as BucketUnit$1, CalendarBucketLabel, ComputedExpr, ResolvedBucket as ResolvedBucket$1, WeekStart, isAggregateExpr as isAggregateExpr$1, isBucketExpr as isBucketExpr$1, resolveAlias as resolveAlias$1 } from "@uniqu/core";
 
 //#region src/query/aggregate-fns.d.ts
 /**
@@ -8,7 +8,7 @@ import { AggregateControls, AggregateExpr as AggregateExpr$1, AggregateFn, Aggre
 type TDbAggregateFn = AggregateFn;
 /**
  * Every aggregate function — what an adapter that renders them all returns
- * from `aggregateFns()`.
+ * from `aggregateFns()` (`first` / `last` since 0.1.148).
  *
  * @since 0.1.136
  */
@@ -50,4 +50,4 @@ declare function resolveAggregateSearch(controls: {
   [key: `$${string}`]: unknown;
 } | undefined): TAggregateSearch | undefined;
 //#endregion
-export { TDbAggregateFn as _, AggregateResult as a, CalendarBucketLabel as c, WeekStart as d, isAggregateExpr$1 as f, ALL_AGGREGATE_FNS as g, resolveAlias as h, AggregateQuery$1 as i, ComputedExpr as l, resolveAggregateSearch as m, AggregateExpr$1 as n, BucketExpr as o, isBucketExpr$1 as p, AggregateFn$1 as r, BucketUnit$1 as s, AggregateControls as t, ResolvedBucket$1 as u, assertAggregateFn as v };
+export { TDbAggregateFn as _, AggregateResult as a, CalendarBucketLabel as c, WeekStart as d, isAggregateExpr$1 as f, ALL_AGGREGATE_FNS as g, resolveAlias$1 as h, AggregateQuery$1 as i, ComputedExpr as l, resolveAggregateSearch as m, AggregateExpr$1 as n, BucketExpr as o, isBucketExpr$1 as p, AggregateFn$1 as r, BucketUnit$1 as s, AggregateControls as t, ResolvedBucket$1 as u, assertAggregateFn as v };

package/dist/agg.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_aggregate_fns = require("./aggregate-fns-CtsRbZn9.cjs");
+const require_aggregate_fns = require("./aggregate-fns-C-UJRobm.cjs");
 let _uniqu_core = require("@uniqu/core");
 //#region src/agg.ts
 /**

package/dist/agg.d.cts

@@ -1,3 +1,3 @@
-import { n as TResolvedBucket } from "./buckets-CjdPipCC.cjs";
-import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-CV7y8nC6.cjs";
+import { r as TResolvedBucket } from "./buckets-DJiYlMXc.cjs";
+import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-42CSpGDR.cjs";
 export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, type BucketExpr, type BucketUnit, type CalendarBucketLabel, type ComputedExpr, type ResolvedBucket, type TDbAggregateFn, type TResolvedBucket, type WeekStart, assertAggregateFn, isAggregateExpr, isBucketExpr, resolveAggregateSearch, resolveAlias };

package/dist/agg.d.mts

@@ -1,3 +1,3 @@
-import { n as TResolvedBucket } from "./buckets-DYopfd2Y.mjs";
-import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-D5DHsAby.mjs";
+import { r as TResolvedBucket } from "./buckets-CNdTOnei.mjs";
+import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-Wo-smrYV.mjs";
 export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, type BucketExpr, type BucketUnit, type CalendarBucketLabel, type ComputedExpr, type ResolvedBucket, type TDbAggregateFn, type TResolvedBucket, type WeekStart, assertAggregateFn, isAggregateExpr, isBucketExpr, resolveAggregateSearch, resolveAlias };

package/dist/agg.mjs

@@ -1,4 +1,4 @@
-import { o as assertAggregateFn } from "./aggregate-fns-C0BymEqa.mjs";
+import { s as assertAggregateFn } from "./aggregate-fns-CyaZyb9I.mjs";
 import { isAggregateExpr, isBucketExpr, resolveAlias } from "@uniqu/core";
 //#region src/agg.ts
 /**

package/dist/{aggregate-fns-CtsRbZn9.cjs → aggregate-fns-C-UJRobm.cjs}

@@ -1,4 +1,5 @@
-const require_db_error = require("./db-error-DTkkeu5b.cjs");
+const require_db_error = require("./db-error-DRQH4sLY.cjs");
+let _uniqu_core = require("@uniqu/core");
 //#region src/query/aggregate-fns.ts
 /**
 * The only `$fn` names a `$select` aggregate may use. Any other name is rejected with
@@ -13,8 +14,25 @@ const SUPPORTED_AGGREGATE_FNS = [
 	"avg",
 	"min",
 	"max",
-	"countDistinct"
+	"countDistinct",
+	"first",
+	"last"
 ];
+/** Whether a `$select` entry is a `first` / `last` aggregate (uniqu's `ROW_ORDER_FNS`). */
+function isFirstLast(item) {
+	return (0, _uniqu_core.isAggregateExpr)(item) && _uniqu_core.ROW_ORDER_FNS.includes(item.$fn);
+}
+/**
+* The functions that return a value OF their source field (`min` / `max` /
+* `first` / `last`), rather than a count or a number — their result takes the
+* field's type.
+*/
+const SOURCE_VALUE_FNS = new Set([
+	"min",
+	"max",
+	"first",
+	"last"
+]);
 /**
 * The aggregates that are NULL over no (non-null) value — every function but
 * the counts, which are 0. So a view field reading a left-joined table must be
@@ -26,11 +44,20 @@ const NULL_WHEN_EMPTY_AGGREGATE_FNS = new Set([
 	"sum",
 	"avg",
 	"min",
-	"max"
+	"max",
+	"first",
+	"last"
 ]);
-/** The `@db.agg.*` annotation names, one per supported aggregate function. */
-const AGG_ANNOTATIONS = SUPPORTED_AGGREGATE_FNS.map((fn) => `db.agg.${fn}`);
-/** `BaseDbAdapter.aggregateFns()` by default: every function except `countDistinct`. */
+/**
+* The `@db.agg.*` annotation names, one per aggregate function a managed view
+* declares — every query-time function but `first` / `last` (a representative
+* row needs a query's `$rowOrder`).
+*/
+const AGG_ANNOTATIONS = SUPPORTED_AGGREGATE_FNS.filter((fn) => !_uniqu_core.ROW_ORDER_FNS.includes(fn)).map((fn) => `db.agg.${fn}`);
+/**
+* `BaseDbAdapter.aggregateFns()` by default: every function except
+* `countDistinct`, `first` and `last`.
+*/
 const BASE_AGGREGATE_FNS = new Set([
 	"sum",
 	"count",
@@ -40,7 +67,7 @@ const BASE_AGGREGATE_FNS = new Set([
 ]);
 /**
 * Every aggregate function — what an adapter that renders them all returns
-* from `aggregateFns()`.
+* from `aggregateFns()` (`first` / `last` since 0.1.148).
 *
 * @since 0.1.136
 */
@@ -81,6 +108,12 @@ Object.defineProperty(exports, "NULL_WHEN_EMPTY_AGGREGATE_FNS", {
 		return NULL_WHEN_EMPTY_AGGREGATE_FNS;
 	}
 });
+Object.defineProperty(exports, "SOURCE_VALUE_FNS", {
+	enumerable: true,
+	get: function() {
+		return SOURCE_VALUE_FNS;
+	}
+});
 Object.defineProperty(exports, "SUPPORTED_AGGREGATE_FNS", {
 	enumerable: true,
 	get: function() {
@@ -93,3 +126,9 @@ Object.defineProperty(exports, "assertAggregateFn", {
 		return assertAggregateFn;
 	}
 });
+Object.defineProperty(exports, "isFirstLast", {
+	enumerable: true,
+	get: function() {
+		return isFirstLast;
+	}
+});

package/dist/{aggregate-fns-C0BymEqa.mjs → aggregate-fns-CyaZyb9I.mjs}

@@ -1,4 +1,5 @@
-import { r as DbError } from "./db-error-D5uilS_A.mjs";
+import { r as DbError } from "./db-error-Az85UhTX.mjs";
+import { ROW_ORDER_FNS, isAggregateExpr } from "@uniqu/core";
 //#region src/query/aggregate-fns.ts
 /**
 * The only `$fn` names a `$select` aggregate may use. Any other name is rejected with
@@ -13,8 +14,25 @@ const SUPPORTED_AGGREGATE_FNS = [
 	"avg",
 	"min",
 	"max",
-	"countDistinct"
+	"countDistinct",
+	"first",
+	"last"
 ];
+/** Whether a `$select` entry is a `first` / `last` aggregate (uniqu's `ROW_ORDER_FNS`). */
+function isFirstLast(item) {
+	return isAggregateExpr(item) && ROW_ORDER_FNS.includes(item.$fn);
+}
+/**
+* The functions that return a value OF their source field (`min` / `max` /
+* `first` / `last`), rather than a count or a number — their result takes the
+* field's type.
+*/
+const SOURCE_VALUE_FNS = new Set([
+	"min",
+	"max",
+	"first",
+	"last"
+]);
 /**
 * The aggregates that are NULL over no (non-null) value — every function but
 * the counts, which are 0. So a view field reading a left-joined table must be
@@ -26,11 +44,20 @@ const NULL_WHEN_EMPTY_AGGREGATE_FNS = new Set([
 	"sum",
 	"avg",
 	"min",
-	"max"
+	"max",
+	"first",
+	"last"
 ]);
-/** The `@db.agg.*` annotation names, one per supported aggregate function. */
-const AGG_ANNOTATIONS = SUPPORTED_AGGREGATE_FNS.map((fn) => `db.agg.${fn}`);
-/** `BaseDbAdapter.aggregateFns()` by default: every function except `countDistinct`. */
+/**
+* The `@db.agg.*` annotation names, one per aggregate function a managed view
+* declares — every query-time function but `first` / `last` (a representative
+* row needs a query's `$rowOrder`).
+*/
+const AGG_ANNOTATIONS = SUPPORTED_AGGREGATE_FNS.filter((fn) => !ROW_ORDER_FNS.includes(fn)).map((fn) => `db.agg.${fn}`);
+/**
+* `BaseDbAdapter.aggregateFns()` by default: every function except
+* `countDistinct`, `first` and `last`.
+*/
 const BASE_AGGREGATE_FNS = new Set([
 	"sum",
 	"count",
@@ -40,7 +67,7 @@ const BASE_AGGREGATE_FNS = new Set([
 ]);
 /**
 * Every aggregate function — what an adapter that renders them all returns
-* from `aggregateFns()`.
+* from `aggregateFns()` (`first` / `last` since 0.1.148).
 *
 * @since 0.1.136
 */
@@ -57,4 +84,4 @@ function assertAggregateFn(fn, path = "$select") {
 	}]);
 }
 //#endregion
-export { SUPPORTED_AGGREGATE_FNS as a, NULL_WHEN_EMPTY_AGGREGATE_FNS as i, ALL_AGGREGATE_FNS as n, assertAggregateFn as o, BASE_AGGREGATE_FNS as r, AGG_ANNOTATIONS as t };
+export { SOURCE_VALUE_FNS as a, isFirstLast as c, NULL_WHEN_EMPTY_AGGREGATE_FNS as i, ALL_AGGREGATE_FNS as n, SUPPORTED_AGGREGATE_FNS as o, BASE_AGGREGATE_FNS as r, assertAggregateFn as s, AGG_ANNOTATIONS as t };

package/dist/aggregate-rules-D_bsCpUI.cjs

@@ -0,0 +1,26 @@
+//#region src/shared/aggregate-rules.ts
+/** `reason` of a `$groupBy` / bucket rejection for a field outside a strict aggregate table's dimensions. */
+const NOT_DIMENSION_REASON = "not a dimension";
+/**
+* Editor-time twin of the runtime `isStrictTable`: a table whose structure
+* declares any `@db.column.dimension` or `@db.column.measure` is strict —
+* only dimensions can be grouped by.
+* @since 0.1.148
+*/
+function isStrictAggregateStruct(struct) {
+	for (const prop of struct.props.values()) if (prop.countAnnotations("db.column.dimension") > 0 || prop.countAnnotations("db.column.measure") > 0) return true;
+	return false;
+}
+//#endregion
+Object.defineProperty(exports, "NOT_DIMENSION_REASON", {
+	enumerable: true,
+	get: function() {
+		return NOT_DIMENSION_REASON;
+	}
+});
+Object.defineProperty(exports, "isStrictAggregateStruct", {
+	enumerable: true,
+	get: function() {
+		return isStrictAggregateStruct;
+	}
+});

package/dist/aggregate-rules-jdPrxqWa.mjs

@@ -0,0 +1,15 @@
+//#region src/shared/aggregate-rules.ts
+/** `reason` of a `$groupBy` / bucket rejection for a field outside a strict aggregate table's dimensions. */
+const NOT_DIMENSION_REASON = "not a dimension";
+/**
+* Editor-time twin of the runtime `isStrictTable`: a table whose structure
+* declares any `@db.column.dimension` or `@db.column.measure` is strict —
+* only dimensions can be grouped by.
+* @since 0.1.148
+*/
+function isStrictAggregateStruct(struct) {
+	for (const prop of struct.props.values()) if (prop.countAnnotations("db.column.dimension") > 0 || prop.countAnnotations("db.column.measure") > 0) return true;
+	return false;
+}
+//#endregion
+export { isStrictAggregateStruct as n, NOT_DIMENSION_REASON as t };