@classytic/repo-core 0.32.0 → 0.33.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.33.0] - 2026-10-27
+
+### Changed - BREAKING: `PurgeStepRepository.countDocuments` renamed to `count` (`./cleanup`)
+
+`definePurgeStep` now counts through `count`, the `StandardRepo` name every kit implements; no kit has a `countDocuments` method. Before, a kit repository passed in (usually via an `as PurgeStepRepository` cast) previewed `estimated: 0` and failed every verify check with "could not verify". A test now checks that a `StandardRepo` is a `PurgeStepRepository` with no adapter. Migration: drop any `countDocuments: (f) => repo.count(f)` shim and pass the kit repository directly; in custom repositories and test stubs, rename `countDocuments` to `count`.
+
 ## [0.32.0] - 2026-10-23
 
 ### Added - `formatQuery` / `stringifyQuery` (`./query-parser`)

package/dist/cleanup/define-purge-step.d.mts

@@ -2,7 +2,8 @@ import { TenantPurgeOptions, TenantPurgeStrategy } from "../repository/types.mjs
 import { CleanupStep, CleanupStepContext } from "./types.mjs";
 /**
  * The repository surface a purge step needs — a structural subset of
- * `StandardRepo`, so any kit repository satisfies it without an adapter.
+ * `StandardRepo` (`purgeByField` + `count`, the same names every kit
+ * implements), so any kit repository satisfies it without an adapter.
  * Both members are optional so an engine that never wired the repository
  * yields a BLOCKER rather than a crash.
  */
@@ -14,7 +15,7 @@ interface PurgeStepRepository {
       message: string;
     };
   }>;
-  countDocuments?(filter: Record<string, unknown>): Promise<number>;
+  count?(filter: Record<string, unknown>): Promise<number>;
 }
 interface PurgeStepSpec {
   /** Stable machine id, unique within a recipe. */

package/dist/cleanup/define-purge-step.mjs

@@ -42,7 +42,7 @@ function definePurgeStep(repository, spec) {
 				estimated: 0,
 				blockers: [`${REPOSITORY_UNAVAILABLE}:${spec.id}`]
 			};
-			const estimated = await repository.countDocuments?.({ [spec.field]: scope }) ?? 0;
+			const estimated = await repository.count?.({ [spec.field]: scope }) ?? 0;
 			const blockers = await spec.guard?.(scope, ctx) ?? [];
 			return {
 				resource: spec.resource,
@@ -89,12 +89,12 @@ function definePurgeStep(repository, spec) {
 		},
 		async verify(ctx) {
 			const scope = scopeOf(ctx, spec.parameter);
-			if (!scope || !repository?.countDocuments) return [{
+			if (!scope || !repository?.count) return [{
 				name: verifyName,
 				ok: false,
 				detail: "could not verify — no scope or no count support"
 			}];
-			const remaining = await repository.countDocuments(filterFor(scope));
+			const remaining = await repository.count(filterFor(scope));
 			return [{
 				name: verifyName,
 				ok: remaining === 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/repo-core",
-  "version": "0.32.0",
+  "version": "0.33.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,