@uniqu/url 0.1.1 → 0.1.3

package/README.md

@@ -152,6 +152,7 @@ Control keywords start with `$` and are separated from filter expressions:
 | `$skip` | — | `$skip=40` | `{ $skip: 40 }` |
 | `$count` | — | `$count` | `{ $count: true }` |
 | `$groupBy` | — | `$groupBy=currency,region` | `{ $groupBy: ['currency', 'region'] }` |
+| `$having` | — | `$having=total>1000` | `{ $having: { total: { $gt: 1000 } } }` |
 | `$with` | — | `$with=posts,author` | `{ $with: [{ name: 'posts', filter: {}, controls: {} }, ...] }` |
 | `$<custom>` | — | `$search=term` | `{ $search: 'term' }` |
 
@@ -220,6 +221,31 @@ Aggregates and `$groupBy` work inside `$with` sub-queries too:
 $with=orders($select=sum(total):revenue&$groupBy=status)
 ```
 
+### Post-Aggregation Filter (`$having`)
+
+`$having` filters groups after aggregation (SQL `HAVING`). It accepts the same filter expression syntax as the main query:
+
+```
+$having=total>1000                          → { $having: { total: { $gt: 1000 } } }
+$having=total>1000&$having=count_star>=5    → { $having: { $and: [...] } }   (AND-merged)
+$having=total>1000^avg_price<50             → { $having: { $or: [...] } }    (OR via ^)
+$having=!(total<100)                        → { $having: { $not: {...} } }   (NOT via !())
+```
+
+For multi-condition `$having` with AND, either use multiple `$having` params (AND-merged automatically) or wrap in parentheses:
+
+```
+$having=(total>1000&count_star>=5)
+```
+
+`$having` works inside `$with` sub-queries:
+
+```
+$with=orders($select=sum(total):revenue&$groupBy=status&$having=revenue>500)
+```
+
+Insights track `$having` fields with the `'$having'` op.
+
 ### Relation Loading (`$with`)
 
 `$with` declares which relations to populate alongside the primary query. Relations are comma-separated:
@@ -432,7 +458,7 @@ Accepts a `Uniquery` object and returns a URL query string (without leading `?`)
 
 All features are supported:
 - Filter expressions (comparisons, `$and`/`$or`/`$not`, `$in`/`$nin`, `$exists`, `$regex`)
-- Controls (`$select`, `$sort`, `$limit`, `$skip`, `$count`, `$groupBy`, `$with`)
+- Controls (`$select`, `$sort`, `$limit`, `$skip`, `$count`, `$groupBy`, `$having`, `$with`)
 - Aggregates in `$select` (`sum(amount):total`)
 - Nested `$with` sub-queries
 - Pass-through custom `$`-prefixed controls

package/dist/builder.cjs

@@ -36,7 +36,10 @@ function serializeFilter(expr) {
 		return inner ? `!(${inner})` : "";
 	}
 	let result = "";
-	for (const [field, value] of Object.entries(expr)) if ((0, _uniqu_core.isPrimitive)(value)) {
+	for (const [field, value] of Object.entries(expr)) if (value instanceof RegExp) {
+		const part = `${field}~=/${value.source}/${value.flags}`;
+		result = result ? result + "&" + part : part;
+	} else if ((0, _uniqu_core.isPrimitive)(value)) {
 		const part = `${field}=${serializeValue(value)}`;
 		result = result ? result + "&" + part : part;
 	} else for (const [op, opValue] of Object.entries(value)) {

package/dist/builder.mjs

@@ -35,7 +35,10 @@ function serializeFilter(expr) {
 		return inner ? `!(${inner})` : "";
 	}
 	let result = "";
-	for (const [field, value] of Object.entries(expr)) if (isPrimitive(value)) {
+	for (const [field, value] of Object.entries(expr)) if (value instanceof RegExp) {
+		const part = `${field}~=/${value.source}/${value.flags}`;
+		result = result ? result + "&" + part : part;
+	} else if (isPrimitive(value)) {
 		const part = `${field}=${serializeValue(value)}`;
 		result = result ? result + "&" + part : part;
 	} else for (const [op, opValue] of Object.entries(value)) {

package/dist/index.cjs

@@ -412,6 +412,7 @@ function buildExists(fields, positive) {
 function handleControls(parts) {
 	const controls = {};
 	const controlInsights = [];
+	const aliasToField = /* @__PURE__ */ new Map();
 	for (const raw of parts) {
 		const eqIdx = raw.indexOf("=");
 		const key = eqIdx === -1 ? raw : raw.slice(0, eqIdx);
@@ -464,6 +465,7 @@ function handleControls(parts) {
 							$field: field,
 							$as: alias
 						});
+						aliasToField.set(alias, field);
 						controlInsights.push([field, fn]);
 					}
 					controls.$select = arr;
@@ -531,6 +533,13 @@ function handleControls(parts) {
 			default: controls[key] = value;
 		}
 	}
+	if (aliasToField.size) for (let i = 0; i < controlInsights.length; i++) {
+		const [field, op] = controlInsights[i];
+		if (op === "$order") {
+			const real = aliasToField.get(field);
+			if (real) controlInsights[i] = [real, op];
+		}
+	}
 	return {
 		controls,
 		controlInsights

package/dist/index.mjs

@@ -411,6 +411,7 @@ function buildExists(fields, positive) {
 function handleControls(parts) {
 	const controls = {};
 	const controlInsights = [];
+	const aliasToField = /* @__PURE__ */ new Map();
 	for (const raw of parts) {
 		const eqIdx = raw.indexOf("=");
 		const key = eqIdx === -1 ? raw : raw.slice(0, eqIdx);
@@ -463,6 +464,7 @@ function handleControls(parts) {
 							$field: field,
 							$as: alias
 						});
+						aliasToField.set(alias, field);
 						controlInsights.push([field, fn]);
 					}
 					controls.$select = arr;
@@ -530,6 +532,13 @@ function handleControls(parts) {
 			default: controls[key] = value;
 		}
 	}
+	if (aliasToField.size) for (let i = 0; i < controlInsights.length; i++) {
+		const [field, op] = controlInsights[i];
+		if (op === "$order") {
+			const real = aliasToField.get(field);
+			if (real) controlInsights[i] = [real, op];
+		}
+	}
 	return {
 		controls,
 		controlInsights

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniqu/url",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "URL query string parser producing the Uniqu canonical query format",
   "license": "MIT",
   "author": "Artem Maltsev",
@@ -45,7 +45,7 @@
     "dist"
   ],
   "dependencies": {
-    "@uniqu/core": "^0.1.1"
+    "@uniqu/core": "^0.1.3"
   },
   "scripts": {
     "pub": "pnpm publish --access public",