@classytic/repo-core 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@classytic/repo-core` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.22.0] - 2026-08-12
+
+### Added — `pages: 0` conformance tests for empty results
+
+- `runStandardRepoConformance` now asserts `pages: 0` for empty offset envelopes (both the primary `getAll` path and the `aggregatePaginate` path). The field had no assertion anywhere in the suite; two kit paths diverged silently: the primary offset path computed `ceil(0/limit) = 0` while aggregate and lookup paths used `Math.max(1, ceil(...)) = 1`. The contract is `0` — zero rows fill zero pages — and it is what every kit's primary path already returned. The missing assertion let the drift reach a consumer as golden-fixture breakage when a `lookups` join rerouted a list read onto the divergent path.
+
 ## [0.21.0] - 2026-08-10
 
 ### Added — LRU-bounded `createMemoryCacheAdapter`

package/dist/testing/conformance.mjs

@@ -1003,6 +1003,31 @@ function runStandardRepoConformance(harness) {
 				expect(out.data).toHaveLength(1);
 				expect(out.total).toBe(1);
 			});
+			it("empty result reports pages: 0 (offset envelope)", async () => {
+				const out = await ctx.repo.getAll({
+					filters: { count: 999999 },
+					page: 1,
+					limit: 10
+				});
+				expect(out.data).toHaveLength(0);
+				expect(out.total).toBe(0);
+				expect(out.pages).toBe(0);
+			});
+			it.skipIf(skipNoAgg)("empty result reports pages: 0 (aggregatePaginate offset envelope)", async () => {
+				if (!ctx.repo.aggregatePaginate) return;
+				const result = await ctx.repo.aggregatePaginate.bind(ctx.repo)({
+					filter: eq("category", "__no_such_category__"),
+					groupBy: "category",
+					measures: { n: { op: "count" } },
+					page: 1,
+					limit: 10
+				});
+				expect(result.method).toBe("offset");
+				if (result.method !== "offset") throw new Error("expected offset envelope");
+				expect(result.data).toHaveLength(0);
+				expect(result.total).toBe(0);
+				expect(result.pages).toBe(0);
+			});
 		});
 		describe("Filter IR compilation parity", () => {
 			beforeEach(async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@classytic/repo-core",
-	"version": "0.21.0",
+	"version": "0.22.0",
 	"description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design — no plugins ship here; each kit owns its own.",
 	"type": "module",
 	"sideEffects": false,