@classytic/repo-core 0.31.1 → 0.33.0

package/CHANGELOG.md

@@ -4,6 +4,26 @@ 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`)
+
+The inverse of `parseUrl`: typed filter terms `{ field, op?, value, flags? }` plus `sort`, `page`, `limit`, `search` become the flat bracket params the parser accepts. Operators come from `URL_OPERATORS`; `between` is sent as `gte` + `lte`; `in`/`nin` take arrays; Dates go as ISO; empty values are no filter; a value the grammar cannot carry (comma in a list value, the text `null`, a repeated field and operator) throws `QueryGrammarError`. Round-trip tests cover every operator. Types: `FilterTerm`, `FilterOperator`, `FormatQueryInput`, `QueryParams`.
+
+### Added - agent skill and `llms.txt`
+
+`skills/repo-core` and `llms.txt` ship in the package, and `npm run check:skills` (part of `prepublishOnly`) verifies that every import, subpath and API name they mention exists in the built package.
+
+### Changed - peer floor to the latest published
+
+`fast-check` `^4.10.2` (optional peer of `./testing`).
+
 ## [0.31.1] - 2026-10-13
 
 ### Fixed — `fast-check` is an optional peer of `./testing`

package/dist/_virtual/_rolldown/runtime.mjs

@@ -1,7 +1,6 @@
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
 	if (typeof require !== "undefined") return require.apply(this, arguments);
 	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
 });
-//#endregion
 export { __require };

package/dist/adapter/index.mjs

@@ -1,2 +1 @@
-import { asRepositoryLike, isRepository } from "./widen.mjs";
-export { asRepositoryLike, isRepository };
+export { asRepositoryLike, isRepository } from "./widen.mjs";

package/dist/adapter/types.d.mts

@@ -1,6 +1,5 @@
 import { DeleteResult, MinimalRepo, StandardRepo } from "../repository/types.mjs";
 import { SchemaBuilderOptions } from "../schema/types.mjs";
-//#region src/adapter/types.d.ts
 /**
  * Cross-kit repository contract.
  *
@@ -235,5 +234,4 @@ interface DataAdapter<TDoc = unknown> {
  * options (e.g. `{ model, schemaGenerator, ... }`).
  */
 type AdapterFactory<TDoc = unknown> = (config: unknown) => DataAdapter<TDoc>;
-//#endregion
 export { AdapterFactory, AdapterRepositoryInput, AdapterSchemaContext, AdapterValidationResult, DataAdapter, FieldMetadata, OpenApiSchemas, RelationMetadata, RepositoryLike, SchemaMetadata };

package/dist/adapter/widen.d.mts

@@ -1,5 +1,4 @@
 import { AdapterRepositoryInput, RepositoryLike } from "./types.mjs";
-//#region src/adapter/widen.d.ts
 /**
  * Widen a permissive `AdapterRepositoryInput<TDoc>` to the strict
  * `RepositoryLike<TDoc>` view used by host internals.
@@ -17,5 +16,4 @@ declare function asRepositoryLike<TDoc = unknown>(input: AdapterRepositoryInput<
  * factories to validate input before wrapping.
  */
 declare function isRepository<TDoc = unknown>(value: unknown): value is RepositoryLike<TDoc>;
-//#endregion
 export { asRepositoryLike, isRepository };

package/dist/adapter/widen.mjs

@@ -1,4 +1,4 @@
-//#region src/adapter/widen.ts
+// src/adapter/widen.ts
 /**
 * Widen a permissive `AdapterRepositoryInput<TDoc>` to the strict
 * `RepositoryLike<TDoc>` view used by host internals.
@@ -22,5 +22,4 @@ function isRepository(value) {
 	const v = value;
 	return typeof v["getAll"] === "function" && typeof v["getById"] === "function" && typeof v["create"] === "function" && typeof v["update"] === "function" && typeof v["delete"] === "function";
 }
-//#endregion
 export { asRepositoryLike, isRepository };

package/dist/aggregate/keyset.d.mts

@@ -1,4 +1,3 @@
-//#region src/aggregate/keyset.d.ts
 /**
  * Keyset (cursor) pagination helpers — the portable, kit-neutral half.
  *
@@ -53,5 +52,4 @@ declare function isKeysetMode(req: {
   pagination?: string;
   after?: string;
 }): boolean;
-//#endregion
 export { DecodedCursor, decodeAggCursor, encodeAggCursor, isKeysetMode };

package/dist/aggregate/keyset.mjs

@@ -1,4 +1,4 @@
-//#region src/aggregate/keyset.ts
+// src/aggregate/keyset.ts
 /**
 * Encode a cursor from the last row of a page given the sort spec.
 *
@@ -41,5 +41,4 @@ function isKeysetMode(req) {
 	if (typeof req.after === "string" && req.after.length > 0) return true;
 	return false;
 }
-//#endregion
 export { decodeAggCursor, encodeAggCursor, isKeysetMode };

package/dist/aggregate/normalize.d.mts

@@ -1,5 +1,4 @@
 import { AggRequest } from "../repository/types.mjs";
-//#region src/aggregate/normalize.d.ts
 /**
  * Normalize `AggRequest['groupBy']` into a readonly string array.
  * Returns `[]` for scalar aggregation (no groupBy). Downstream
@@ -19,5 +18,4 @@ declare function normalizeGroupBy(groupBy: AggRequest['groupBy']): readonly stri
  * to walk the trace.
  */
 declare function validateMeasures(measures: AggRequest['measures'], kitName: string): void;
-//#endregion
 export { normalizeGroupBy, validateMeasures };

package/dist/aggregate/normalize.mjs

@@ -1,4 +1,4 @@
-//#region src/aggregate/normalize.ts
+// src/aggregate/normalize.ts
 /**
 * Normalize `AggRequest['groupBy']` into a readonly string array.
 * Returns `[]` for scalar aggregation (no groupBy). Downstream
@@ -24,5 +24,4 @@ function normalizeGroupBy(groupBy) {
 function validateMeasures(measures, kitName) {
 	if (!measures || Object.keys(measures).length === 0) throw new Error(`${kitName}/aggregate: AggRequest requires at least one measure — empty measures bag is a wiring bug`);
 }
-//#endregion
 export { normalizeGroupBy, validateMeasures };

package/dist/better-auth/index.d.mts

@@ -1,4 +1,3 @@
-//#region src/better-auth/index.d.ts
 /**
  * Better Auth — kit-agnostic registry of which collections each plugin owns.
  *
@@ -118,5 +117,4 @@ interface ResolveBetterAuthCollectionsOptions {
  * collection names. `core` is always included.
  */
 declare function resolveBetterAuthCollections(options?: ResolveBetterAuthCollectionsOptions): string[];
-//#endregion
 export { BA_COLLECTIONS_BY_PLUGIN, BetterAuthPluginKey, ResolveBetterAuthCollectionsOptions, pluralizeBetterAuthCollection, resolveBetterAuthCollections };

package/dist/better-auth/index.mjs

@@ -1,4 +1,4 @@
-//#region src/better-auth/index.ts
+// src/better-auth/index.ts
 /**
 * Canonical collection lists per plugin. `core` is always implied by
 * `resolveBetterAuthCollections` — callers don't need to pass it.
@@ -74,5 +74,4 @@ function resolveBetterAuthCollections(options = {}) {
 	}
 	return unique;
 }
-//#endregion
 export { BA_COLLECTIONS_BY_PLUGIN, pluralizeBetterAuthCollection, resolveBetterAuthCollections };

package/dist/cache/engine.d.mts

@@ -1,6 +1,5 @@
 import { CacheReadResult, ResolvedCacheOptions } from "./options.mjs";
 import { CacheAdapter } from "./types.mjs";
-//#region src/cache/engine.d.ts
 interface CacheEngineOptions {
   /** Cache key namespace prefix. Default: `'rc'`. */
   prefix?: string;
@@ -152,5 +151,4 @@ declare class CacheEngine {
    */
   prefetch<TData>(key: string, opts: ResolvedCacheOptions, fetcher: () => Promise<TData>): Promise<TData>;
 }
-//#endregion
 export { CacheAdapterResolver, CacheAdapterSource, CacheEngine, CacheEngineOptions, SingleFlightClaim };

package/dist/cache/engine.mjs

@@ -1,7 +1,7 @@
 import { buildEnvelope, inspectEnvelope } from "./envelope.mjs";
 import { appendKeyToTags, invalidateByTags } from "./tag-index.mjs";
 import { bumpModelVersion, getModelVersion } from "./version-store.mjs";
-//#region src/cache/engine.ts
+// src/cache/engine.ts
 /**
 * `CacheEngine` — the SWR + TTL + tag-invalidation behavior on top of
 * a `CacheAdapter`. ONE implementation of the cache-flow primitives,
@@ -274,5 +274,4 @@ function resolveJitter(jitter) {
 		return Math.max(1, Math.round(jittered));
 	};
 }
-//#endregion
 export { CacheEngine };

package/dist/cache/envelope.mjs

@@ -1,4 +1,4 @@
-//#region src/cache/envelope.ts
+// src/cache/envelope.ts
 /** Build an envelope from raw data + freshness windows (seconds). */
 function buildEnvelope(data, staleTimeSeconds, gcTimeSeconds, tags, now = Date.now()) {
 	const staleAfter = now + Math.max(0, staleTimeSeconds) * 1e3;
@@ -28,5 +28,4 @@ function inspectEnvelope(envelope, now = Date.now()) {
 		envelope
 	};
 }
-//#endregion
 export { buildEnvelope, inspectEnvelope };

package/dist/cache/keys.mjs

@@ -1,5 +1,5 @@
 import { stableStringify } from "./stable-stringify.mjs";
-//#region src/cache/keys.ts
+// src/cache/keys.ts
 /**
 * Cache key derivation. Builds stable keys from operation context so
 * any kit + arc + Express/Nest hosts compute the same key for the
@@ -127,5 +127,4 @@ function fnv1a64(str) {
 	}
 	return hash.toString(36);
 }
-//#endregion
 export { buildCacheKey, extractScopeTags, mergeTags, scopeKeyFromTags, tagIndexKey, versionKey };

package/dist/cache/memo.d.mts

@@ -1,4 +1,3 @@
-//#region src/cache/memo.d.ts
 /**
  * `createTtlMemo` — memoise a keyed async load for `ttlMs`, single-flight.
  *
@@ -30,5 +29,4 @@ interface TtlMemo<K, V> {
   invalidate(key?: K): Promise<void>;
 }
 declare function createTtlMemo<K, V>(load: (key: K) => Promise<V>, options: TtlMemoOptions<K>): TtlMemo<K, V>;
-//#endregion
 export { TtlMemo, TtlMemoOptions, createTtlMemo };

package/dist/cache/memo.mjs

@@ -1,6 +1,6 @@
 import { CacheEngine } from "./engine.mjs";
 import { createMemoryCacheAdapter } from "./memory-adapter.mjs";
-//#region src/cache/memo.ts
+// src/cache/memo.ts
 /**
 * `createTtlMemo` — memoise a keyed async load for `ttlMs`, single-flight.
 *
@@ -56,5 +56,4 @@ function createTtlMemo(load, options) {
 		}
 	};
 }
-//#endregion
 export { createTtlMemo };

package/dist/cache/memory-adapter.d.mts

@@ -1,5 +1,4 @@
 import { CacheAdapter } from "./types.mjs";
-//#region src/cache/memory-adapter.d.ts
 interface MemoryCacheAdapterOptions {
   /**
    * Hard entry ceiling; the least-recently-used entry is evicted past it.
@@ -20,5 +19,4 @@ interface MemoryCacheAdapterOptions {
 /** Minimal in-memory `Map`-backed adapter with per-key TTL, LRU eviction and
  *  prefix invalidation. */
 declare function createMemoryCacheAdapter(options?: MemoryCacheAdapterOptions): CacheAdapter;
-//#endregion
 export { MemoryCacheAdapterOptions, createMemoryCacheAdapter };

package/dist/cache/memory-adapter.mjs

@@ -1,4 +1,4 @@
-//#region src/cache/memory-adapter.ts
+// src/cache/memory-adapter.ts
 /** Minimal in-memory `Map`-backed adapter with per-key TTL, LRU eviction and
 *  prefix invalidation. */
 function createMemoryCacheAdapter(options = {}) {
@@ -100,5 +100,4 @@ function createMemoryCacheAdapter(options = {}) {
 		}
 	};
 }
-//#endregion
 export { createMemoryCacheAdapter };

package/dist/cache/options.d.mts

@@ -1,4 +1,3 @@
-//#region src/cache/options.d.ts
 /**
  * Canonical per-call cache options. TanStack Query-shaped — the same
  * `staleTime` / `gcTime` mental model browser developers already know,
@@ -108,5 +107,4 @@ interface ResolvedCacheOptions {
   enabled: boolean;
   key?: string;
 }
-//#endregion
 export { CacheOptions, CacheReadResult, ResolvedCacheOptions };

package/dist/cache/options.mjs

@@ -1,4 +1,4 @@
-//#region src/cache/options.ts
+// src/cache/options.ts
 /**
 * Merge precedence (highest wins): per-call > per-op-default > plugin-default > built-in.
 *
@@ -21,5 +21,4 @@ function resolveCacheOptions(callOpts, perOpDefaults, pluginDefaults) {
 		...merged.key !== void 0 ? { key: merged.key } : {}
 	};
 }
-//#endregion
 export { resolveCacheOptions };

package/dist/cache/plugin/context.d.mts

@@ -1,4 +1,3 @@
-//#region src/cache/plugin/context.d.ts
 /**
  * Default per-op allowlist of context fields that affect result shape
  * (and therefore must participate in the cache key). Hosts can extend
@@ -14,5 +13,4 @@
  *     option (e.g. mongoose's `lean`, prisma's `select` shape, etc.).
  */
 declare const DEFAULT_SHAPE_KEYS_BY_OP: Readonly<Record<string, readonly string[]>>;
-//#endregion
 export { DEFAULT_SHAPE_KEYS_BY_OP };

package/dist/cache/plugin/context.mjs

@@ -1,4 +1,4 @@
-//#region src/cache/plugin/context.ts
+// src/cache/plugin/context.ts
 /**
 * Cast a raw hook context into the typed slots view. One call per
 * hook entry; subsequent slot reads/writes use plain dotted access.
@@ -119,5 +119,4 @@ function extractCallCacheOptions(context, op) {
 	const inOptions = context["options"]?.["cache"];
 	if (inOptions && typeof inOptions === "object") return inOptions;
 }
-//#endregion
 export { AGGREGATE_OPS, DEFAULT_SHAPE_KEYS_BY_OP, ctx, extractCallCacheOptions, extractShapeFields };

package/dist/cache/plugin/index.d.mts

@@ -2,7 +2,6 @@ import { Plugin } from "../../repository/plugin-types.mjs";
 import { CacheOptions, CacheReadResult } from "../options.mjs";
 import { CacheAdapterSource, CacheEngine } from "../engine.mjs";
 import { DEFAULT_SHAPE_KEYS_BY_OP } from "./context.mjs";
-//#region src/cache/plugin/index.d.ts
 /** Default read ops the plugin caches. Kits may override per resource. */
 declare const DEFAULT_CACHEABLE_OPS: readonly ['getById', 'getAll', 'getOne', 'getByQuery', 'count', 'exists', 'distinct', 'aggregate', 'aggregatePaginate'];
 /** Default mutating ops that bump version + invalidate tags on success. */
@@ -99,5 +98,4 @@ interface RepositoryCacheHandle {
  * and `softDelete` so policy filters land in the cache key.
  */
 declare function cachePlugin(options: RepositoryCachePluginOptions): Plugin;
-//#endregion
 export { DEFAULT_CACHEABLE_OPS, DEFAULT_INVALIDATING_OPS, DEFAULT_SHAPE_KEYS_BY_OP, LogCallbacks, RepositoryCacheHandle, RepositoryCachePluginOptions, cachePlugin };

package/dist/cache/plugin/index.mjs

@@ -2,7 +2,7 @@ import { CacheEngine } from "../engine.mjs";
 import { DEFAULT_SHAPE_KEYS_BY_OP } from "./context.mjs";
 import { registerInvalidationHooks } from "./invalidation-hooks.mjs";
 import { registerReadHooks } from "./read-hooks.mjs";
-//#region src/cache/plugin/index.ts
+// src/cache/plugin/index.ts
 /** Default read ops the plugin caches. Kits may override per resource. */
 const DEFAULT_CACHEABLE_OPS = [
 	"getById",
@@ -74,5 +74,4 @@ function cachePlugin(options) {
 		}
 	};
 }
-//#endregion
 export { DEFAULT_CACHEABLE_OPS, DEFAULT_INVALIDATING_OPS, DEFAULT_SHAPE_KEYS_BY_OP, cachePlugin };

package/dist/cache/plugin/invalidation-hooks.mjs

@@ -1,7 +1,7 @@
 import { HOOK_PRIORITY } from "../../hooks/priority.mjs";
 import { extractScopeTags, mergeTags, scopeKeyFromTags } from "../keys.mjs";
 import { ctx } from "./context.mjs";
-//#region src/cache/plugin/invalidation-hooks.ts
+// src/cache/plugin/invalidation-hooks.ts
 /**
 * Write-side hook registration: `after:<op>` for every mutating op
 * bumps the model's version (per-scope when possible) and invalidates
@@ -31,5 +31,4 @@ function registerInvalidationHooks(repo, op, engine, hookCtx) {
 		hookCtx.log.onInvalidate?.(model, version, count);
 	}, { priority: HOOK_PRIORITY.CACHE });
 }
-//#endregion
 export { registerInvalidationHooks };

package/dist/cache/plugin/read-hooks.mjs

@@ -3,7 +3,7 @@ import { buildCacheKey, extractScopeTags, mergeTags, scopeKeyFromTags } from "..
 import { ctx, extractCallCacheOptions, extractShapeFields } from "./context.mjs";
 import { resolveCacheOptions } from "../options.mjs";
 import { scheduleSwrRefresh } from "./swr.mjs";
-//#region src/cache/plugin/read-hooks.ts
+// src/cache/plugin/read-hooks.ts
 /**
 * Read-side hook registration: `before:<op>` (cache check + single-
 * flight claim), `after:<op>` (cache write + resolve waiters), and
@@ -93,5 +93,4 @@ async function deriveKey(engine, op, context, scopeTags, hookCtx) {
 		scopeTags
 	});
 }
-//#endregion
 export { registerReadHooks };

package/dist/cache/plugin/swr.mjs

@@ -1,6 +1,6 @@
 import { AGGREGATE_OPS } from "./context.mjs";
 import { scheduleBackground } from "../runtime.mjs";
-//#region src/cache/plugin/swr.ts
+// src/cache/plugin/swr.ts
 function scheduleSwrRefresh(op, repo, context) {
 	if (!AGGREGATE_OPS.has(op)) return;
 	const aggReq = context["aggRequest"];
@@ -16,5 +16,4 @@ function scheduleSwrRefresh(op, repo, context) {
 		repo[op]?.(refreshReq).catch(() => {});
 	});
 }
-//#endregion
 export { scheduleSwrRefresh };

package/dist/cache/runtime.d.mts

@@ -1,4 +1,3 @@
-//#region src/cache/runtime.d.ts
 /**
  * Cross-runtime scheduling primitives.
  *
@@ -39,5 +38,4 @@
  * error handling — this helper does NOT add a default `.catch`.
  */
 declare const scheduleBackground: (fn: () => void) => void;
-//#endregion
 export { scheduleBackground };

package/dist/cache/runtime.mjs

@@ -10,5 +10,4 @@ const scheduleBackground = typeof globalThis.setImmediate === "function" ? (fn)
 } : (fn) => {
 	setTimeout(fn, 0);
 };
-//#endregion
 export { scheduleBackground };

package/dist/cache/stable-stringify.d.mts

@@ -1,4 +1,3 @@
-//#region src/cache/stable-stringify.d.ts
 /**
  * Deterministic JSON stringify — equivalent values produce identical output, different values
  * never do. Every cache key and `contentHash` is built on it.
@@ -10,5 +9,4 @@
  * locale: a key that moves with the server's ICU data changes every digest. Arrays keep order.
  */
 declare function stableStringify(value: unknown): string;
-//#endregion
 export { stableStringify };

package/dist/cache/stable-stringify.mjs

@@ -1,4 +1,4 @@
-//#region src/cache/stable-stringify.ts
+// src/cache/stable-stringify.ts
 /**
 * Deterministic JSON stringify — equivalent values produce identical output, different values
 * never do. Every cache key and `contentHash` is built on it.
@@ -18,5 +18,4 @@ function stableStringify(value) {
 	const record = value;
 	return `{${Object.keys(record).filter((k) => record[k] !== void 0).sort((a, b) => a < b ? -1 : a > b ? 1 : 0).map((k) => `${JSON.stringify(k)}:${stableStringify(record[k])}`).join(",")}}`;
 }
-//#endregion
 export { stableStringify };

package/dist/cache/tag-index.mjs

@@ -1,5 +1,5 @@
 import { tagIndexKey } from "./keys.mjs";
-//#region src/cache/tag-index.ts
+// src/cache/tag-index.ts
 /**
 * Tag side-index — non-pattern-dependent tag invalidation.
 *
@@ -79,5 +79,4 @@ async function invalidateByTags(adapter, prefix, tags) {
 	await Promise.all(deletions);
 	return cacheKeys.size;
 }
-//#endregion
 export { appendKeyToTags, invalidateByTags };

package/dist/cache/timeout-adapter.d.mts

@@ -1,5 +1,4 @@
 import { CacheAdapter } from "./types.mjs";
-//#region src/cache/timeout-adapter.d.ts
 declare class CacheTimeoutError extends Error {
   readonly op: string;
   readonly key?: string;
@@ -25,5 +24,4 @@ interface TimeoutAdapterOptions {
  * complete before the deadline pass through unchanged.
  */
 declare function withTimeout(adapter: CacheAdapter, options?: TimeoutAdapterOptions): CacheAdapter;
-//#endregion
 export { CacheTimeoutError, TimeoutAdapterOptions, withTimeout };

package/dist/cache/timeout-adapter.mjs

@@ -1,4 +1,4 @@
-//#region src/cache/timeout-adapter.ts
+// src/cache/timeout-adapter.ts
 var CacheTimeoutError = class extends Error {
 	op;
 	key;
@@ -54,5 +54,4 @@ function withTimeout(adapter, options = {}) {
 		} } : {}
 	};
 }
-//#endregion
 export { CacheTimeoutError, withTimeout };

package/dist/cache/types.d.mts

@@ -1,4 +1,3 @@
-//#region src/cache/types.d.ts
 /**
  * Portable cache adapter contract.
  *
@@ -101,5 +100,4 @@ interface CacheAdapter {
    */
   increment?(key: string, by?: number, ttlSeconds?: number): Promise<number> | number;
 }
-//#endregion
 export { CacheAdapter };

package/dist/cache/version-store.mjs

@@ -1,5 +1,5 @@
 import { versionKey } from "./keys.mjs";
-//#region src/cache/version-store.ts
+// src/cache/version-store.ts
 /**
 * Collection-version store — O(1) bulk invalidation by bumping a
 * counter that's embedded in every cache key.
@@ -53,5 +53,4 @@ async function bumpModelVersion(adapter, prefix, model, scopeKey) {
 	await adapter.set(key, next, VERSION_TTL_SECONDS);
 	return next;
 }
-//#endregion
 export { bumpModelVersion, getModelVersion };

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

@@ -1,9 +1,9 @@
 import { TenantPurgeOptions, TenantPurgeStrategy } from "../repository/types.mjs";
 import { CleanupStep, CleanupStepContext } from "./types.mjs";
-//#region src/cleanup/define-purge-step.d.ts
 /**
  * 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.
  */
@@ -15,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. */
@@ -72,5 +72,4 @@ declare const REPOSITORY_UNAVAILABLE = "CLEANUP_REPOSITORY_UNAVAILABLE";
  *     processed count alone is never proof (§9).
  */
 declare function definePurgeStep(repository: PurgeStepRepository | undefined, spec: PurgeStepSpec): CleanupStep;
-//#endregion
 export { PurgeStepRepository, PurgeStepSpec, REPOSITORY_UNAVAILABLE, SCOPE_REQUIRED, definePurgeStep };

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

@@ -1,4 +1,4 @@
-//#region src/cleanup/define-purge-step.ts
+// src/cleanup/define-purge-step.ts
 /** Prefix for the blocker raised when the run carries no scope value. */
 const SCOPE_REQUIRED = "CLEANUP_SCOPE_REQUIRED";
 /** Prefix for the blocker raised when the repository cannot be reached. */
@@ -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,
@@ -103,5 +103,4 @@ function definePurgeStep(repository, spec) {
 		}
 	};
 }
-//#endregion
 export { REPOSITORY_UNAVAILABLE, SCOPE_REQUIRED, definePurgeStep };

package/dist/cleanup/index.mjs

@@ -1,2 +1 @@
-import { REPOSITORY_UNAVAILABLE, SCOPE_REQUIRED, definePurgeStep } from "./define-purge-step.mjs";
-export { REPOSITORY_UNAVAILABLE, SCOPE_REQUIRED, definePurgeStep };
+export { REPOSITORY_UNAVAILABLE, SCOPE_REQUIRED, definePurgeStep } from "./define-purge-step.mjs";

package/dist/cleanup/types.d.mts

@@ -1,4 +1,3 @@
-//#region src/cleanup/types.d.ts
 /**
  * `@classytic/repo-core/cleanup` — the framework-free **cleanup provider step**
  * contract (data-cleanup / retention design §6.3, §6.6).
@@ -196,5 +195,4 @@ interface CleanupStep {
    */
   verify?(ctx: CleanupStepContext): Promise<readonly CleanupStepCheck[]>;
 }
-//#endregion
 export { CleanupStep, CleanupStepCheck, CleanupStepContext, CleanupStepDisposition, CleanupStepEstimate, CleanupStepExecuteContext, CleanupStepLogger, CleanupStepOutcome, CleanupStepProgress };

package/dist/context/types.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "../filter/types.mjs";
-//#region src/context/types.d.ts
 /** The canonical lifecycle-hook context. */
 interface RepositoryContext {
   /** Operation name (`'create'`, `'getAll'`, `'update'`, ...). */
@@ -19,5 +18,4 @@ interface RepositoryContext {
   /** Arbitrary plugin-owned fields (cache markers, soft-delete flags, ...). */
   [key: string]: unknown;
 }
-//#endregion
 export { RepositoryContext };

package/dist/errors/codes.d.mts

@@ -1,4 +1,3 @@
-//#region src/errors/codes.d.ts
 /**
  * The error-code vocabulary of the wire — every value a client may see in
  * `ErrorContract.code`, in one place.
@@ -122,5 +121,4 @@ declare const CURSOR_ERROR_CODES: {
 };
 type CursorErrorCode = (typeof CURSOR_ERROR_CODES)[keyof typeof CURSOR_ERROR_CODES];
 declare const DUPLICATE_KEY_DETAIL_CODE = "duplicate_key";
-//#endregion
 export { ARC_ERROR_CODES, ARC_REASON_CODES, ArcErrorCode, ArcReasonCode, CURSOR_ERROR_CODES, CursorErrorCode, DUPLICATE_KEY_DETAIL_CODE, ERROR_CODES, ErrorCode };

package/dist/errors/codes.mjs

@@ -1,4 +1,4 @@
-//#region src/errors/codes.ts
+// src/errors/codes.ts
 /**
 * The error-code vocabulary of the wire — every value a client may see in
 * `ErrorContract.code`, in one place.
@@ -118,5 +118,4 @@ const CURSOR_ERROR_CODES = {
 	SCOPE_MISMATCH: "repo.cursor.scope_mismatch"
 };
 const DUPLICATE_KEY_DETAIL_CODE = "duplicate_key";
-//#endregion
 export { ARC_ERROR_CODES, ARC_REASON_CODES, CURSOR_ERROR_CODES, DUPLICATE_KEY_DETAIL_CODE, ERROR_CODES };

package/dist/errors/conflict.d.mts

@@ -1,4 +1,3 @@
-//#region src/errors/conflict.d.ts
 /**
  * Concurrency-conflict taxonomy — driver-agnostic contract.
  *
@@ -80,5 +79,4 @@ declare class VersionConflictError extends Error {
  * graph, where `instanceof` silently fails across the boundary.
  */
 declare function isVersionConflictError(err: unknown): err is VersionConflictError;
-//#endregion
 export { IsTransientConflictFn, VersionConflictError, conservativeMongoIsTransientConflict, isVersionConflictError, neverTransient };

package/dist/errors/conflict.mjs

@@ -1,4 +1,4 @@
-//#region src/errors/conflict.ts
+// src/errors/conflict.ts
 /**
 * Safe default: nothing is transient until the kit says so. The opposite
 * default (retry everything) turns a deterministic failure into N delayed
@@ -59,5 +59,4 @@ var VersionConflictError = class extends Error {
 function isVersionConflictError(err) {
 	return err instanceof VersionConflictError || typeof err === "object" && err !== null && err.name === "VersionConflictError" && err.code === "version_conflict";
 }
-//#endregion
 export { VersionConflictError, conservativeMongoIsTransientConflict, isVersionConflictError, neverTransient };