@m6d/cortex-cli 0.1.0

package/src/contracts/runtime/datasets.fixtures.json

@@ -0,0 +1,2849 @@
+{
+    "$comment": "Conformance fixtures every dataset host runs. `seed` holds the rows of three datasets: customers(id string, name string, city string), pets(id number, name string, species string, price number), orders(id number, customerId string, petId number, quantity number, total number, status string, placedAt date) with relations orders.customer -> customers on [customerId, id] and orders.pet -> pets on [petId, id]. Dates are ISO date or date-time strings, numbers are JSON numbers, a missing value is null. Each case is one query as POST {host}/{from} receives it and the exact rows it answers, in order; a dateTrunc value is the ISO date of the period's first day (weeks start on Monday), a datePart value an integer (dayOfWeek is 1 for Monday to 7 for Sunday); numbers compare by value, so 600 and 600.0 are the same row; a division by zero answers null; a window is an aggregate over the answered rows sharing its partition, answered on each of them, and qualify filters those rows after windows and computed values.",
+    "seed": {
+        "customers": [
+            {
+                "id": "c1",
+                "name": "Alice",
+                "city": "Riyadh"
+            },
+            {
+                "id": "c2",
+                "name": "Bob",
+                "city": "Jeddah"
+            },
+            {
+                "id": "c3",
+                "name": "Carol",
+                "city": "Riyadh"
+            },
+            {
+                "id": "c4",
+                "name": "Dan",
+                "city": "Dammam"
+            },
+            {
+                "id": "c5",
+                "name": "Noor",
+                "city": "Al_Khobar 100%"
+            }
+        ],
+        "pets": [
+            {
+                "id": 1,
+                "name": "Rex",
+                "species": "dog",
+                "price": 300
+            },
+            {
+                "id": 2,
+                "name": "Tom",
+                "species": "cat",
+                "price": 150
+            },
+            {
+                "id": 3,
+                "name": "Nemo",
+                "species": "fish",
+                "price": 20
+            },
+            {
+                "id": 4,
+                "name": "Kiwi",
+                "species": "bird",
+                "price": 80
+            },
+            {
+                "id": 5,
+                "name": "Bella",
+                "species": "dog",
+                "price": 450
+            }
+        ],
+        "orders": [
+            {
+                "id": 1,
+                "customerId": "c1",
+                "petId": 1,
+                "quantity": 1,
+                "total": 300,
+                "status": "shipped",
+                "placedAt": "2024-01-05"
+            },
+            {
+                "id": 2,
+                "customerId": "c2",
+                "petId": 2,
+                "quantity": 2,
+                "total": 300,
+                "status": "pending",
+                "placedAt": "2024-01-20"
+            },
+            {
+                "id": 3,
+                "customerId": "c3",
+                "petId": 3,
+                "quantity": 5,
+                "total": 100,
+                "status": "shipped",
+                "placedAt": "2024-02-02"
+            },
+            {
+                "id": 4,
+                "customerId": "c1",
+                "petId": 4,
+                "quantity": 1,
+                "total": 80,
+                "status": "cancelled",
+                "placedAt": "2024-02-14"
+            },
+            {
+                "id": 5,
+                "customerId": "c4",
+                "petId": 5,
+                "quantity": 1,
+                "total": 450,
+                "status": "shipped",
+                "placedAt": "2024-02-28"
+            },
+            {
+                "id": 6,
+                "customerId": "c2",
+                "petId": 1,
+                "quantity": 2,
+                "total": 600,
+                "status": null,
+                "placedAt": "2024-03-01T12:00:00"
+            },
+            {
+                "id": 7,
+                "customerId": "c3",
+                "petId": 2,
+                "quantity": 1,
+                "total": 150,
+                "status": "pending",
+                "placedAt": "2024-03-15"
+            },
+            {
+                "id": 8,
+                "customerId": "c1",
+                "petId": 3,
+                "quantity": 10,
+                "total": 200,
+                "status": "shipped",
+                "placedAt": "2024-03-30"
+            },
+            {
+                "id": 9,
+                "customerId": "c4",
+                "petId": 4,
+                "quantity": 3,
+                "total": 240,
+                "status": "shipped",
+                "placedAt": "2024-04-01"
+            },
+            {
+                "id": 10,
+                "customerId": "c2",
+                "petId": 5,
+                "quantity": 1,
+                "total": 450,
+                "status": null,
+                "placedAt": "2024-04-10"
+            },
+            {
+                "id": 11,
+                "customerId": "c3",
+                "petId": 1,
+                "quantity": 1,
+                "total": 300,
+                "status": "cancelled",
+                "placedAt": "2024-04-18"
+            },
+            {
+                "id": 12,
+                "customerId": "c1",
+                "petId": 2,
+                "quantity": 1,
+                "total": 150,
+                "status": "shipped",
+                "placedAt": "2024-04-25"
+            }
+        ]
+    },
+    "cases": [
+        {
+            "name": "filter on an own column",
+            "query": {
+                "from": "orders",
+                "select": ["id", "status"],
+                "filter": [
+                    {
+                        "col": "status",
+                        "op": "=",
+                        "value": "shipped"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "status": "shipped"
+                },
+                {
+                    "id": 3,
+                    "status": "shipped"
+                },
+                {
+                    "id": 5,
+                    "status": "shipped"
+                },
+                {
+                    "id": 8,
+                    "status": "shipped"
+                },
+                {
+                    "id": 9,
+                    "status": "shipped"
+                },
+                {
+                    "id": 12,
+                    "status": "shipped"
+                }
+            ]
+        },
+        {
+            "name": "filter on a joined column and select across the join",
+            "query": {
+                "from": "orders",
+                "join": ["customer"],
+                "select": ["id", "customer.name"],
+                "filter": [
+                    {
+                        "col": "customer.city",
+                        "op": "=",
+                        "value": "Riyadh"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "customer.name": "Alice"
+                },
+                {
+                    "id": 3,
+                    "customer.name": "Carol"
+                },
+                {
+                    "id": 4,
+                    "customer.name": "Alice"
+                },
+                {
+                    "id": 7,
+                    "customer.name": "Carol"
+                },
+                {
+                    "id": 8,
+                    "customer.name": "Alice"
+                },
+                {
+                    "id": 11,
+                    "customer.name": "Carol"
+                },
+                {
+                    "id": 12,
+                    "customer.name": "Alice"
+                }
+            ]
+        },
+        {
+            "name": "month bucket with count and sum",
+            "query": {
+                "from": "orders",
+                "groupBy": [
+                    {
+                        "expr": {
+                            "fn": "dateTrunc",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "as": "placedAt"
+                    }
+                ],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "sum",
+                        "col": "total",
+                        "as": "revenue"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "placedAt",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "placedAt": "2024-01-01",
+                    "orders": 2,
+                    "revenue": 600
+                },
+                {
+                    "placedAt": "2024-02-01",
+                    "orders": 3,
+                    "revenue": 630
+                },
+                {
+                    "placedAt": "2024-03-01",
+                    "orders": 3,
+                    "revenue": 950
+                },
+                {
+                    "placedAt": "2024-04-01",
+                    "orders": 4,
+                    "revenue": 1140
+                }
+            ]
+        },
+        {
+            "name": "select with sort and limit",
+            "query": {
+                "from": "orders",
+                "select": ["id", "total"],
+                "sort": [
+                    {
+                        "col": "total",
+                        "dir": "desc"
+                    },
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ],
+                "limit": 3
+            },
+            "rows": [
+                {
+                    "id": 6,
+                    "total": 600
+                },
+                {
+                    "id": 5,
+                    "total": 450
+                },
+                {
+                    "id": 10,
+                    "total": 450
+                }
+            ]
+        },
+        {
+            "name": "in",
+            "query": {
+                "from": "orders",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "col": "status",
+                        "op": "in",
+                        "value": ["shipped", "pending"]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1
+                },
+                {
+                    "id": 2
+                },
+                {
+                    "id": 3
+                },
+                {
+                    "id": 5
+                },
+                {
+                    "id": 7
+                },
+                {
+                    "id": 8
+                },
+                {
+                    "id": 9
+                },
+                {
+                    "id": 12
+                }
+            ]
+        },
+        {
+            "name": "notIn leaves nulls out, as SQL does",
+            "query": {
+                "from": "orders",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "col": "status",
+                        "op": "notIn",
+                        "value": ["cancelled", "pending"]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1
+                },
+                {
+                    "id": 3
+                },
+                {
+                    "id": 5
+                },
+                {
+                    "id": 8
+                },
+                {
+                    "id": 9
+                },
+                {
+                    "id": 12
+                }
+            ]
+        },
+        {
+            "name": "isNull",
+            "query": {
+                "from": "orders",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "col": "status",
+                        "op": "isNull"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 6
+                },
+                {
+                    "id": 10
+                }
+            ]
+        },
+        {
+            "name": "between on a number",
+            "query": {
+                "from": "orders",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "col": "total",
+                        "op": "between",
+                        "value": [150, 300]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1
+                },
+                {
+                    "id": 2
+                },
+                {
+                    "id": 7
+                },
+                {
+                    "id": 8
+                },
+                {
+                    "id": 9
+                },
+                {
+                    "id": 11
+                },
+                {
+                    "id": 12
+                }
+            ]
+        },
+        {
+            "name": "group by a joined column, sort by the aggregate alias then the key",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "sum",
+                        "col": "quantity",
+                        "as": "qty"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "qty",
+                        "dir": "desc"
+                    },
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "fish",
+                    "qty": 15
+                },
+                {
+                    "pet.species": "dog",
+                    "qty": 6
+                },
+                {
+                    "pet.species": "bird",
+                    "qty": 4
+                },
+                {
+                    "pet.species": "cat",
+                    "qty": 4
+                }
+            ]
+        },
+        {
+            "name": "count per customer across the join",
+            "query": {
+                "from": "orders",
+                "join": ["customer"],
+                "groupBy": ["customer.name"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "orders",
+                        "dir": "desc"
+                    },
+                    {
+                        "col": "customer.name",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "customer.name": "Alice",
+                    "orders": 4
+                },
+                {
+                    "customer.name": "Bob",
+                    "orders": 3
+                },
+                {
+                    "customer.name": "Carol",
+                    "orders": 3
+                },
+                {
+                    "customer.name": "Dan",
+                    "orders": 2
+                }
+            ]
+        },
+        {
+            "name": "contains with a percent sign in the value matches it literally",
+            "query": {
+                "from": "customers",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "col": "city",
+                        "op": "contains",
+                        "value": "100%"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": "c5"
+                }
+            ]
+        },
+        {
+            "name": "startsWith with an underscore in the value matches it literally",
+            "query": {
+                "from": "customers",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "col": "city",
+                        "op": "startsWith",
+                        "value": "Al_"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": "c5"
+                }
+            ]
+        },
+        {
+            "name": "not equal leaves nulls out, as SQL does",
+            "query": {
+                "from": "orders",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "col": "status",
+                        "op": "!=",
+                        "value": "shipped"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 2
+                },
+                {
+                    "id": 4
+                },
+                {
+                    "id": 7
+                },
+                {
+                    "id": 11
+                }
+            ]
+        },
+        {
+            "name": "avg and countDistinct across the pet join, grouped by species",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "avg",
+                        "col": "total",
+                        "as": "avgTotal"
+                    },
+                    {
+                        "fn": "countDistinct",
+                        "col": "customerId",
+                        "as": "buyers"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "bird",
+                    "avgTotal": 160,
+                    "buyers": 2
+                },
+                {
+                    "pet.species": "cat",
+                    "avgTotal": 200,
+                    "buyers": 3
+                },
+                {
+                    "pet.species": "dog",
+                    "avgTotal": 420,
+                    "buyers": 4
+                },
+                {
+                    "pet.species": "fish",
+                    "avgTotal": 150,
+                    "buyers": 2
+                }
+            ]
+        },
+        {
+            "name": "quarter bucket keys are the first day of the quarter",
+            "query": {
+                "from": "orders",
+                "groupBy": [
+                    {
+                        "expr": {
+                            "fn": "dateTrunc",
+                            "unit": "quarter",
+                            "of": "placedAt"
+                        },
+                        "as": "placedAt"
+                    }
+                ],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "placedAt",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "placedAt": "2024-01-01",
+                    "orders": 8
+                },
+                {
+                    "placedAt": "2024-04-01",
+                    "orders": 4
+                }
+            ]
+        },
+        {
+            "name": "an aggregate over no matching rows still answers one row",
+            "query": {
+                "from": "orders",
+                "filter": [
+                    {
+                        "col": "status",
+                        "op": "=",
+                        "value": "returned"
+                    }
+                ],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "sum",
+                        "col": "total",
+                        "as": "revenue"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "orders": 0,
+                    "revenue": 0
+                }
+            ]
+        },
+        {
+            "name": "an empty select means every column",
+            "query": {
+                "from": "pets",
+                "select": [],
+                "filter": [
+                    {
+                        "col": "id",
+                        "op": "=",
+                        "value": 1
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "name": "Rex",
+                    "species": "dog",
+                    "price": 300
+                }
+            ]
+        },
+        {
+            "name": "the dataset's own name as a column prefix is accepted",
+            "query": {
+                "from": "orders",
+                "select": ["orders.id", "orders.total"],
+                "filter": [
+                    {
+                        "col": "orders.status",
+                        "op": "=",
+                        "value": "shipped"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "orders.id",
+                        "dir": "asc"
+                    }
+                ],
+                "limit": 3
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "total": 300
+                },
+                {
+                    "id": 3,
+                    "total": 100
+                },
+                {
+                    "id": 5,
+                    "total": 450
+                }
+            ]
+        },
+        {
+            "name": "a relation a reference names is joined without being listed",
+            "query": {
+                "from": "orders",
+                "select": ["id", "customer.name"],
+                "filter": [
+                    {
+                        "col": "pet.species",
+                        "op": "=",
+                        "value": "dog"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "customer.name": "Alice"
+                },
+                {
+                    "id": 5,
+                    "customer.name": "Dan"
+                },
+                {
+                    "id": 6,
+                    "customer.name": "Bob"
+                },
+                {
+                    "id": 10,
+                    "customer.name": "Bob"
+                },
+                {
+                    "id": 11,
+                    "customer.name": "Carol"
+                }
+            ]
+        },
+        {
+            "name": "a select that repeats the group keys is ignored on a grouped query",
+            "query": {
+                "from": "orders",
+                "select": ["status"],
+                "groupBy": ["status"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "n"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "status",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "status": null,
+                    "n": 2
+                },
+                {
+                    "status": "cancelled",
+                    "n": 2
+                },
+                {
+                    "status": "pending",
+                    "n": 2
+                },
+                {
+                    "status": "shipped",
+                    "n": 6
+                }
+            ]
+        },
+        {
+            "name": "an aggregate filter narrows its own rows only",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "count",
+                        "as": "cancelled",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            }
+                        ]
+                    },
+                    {
+                        "fn": "sum",
+                        "col": "total",
+                        "as": "kept",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "!=",
+                                "value": "cancelled"
+                            }
+                        ]
+                    },
+                    {
+                        "fn": "avg",
+                        "col": "total",
+                        "as": "avgShipped",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "shipped"
+                            }
+                        ]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "bird",
+                    "orders": 2,
+                    "cancelled": 1,
+                    "kept": 240,
+                    "avgShipped": 240
+                },
+                {
+                    "pet.species": "cat",
+                    "orders": 3,
+                    "cancelled": 0,
+                    "kept": 600,
+                    "avgShipped": 150
+                },
+                {
+                    "pet.species": "dog",
+                    "orders": 5,
+                    "cancelled": 1,
+                    "kept": 750,
+                    "avgShipped": 375
+                },
+                {
+                    "pet.species": "fish",
+                    "orders": 2,
+                    "cancelled": 0,
+                    "kept": 300,
+                    "avgShipped": 150
+                }
+            ]
+        },
+        {
+            "name": "a filtered aggregate over none of a group's rows sums to 0 and averages to null",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "sum",
+                        "col": "total",
+                        "as": "cancelledTotal",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            }
+                        ]
+                    },
+                    {
+                        "fn": "avg",
+                        "col": "total",
+                        "as": "avgCancelled",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            }
+                        ]
+                    },
+                    {
+                        "fn": "max",
+                        "col": "quantity",
+                        "as": "maxCancelledQty",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            }
+                        ]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "bird",
+                    "cancelledTotal": 80,
+                    "avgCancelled": 80,
+                    "maxCancelledQty": 1
+                },
+                {
+                    "pet.species": "cat",
+                    "cancelledTotal": 0,
+                    "avgCancelled": null,
+                    "maxCancelledQty": null
+                },
+                {
+                    "pet.species": "dog",
+                    "cancelledTotal": 300,
+                    "avgCancelled": 300,
+                    "maxCancelledQty": 1
+                },
+                {
+                    "pet.species": "fish",
+                    "cancelledTotal": 0,
+                    "avgCancelled": null,
+                    "maxCancelledQty": null
+                }
+            ]
+        },
+        {
+            "name": "a condition compares a column with another column's arithmetic",
+            "query": {
+                "from": "orders",
+                "select": ["id", "quantity", "total"],
+                "filter": [
+                    {
+                        "col": "total",
+                        "op": ">",
+                        "value": {
+                            "col": {
+                                "op": "*",
+                                "left": "quantity",
+                                "right": 100
+                            }
+                        }
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "quantity": 1,
+                    "total": 300
+                },
+                {
+                    "id": 2,
+                    "quantity": 2,
+                    "total": 300
+                },
+                {
+                    "id": 5,
+                    "quantity": 1,
+                    "total": 450
+                },
+                {
+                    "id": 6,
+                    "quantity": 2,
+                    "total": 600
+                },
+                {
+                    "id": 7,
+                    "quantity": 1,
+                    "total": 150
+                },
+                {
+                    "id": 10,
+                    "quantity": 1,
+                    "total": 450
+                },
+                {
+                    "id": 11,
+                    "quantity": 1,
+                    "total": 300
+                },
+                {
+                    "id": 12,
+                    "quantity": 1,
+                    "total": 150
+                }
+            ]
+        },
+        {
+            "name": "an any group is OR inside the AND list",
+            "query": {
+                "from": "orders",
+                "select": ["id", "status", "total"],
+                "filter": [
+                    {
+                        "any": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            },
+                            {
+                                "col": "total",
+                                "op": ">=",
+                                "value": 450
+                            }
+                        ]
+                    },
+                    {
+                        "col": "quantity",
+                        "op": "<",
+                        "value": 5
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 4,
+                    "status": "cancelled",
+                    "total": 80
+                },
+                {
+                    "id": 5,
+                    "status": "shipped",
+                    "total": 450
+                },
+                {
+                    "id": 6,
+                    "status": null,
+                    "total": 600
+                },
+                {
+                    "id": 10,
+                    "status": null,
+                    "total": 450
+                },
+                {
+                    "id": 11,
+                    "status": "cancelled",
+                    "total": 300
+                }
+            ]
+        },
+        {
+            "name": "arithmetic inside an aggregate, and HAVING on an alias",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "avg",
+                        "col": {
+                            "op": "/",
+                            "left": "total",
+                            "right": "quantity"
+                        },
+                        "as": "unitPrice"
+                    }
+                ],
+                "having": [
+                    {
+                        "col": "orders",
+                        "op": ">",
+                        "value": 2
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "cat",
+                    "orders": 3,
+                    "unitPrice": 150
+                },
+                {
+                    "pet.species": "dog",
+                    "orders": 5,
+                    "unitPrice": 360
+                }
+            ]
+        },
+        {
+            "name": "HAVING on a group key, filtered count comparing two columns",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "pricey",
+                        "filter": [
+                            {
+                                "col": "total",
+                                "op": ">",
+                                "value": {
+                                    "col": {
+                                        "op": "*",
+                                        "left": "quantity",
+                                        "right": 100
+                                    }
+                                }
+                            }
+                        ]
+                    }
+                ],
+                "having": [
+                    {
+                        "col": "pet.species",
+                        "op": "!=",
+                        "value": "bird"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "cat",
+                    "pricey": 3
+                },
+                {
+                    "pet.species": "dog",
+                    "pricey": 5
+                },
+                {
+                    "pet.species": "fish",
+                    "pricey": 0
+                }
+            ]
+        },
+        {
+            "name": "a ratio between aggregates, ordered and limited",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "count",
+                        "as": "cancelled",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            }
+                        ]
+                    }
+                ],
+                "compute": [
+                    {
+                        "as": "cancelledShare",
+                        "expr": {
+                            "op": "/",
+                            "left": {
+                                "op": "*",
+                                "left": "cancelled",
+                                "right": 1
+                            },
+                            "right": "orders"
+                        }
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "cancelledShare",
+                        "dir": "desc"
+                    },
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ],
+                "limit": 2
+            },
+            "rows": [
+                {
+                    "pet.species": "bird",
+                    "orders": 2,
+                    "cancelled": 1,
+                    "cancelledShare": 0.5
+                },
+                {
+                    "pet.species": "dog",
+                    "orders": 5,
+                    "cancelled": 1,
+                    "cancelledShare": 0.2
+                }
+            ]
+        },
+        {
+            "name": "HAVING on a computed value",
+            "query": {
+                "from": "orders",
+                "groupBy": ["customerId"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "sum",
+                        "col": "total",
+                        "as": "revenue"
+                    }
+                ],
+                "compute": [
+                    {
+                        "as": "avgTotal",
+                        "expr": {
+                            "op": "/",
+                            "left": "revenue",
+                            "right": "orders"
+                        }
+                    }
+                ],
+                "having": [
+                    {
+                        "col": "avgTotal",
+                        "op": ">",
+                        "value": 200
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "customerId",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "customerId": "c2",
+                    "orders": 3,
+                    "revenue": 1350,
+                    "avgTotal": 450
+                },
+                {
+                    "customerId": "c4",
+                    "orders": 2,
+                    "revenue": 690,
+                    "avgTotal": 345
+                }
+            ]
+        },
+        {
+            "name": "a date part as a group key and in a filter",
+            "query": {
+                "from": "orders",
+                "filter": [
+                    {
+                        "col": {
+                            "fn": "datePart",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "op": ">=",
+                        "value": 2
+                    }
+                ],
+                "groupBy": [
+                    {
+                        "expr": {
+                            "fn": "datePart",
+                            "unit": "quarter",
+                            "of": "placedAt"
+                        },
+                        "as": "quarter"
+                    }
+                ],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "quarter",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "quarter": 1,
+                    "orders": 6
+                },
+                {
+                    "quarter": 2,
+                    "orders": 4
+                }
+            ]
+        },
+        {
+            "name": "a truncated date in a filter",
+            "query": {
+                "from": "orders",
+                "select": ["id", "total"],
+                "filter": [
+                    {
+                        "col": {
+                            "fn": "dateTrunc",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "op": "=",
+                        "value": "2024-03-01"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 6,
+                    "total": 600
+                },
+                {
+                    "id": 7,
+                    "total": 150
+                },
+                {
+                    "id": 8,
+                    "total": 200
+                }
+            ]
+        },
+        {
+            "name": "a date part inside an aggregate beside a truncated group key",
+            "query": {
+                "from": "orders",
+                "groupBy": [
+                    {
+                        "expr": {
+                            "fn": "dateTrunc",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "as": "month"
+                    }
+                ],
+                "aggregate": [
+                    {
+                        "fn": "max",
+                        "col": {
+                            "fn": "datePart",
+                            "unit": "day",
+                            "of": "placedAt"
+                        },
+                        "as": "lastDay"
+                    },
+                    {
+                        "fn": "min",
+                        "col": {
+                            "fn": "datePart",
+                            "unit": "dayOfWeek",
+                            "of": "placedAt"
+                        },
+                        "as": "firstWeekday"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "month",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "month": "2024-01-01",
+                    "lastDay": 20,
+                    "firstWeekday": 5
+                },
+                {
+                    "month": "2024-02-01",
+                    "lastDay": 28,
+                    "firstWeekday": 3
+                },
+                {
+                    "month": "2024-03-01",
+                    "lastDay": 30,
+                    "firstWeekday": 5
+                },
+                {
+                    "month": "2024-04-01",
+                    "lastDay": 25,
+                    "firstWeekday": 1
+                }
+            ]
+        },
+        {
+            "name": "top two orders per customer",
+            "query": {
+                "from": "orders",
+                "select": ["id", "customerId", "total"],
+                "rank": {
+                    "partitionBy": ["customerId"],
+                    "sort": [
+                        {
+                            "col": "total",
+                            "dir": "desc"
+                        },
+                        {
+                            "col": "id",
+                            "dir": "asc"
+                        }
+                    ],
+                    "limit": 2
+                },
+                "sort": [
+                    {
+                        "col": "customerId",
+                        "dir": "asc"
+                    },
+                    {
+                        "col": "total",
+                        "dir": "desc"
+                    },
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "customerId": "c1",
+                    "total": 300
+                },
+                {
+                    "id": 8,
+                    "customerId": "c1",
+                    "total": 200
+                },
+                {
+                    "id": 6,
+                    "customerId": "c2",
+                    "total": 600
+                },
+                {
+                    "id": 10,
+                    "customerId": "c2",
+                    "total": 450
+                },
+                {
+                    "id": 11,
+                    "customerId": "c3",
+                    "total": 300
+                },
+                {
+                    "id": 7,
+                    "customerId": "c3",
+                    "total": 150
+                },
+                {
+                    "id": 5,
+                    "customerId": "c4",
+                    "total": 450
+                },
+                {
+                    "id": 9,
+                    "customerId": "c4",
+                    "total": 240
+                }
+            ]
+        },
+        {
+            "name": "top two customers per species by revenue, after HAVING",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species", "customerId"],
+                "aggregate": [
+                    {
+                        "fn": "sum",
+                        "col": "total",
+                        "as": "revenue"
+                    }
+                ],
+                "having": [
+                    {
+                        "col": "revenue",
+                        "op": ">",
+                        "value": 100
+                    }
+                ],
+                "rank": {
+                    "partitionBy": ["pet.species"],
+                    "sort": [
+                        {
+                            "col": "revenue",
+                            "dir": "desc"
+                        },
+                        {
+                            "col": "customerId",
+                            "dir": "asc"
+                        }
+                    ],
+                    "limit": 2
+                },
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    },
+                    {
+                        "col": "revenue",
+                        "dir": "desc"
+                    },
+                    {
+                        "col": "customerId",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "bird",
+                    "customerId": "c4",
+                    "revenue": 240
+                },
+                {
+                    "pet.species": "cat",
+                    "customerId": "c2",
+                    "revenue": 300
+                },
+                {
+                    "pet.species": "cat",
+                    "customerId": "c1",
+                    "revenue": 150
+                },
+                {
+                    "pet.species": "dog",
+                    "customerId": "c2",
+                    "revenue": 1050
+                },
+                {
+                    "pet.species": "dog",
+                    "customerId": "c4",
+                    "revenue": 450
+                },
+                {
+                    "pet.species": "fish",
+                    "customerId": "c1",
+                    "revenue": 200
+                }
+            ]
+        },
+        {
+            "name": "value bands from a CASE as a group key",
+            "query": {
+                "from": "orders",
+                "groupBy": [
+                    {
+                        "expr": {
+                            "case": [
+                                {
+                                    "when": {
+                                        "col": "total",
+                                        "op": "<",
+                                        "value": 100
+                                    },
+                                    "then": {
+                                        "value": "small"
+                                    }
+                                },
+                                {
+                                    "when": {
+                                        "col": "total",
+                                        "op": "<",
+                                        "value": 300
+                                    },
+                                    "then": {
+                                        "value": "mid"
+                                    }
+                                }
+                            ],
+                            "else": {
+                                "value": "large"
+                            }
+                        },
+                        "as": "band"
+                    }
+                ],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "sum",
+                        "col": "total",
+                        "as": "revenue"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "band",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "band": "large",
+                    "orders": 6,
+                    "revenue": 2400
+                },
+                {
+                    "band": "mid",
+                    "orders": 5,
+                    "revenue": 840
+                },
+                {
+                    "band": "small",
+                    "orders": 1,
+                    "revenue": 80
+                }
+            ]
+        },
+        {
+            "name": "a CASE over a null column, selected and filtered on",
+            "query": {
+                "from": "orders",
+                "select": [
+                    "id",
+                    {
+                        "expr": {
+                            "case": [
+                                {
+                                    "when": {
+                                        "col": "status",
+                                        "op": "isNull"
+                                    },
+                                    "then": {
+                                        "value": "unknown"
+                                    }
+                                }
+                            ],
+                            "else": "status"
+                        },
+                        "as": "state"
+                    }
+                ],
+                "filter": [
+                    {
+                        "col": {
+                            "case": [
+                                {
+                                    "when": {
+                                        "col": "status",
+                                        "op": "isNull"
+                                    },
+                                    "then": {
+                                        "value": "unknown"
+                                    }
+                                }
+                            ],
+                            "else": "status"
+                        },
+                        "op": "in",
+                        "value": ["unknown", "cancelled"]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 4,
+                    "state": "cancelled"
+                },
+                {
+                    "id": 6,
+                    "state": "unknown"
+                },
+                {
+                    "id": 10,
+                    "state": "unknown"
+                },
+                {
+                    "id": 11,
+                    "state": "cancelled"
+                }
+            ]
+        },
+        {
+            "name": "UPPER in a filter and ROUND over a computed value",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "filter": [
+                    {
+                        "col": {
+                            "fn": "upper",
+                            "args": ["pet.species"]
+                        },
+                        "op": "=",
+                        "value": "DOG"
+                    }
+                ],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "avg",
+                        "col": "quantity",
+                        "as": "avgQty"
+                    }
+                ],
+                "compute": [
+                    {
+                        "as": "third",
+                        "expr": {
+                            "fn": "round",
+                            "args": [
+                                {
+                                    "op": "/",
+                                    "left": "avgQty",
+                                    "right": 3
+                                },
+                                2
+                            ]
+                        }
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "dog",
+                    "orders": 5,
+                    "avgQty": 1.2,
+                    "third": 0.4
+                }
+            ]
+        },
+        {
+            "name": "COALESCE, TRIM and LENGTH as selected values",
+            "query": {
+                "from": "orders",
+                "join": ["customer"],
+                "select": [
+                    "id",
+                    {
+                        "expr": {
+                            "fn": "coalesce",
+                            "args": [
+                                "status",
+                                {
+                                    "value": "unknown"
+                                }
+                            ]
+                        },
+                        "as": "state"
+                    },
+                    {
+                        "expr": {
+                            "fn": "length",
+                            "args": [
+                                {
+                                    "fn": "trim",
+                                    "args": ["customer.name"]
+                                }
+                            ]
+                        },
+                        "as": "nameLength"
+                    }
+                ],
+                "filter": [
+                    {
+                        "col": "id",
+                        "op": "in",
+                        "value": [1, 6]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "state": "shipped",
+                    "nameLength": 5
+                },
+                {
+                    "id": 6,
+                    "state": "unknown",
+                    "nameLength": 3
+                }
+            ]
+        },
+        {
+            "name": "NOT over an any group keeps SQL's null semantics",
+            "query": {
+                "from": "orders",
+                "select": ["id"],
+                "filter": [
+                    {
+                        "not": {
+                            "any": [
+                                {
+                                    "col": "status",
+                                    "op": "=",
+                                    "value": "shipped"
+                                },
+                                {
+                                    "col": "total",
+                                    "op": ">",
+                                    "value": 500
+                                }
+                            ]
+                        }
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 2
+                },
+                {
+                    "id": 4
+                },
+                {
+                    "id": 7
+                },
+                {
+                    "id": 11
+                }
+            ]
+        },
+        {
+            "name": "OFFSET after ORDER BY",
+            "query": {
+                "from": "orders",
+                "select": ["id"],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ],
+                "offset": 10
+            },
+            "rows": [
+                {
+                    "id": 11
+                },
+                {
+                    "id": 12
+                }
+            ]
+        },
+        {
+            "name": "endsWith with a percent sign in the value matches it literally",
+            "query": {
+                "from": "customers",
+                "select": ["id", "city"],
+                "filter": [
+                    {
+                        "col": "city",
+                        "op": "endsWith",
+                        "value": "100%"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": "c5",
+                    "city": "Al_Khobar 100%"
+                }
+            ]
+        },
+        {
+            "name": "a ratio whose divisor is zero is null",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    },
+                    {
+                        "fn": "count",
+                        "as": "cancelled",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            }
+                        ]
+                    }
+                ],
+                "compute": [
+                    {
+                        "as": "perCancelled",
+                        "expr": {
+                            "op": "/",
+                            "left": "orders",
+                            "right": "cancelled"
+                        }
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "bird",
+                    "orders": 2,
+                    "cancelled": 1,
+                    "perCancelled": 2
+                },
+                {
+                    "pet.species": "cat",
+                    "orders": 3,
+                    "cancelled": 0,
+                    "perCancelled": null
+                },
+                {
+                    "pet.species": "dog",
+                    "orders": 5,
+                    "cancelled": 1,
+                    "perCancelled": 5
+                },
+                {
+                    "pet.species": "fish",
+                    "orders": 2,
+                    "cancelled": 0,
+                    "perCancelled": null
+                }
+            ]
+        },
+        {
+            "name": "a grand total window beside grouped rows, and a share computed from it",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "groupBy": ["pet.species"],
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "orders"
+                    }
+                ],
+                "window": [
+                    {
+                        "fn": "sum",
+                        "col": "orders",
+                        "as": "total",
+                        "partitionBy": []
+                    }
+                ],
+                "compute": [
+                    {
+                        "as": "share",
+                        "expr": {
+                            "op": "/",
+                            "left": {
+                                "op": "*",
+                                "left": "orders",
+                                "right": 100
+                            },
+                            "right": "total"
+                        }
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "pet.species",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "pet.species": "bird",
+                    "orders": 2,
+                    "total": 12,
+                    "share": 16.666666666666668
+                },
+                {
+                    "pet.species": "cat",
+                    "orders": 3,
+                    "total": 12,
+                    "share": 25
+                },
+                {
+                    "pet.species": "dog",
+                    "orders": 5,
+                    "total": 12,
+                    "share": 41.666666666666664
+                },
+                {
+                    "pet.species": "fish",
+                    "orders": 2,
+                    "total": 12,
+                    "share": 16.666666666666668
+                }
+            ]
+        },
+        {
+            "name": "a partition average beside plain rows",
+            "query": {
+                "from": "orders",
+                "select": ["id", "customerId", "total"],
+                "window": [
+                    {
+                        "fn": "avg",
+                        "col": "total",
+                        "as": "customerAvg",
+                        "partitionBy": ["customerId"]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "customerId": "c1",
+                    "total": 300,
+                    "customerAvg": 182.5
+                },
+                {
+                    "id": 2,
+                    "customerId": "c2",
+                    "total": 300,
+                    "customerAvg": 450
+                },
+                {
+                    "id": 3,
+                    "customerId": "c3",
+                    "total": 100,
+                    "customerAvg": 183.33333333333334
+                },
+                {
+                    "id": 4,
+                    "customerId": "c1",
+                    "total": 80,
+                    "customerAvg": 182.5
+                },
+                {
+                    "id": 5,
+                    "customerId": "c4",
+                    "total": 450,
+                    "customerAvg": 345
+                },
+                {
+                    "id": 6,
+                    "customerId": "c2",
+                    "total": 600,
+                    "customerAvg": 450
+                },
+                {
+                    "id": 7,
+                    "customerId": "c3",
+                    "total": 150,
+                    "customerAvg": 183.33333333333334
+                },
+                {
+                    "id": 8,
+                    "customerId": "c1",
+                    "total": 200,
+                    "customerAvg": 182.5
+                },
+                {
+                    "id": 9,
+                    "customerId": "c4",
+                    "total": 240,
+                    "customerAvg": 345
+                },
+                {
+                    "id": 10,
+                    "customerId": "c2",
+                    "total": 450,
+                    "customerAvg": 450
+                },
+                {
+                    "id": 11,
+                    "customerId": "c3",
+                    "total": 300,
+                    "customerAvg": 183.33333333333334
+                },
+                {
+                    "id": 12,
+                    "customerId": "c1",
+                    "total": 150,
+                    "customerAvg": 182.5
+                }
+            ]
+        },
+        {
+            "name": "QUALIFY keeps the rows above their partition average",
+            "query": {
+                "from": "orders",
+                "select": ["id", "customerId", "total"],
+                "window": [
+                    {
+                        "fn": "avg",
+                        "col": "total",
+                        "as": "customerAvg",
+                        "partitionBy": ["customerId"]
+                    }
+                ],
+                "qualify": [
+                    {
+                        "col": "total",
+                        "op": ">",
+                        "value": {
+                            "col": "customerAvg"
+                        }
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "customerId": "c1",
+                    "total": 300,
+                    "customerAvg": 182.5
+                },
+                {
+                    "id": 5,
+                    "customerId": "c4",
+                    "total": 450,
+                    "customerAvg": 345
+                },
+                {
+                    "id": 6,
+                    "customerId": "c2",
+                    "total": 600,
+                    "customerAvg": 450
+                },
+                {
+                    "id": 8,
+                    "customerId": "c1",
+                    "total": 200,
+                    "customerAvg": 182.5
+                },
+                {
+                    "id": 11,
+                    "customerId": "c3",
+                    "total": 300,
+                    "customerAvg": 183.33333333333334
+                }
+            ]
+        },
+        {
+            "name": "a window with its own filter, and a limit after it",
+            "query": {
+                "from": "orders",
+                "join": ["pet"],
+                "select": ["id", "pet.species", "status"],
+                "window": [
+                    {
+                        "fn": "count",
+                        "as": "cancelledInSpecies",
+                        "filter": [
+                            {
+                                "col": "status",
+                                "op": "=",
+                                "value": "cancelled"
+                            }
+                        ],
+                        "partitionBy": ["pet.species"]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ],
+                "limit": 5
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "pet.species": "dog",
+                    "status": "shipped",
+                    "cancelledInSpecies": 1
+                },
+                {
+                    "id": 2,
+                    "pet.species": "cat",
+                    "status": "pending",
+                    "cancelledInSpecies": 0
+                },
+                {
+                    "id": 3,
+                    "pet.species": "fish",
+                    "status": "shipped",
+                    "cancelledInSpecies": 0
+                },
+                {
+                    "id": 4,
+                    "pet.species": "bird",
+                    "status": "cancelled",
+                    "cancelledInSpecies": 1
+                },
+                {
+                    "id": 5,
+                    "pet.species": "dog",
+                    "status": "shipped",
+                    "cancelledInSpecies": 1
+                }
+            ]
+        },
+        {
+            "name": "HAVING that rejects the one aggregate row of matched rows answers no row",
+            "query": {
+                "from": "orders",
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "n"
+                    }
+                ],
+                "having": [
+                    {
+                        "col": "n",
+                        "op": "<",
+                        "value": 1
+                    }
+                ]
+            },
+            "rows": []
+        },
+        {
+            "name": "QUALIFY that rejects the one aggregate row of matched rows answers no row",
+            "query": {
+                "from": "orders",
+                "aggregate": [
+                    {
+                        "fn": "count",
+                        "as": "n"
+                    }
+                ],
+                "qualify": [
+                    {
+                        "col": "n",
+                        "op": "<",
+                        "value": 1
+                    }
+                ]
+            },
+            "rows": []
+        },
+        {
+            "name": "rank keeps every row tied at the limit",
+            "query": {
+                "from": "orders",
+                "select": ["id", "customerId", "quantity"],
+                "rank": {
+                    "partitionBy": ["customerId"],
+                    "sort": [
+                        {
+                            "col": "quantity",
+                            "dir": "desc"
+                        }
+                    ],
+                    "limit": 1
+                },
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 2,
+                    "customerId": "c2",
+                    "quantity": 2
+                },
+                {
+                    "id": 3,
+                    "customerId": "c3",
+                    "quantity": 5
+                },
+                {
+                    "id": 6,
+                    "customerId": "c2",
+                    "quantity": 2
+                },
+                {
+                    "id": 8,
+                    "customerId": "c1",
+                    "quantity": 10
+                },
+                {
+                    "id": 9,
+                    "customerId": "c4",
+                    "quantity": 3
+                }
+            ]
+        },
+        {
+            "name": "a date part and a truncation of a truncated date",
+            "query": {
+                "from": "orders",
+                "select": [
+                    "id",
+                    {
+                        "expr": {
+                            "fn": "datePart",
+                            "unit": "year",
+                            "of": {
+                                "fn": "dateTrunc",
+                                "unit": "month",
+                                "of": "placedAt"
+                            }
+                        },
+                        "as": "year"
+                    },
+                    {
+                        "expr": {
+                            "fn": "datePart",
+                            "unit": "quarter",
+                            "of": {
+                                "fn": "dateTrunc",
+                                "unit": "month",
+                                "of": "placedAt"
+                            }
+                        },
+                        "as": "quarter"
+                    },
+                    {
+                        "expr": {
+                            "fn": "dateTrunc",
+                            "unit": "year",
+                            "of": {
+                                "fn": "dateTrunc",
+                                "unit": "month",
+                                "of": "placedAt"
+                            }
+                        },
+                        "as": "yearStart"
+                    }
+                ],
+                "filter": [
+                    {
+                        "col": "id",
+                        "op": "in",
+                        "value": [1, 9]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "year": 2024,
+                    "quarter": 1,
+                    "yearStart": "2024-01-01"
+                },
+                {
+                    "id": 9,
+                    "year": 2024,
+                    "quarter": 2,
+                    "yearStart": "2024-01-01"
+                }
+            ]
+        },
+        {
+            "name": "COALESCE of a truncated date and a date, and the two compared",
+            "query": {
+                "from": "orders",
+                "select": [
+                    "id",
+                    {
+                        "expr": {
+                            "case": [
+                                {
+                                    "when": {
+                                        "col": {
+                                            "fn": "dateTrunc",
+                                            "unit": "month",
+                                            "of": "placedAt"
+                                        },
+                                        "op": "=",
+                                        "value": {
+                                            "col": "placedAt"
+                                        }
+                                    },
+                                    "then": {
+                                        "value": "start"
+                                    }
+                                }
+                            ],
+                            "else": {
+                                "value": "later"
+                            }
+                        },
+                        "as": "atMonthStart"
+                    },
+                    {
+                        "expr": {
+                            "fn": "datePart",
+                            "unit": "day",
+                            "of": {
+                                "fn": "coalesce",
+                                "args": [
+                                    {
+                                        "fn": "dateTrunc",
+                                        "unit": "month",
+                                        "of": "placedAt"
+                                    },
+                                    "placedAt"
+                                ]
+                            }
+                        },
+                        "as": "day"
+                    }
+                ],
+                "filter": [
+                    {
+                        "col": "id",
+                        "op": "in",
+                        "value": [1, 6, 9]
+                    },
+                    {
+                        "col": {
+                            "fn": "dateTrunc",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "op": "<=",
+                        "value": {
+                            "col": "placedAt"
+                        }
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 1,
+                    "atMonthStart": "later",
+                    "day": 1
+                },
+                {
+                    "id": 6,
+                    "atMonthStart": "later",
+                    "day": 1
+                },
+                {
+                    "id": 9,
+                    "atMonthStart": "start",
+                    "day": 1
+                }
+            ]
+        },
+        {
+            "name": "MIN and MAX of a truncated date answer dates",
+            "query": {
+                "from": "orders",
+                "groupBy": ["customerId"],
+                "aggregate": [
+                    {
+                        "fn": "min",
+                        "col": {
+                            "fn": "dateTrunc",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "as": "firstMonth"
+                    },
+                    {
+                        "fn": "max",
+                        "col": {
+                            "fn": "dateTrunc",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "as": "lastMonth"
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "customerId",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "customerId": "c1",
+                    "firstMonth": "2024-01-01",
+                    "lastMonth": "2024-04-01"
+                },
+                {
+                    "customerId": "c2",
+                    "firstMonth": "2024-01-01",
+                    "lastMonth": "2024-04-01"
+                },
+                {
+                    "customerId": "c3",
+                    "firstMonth": "2024-02-01",
+                    "lastMonth": "2024-04-01"
+                },
+                {
+                    "customerId": "c4",
+                    "firstMonth": "2024-02-01",
+                    "lastMonth": "2024-04-01"
+                }
+            ]
+        },
+        {
+            "name": "a window MIN of a truncated date answers a date",
+            "query": {
+                "from": "orders",
+                "select": ["id", "customerId"],
+                "filter": [
+                    {
+                        "col": "customerId",
+                        "op": "=",
+                        "value": "c4"
+                    }
+                ],
+                "window": [
+                    {
+                        "fn": "min",
+                        "col": {
+                            "fn": "dateTrunc",
+                            "unit": "month",
+                            "of": "placedAt"
+                        },
+                        "as": "firstMonth",
+                        "partitionBy": ["customerId"]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 5,
+                    "customerId": "c4",
+                    "firstMonth": "2024-02-01"
+                },
+                {
+                    "id": 9,
+                    "customerId": "c4",
+                    "firstMonth": "2024-02-01"
+                }
+            ]
+        },
+        {
+            "name": "LENGTH of a NULL is NULL",
+            "query": {
+                "from": "orders",
+                "select": [
+                    "id",
+                    {
+                        "expr": {
+                            "fn": "length",
+                            "args": ["status"]
+                        },
+                        "as": "statusLength"
+                    }
+                ],
+                "filter": [
+                    {
+                        "col": "id",
+                        "op": "in",
+                        "value": [5, 6]
+                    }
+                ],
+                "sort": [
+                    {
+                        "col": "id",
+                        "dir": "asc"
+                    }
+                ]
+            },
+            "rows": [
+                {
+                    "id": 5,
+                    "statusLength": 7
+                },
+                {
+                    "id": 6,
+                    "statusLength": null
+                }
+            ]
+        }
+    ]
+}