@classytic/repo-core 0.18.0 → 0.20.0

package/CHANGELOG.md

@@ -4,6 +4,29 @@ 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.20.0] - 2026-08-04
+
+### Added
+
+- **`ResolveBetterAuthCollectionsOptions.exclude`** — canonical collection names
+  to omit from `resolveBetterAuthCollections()` output. Applied before
+  `modelOverrides` / `usePlural` so a caller names the canonical collection
+  (`'user'`) and never has to predict the final model name. Solves the collision
+  when a host registers stub models for BA collections it merely references and a
+  full `createBetterAuthOverlay` for the one it exposes CRUD on — both for the
+  same collection would cause mongoose to lock the schema on first `model()`,
+  silently dropping `additionalFields` and causing the overlay to refuse.
+
+## [0.19.0] - 2026-07-29
+
+### Added — `coerceFilterDates` + ISO date helpers (`./filter`)
+
+- **`coerceFilterDates(filter)`** — walks a record-shape filter (Mongo-dialect or bare bracket-op syntax) and coerces ISO-8601 strings on range operators (`gt`/`gte`/`lt`/`lte` and `$`-prefixed equivalents) to `Date`, recursing through `$and`/`$or`/`$nor`/`$not` logical wrappers. Returns a new object; the input is never mutated. Equality operators are deliberately excluded — a string that happens to look like a date is far more likely a string id than a date equality predicate. Fixes silent empty results on aggregation `$match` stages: MongoDB `$match` (unlike `find`) performs no schema casting, so a string compared to a Date column matches nothing.
+- **`tryCoerceIsoDate(value)`** — coerces one unknown value to a `Date` when it is an unambiguous ISO-8601 string; returns anything else untouched. Safe to apply unconditionally.
+- **`ISO_DATE_PATTERN`** — the single regex source of truth for tight ISO-8601 detection (date-only through millisecond precision + optional timezone). `query-parser/coerce.ts` now imports this instead of keeping a duplicate pattern — one definition means the URL boundary and the compile boundary can never disagree on what "looks like a date".
+
+All three are exported from `@classytic/repo-core/filter`. Purely additive.
+
 ## [0.18.0] - 2026-07-27
 
 ### Added — `definePurgeStep` builder (`./cleanup`) and `resolveTenantField` (`./tenant`)

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Classytic
+Copyright (c) 2026 Classytic LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -239,3 +239,10 @@ See [docs/data-lifecycle.md](./docs/data-lifecycle.md) for the billion-row runbo
 ## License
 
 MIT — see [LICENSE](./LICENSE).
+
+
+## Trademark
+
+The code is MIT-licensed. **"Classytic", "arc", and the logos are trademarks of
+Classytic LLC** and are **not** licensed under MIT — see [TRADEMARK.md](TRADEMARK.md).
+Forks must be renamed; the license covers the code, not the brand.

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

@@ -71,6 +71,18 @@ interface ResolveBetterAuthCollectionsOptions {
    * @default []
    */
   plugins?: BetterAuthPluginKey[];
+  /**
+   * CANONICAL collection names to omit from the result.
+   *
+   * The reason this exists: a host commonly needs stub models for the BA collections it merely
+   * REFERENCES and a full `createBetterAuthOverlay` for the one it exposes CRUD on. Registering both
+   * for the same collection collides — mongoose locks a schema on first `model()`, so the overlay's
+   * `additionalFields` would be silently dropped, and the overlay therefore refuses.
+   *
+   * Applied BEFORE `modelOverrides` / `usePlural`, so a caller names the canonical collection and
+   * never has to predict the final model name.
+   */
+  exclude?: string[];
   /**
    * Additional collection names beyond the built-in plugin set.
    *

package/dist/better-auth/index.mjs

@@ -52,7 +52,8 @@ function pluralizeBetterAuthCollection(name) {
 * collection names. `core` is always included.
 */
 function resolveBetterAuthCollections(options = {}) {
-	const { plugins = [], extraCollections = [], usePlural = false, modelOverrides = {} } = options;
+	const { plugins = [], extraCollections = [], usePlural = false, modelOverrides = {}, exclude = [] } = options;
+	const excluded = new Set(exclude);
 	const pluginSet = /* @__PURE__ */ new Set(["core", ...plugins]);
 	const collected = [];
 	for (const key of pluginSet) for (const name of BA_COLLECTIONS_BY_PLUGIN[key]) collected.push(name);
@@ -62,6 +63,12 @@ function resolveBetterAuthCollections(options = {}) {
 	for (const canonical of collected) {
 		if (seen.has(canonical)) continue;
 		seen.add(canonical);
+		/**
+		* Excluded HERE, while the CANONICAL name is still in hand — before `modelOverrides` /
+		* `usePlural` produce the final name. A caller excluding `'user'` should not have to predict
+		* whether that becomes `users` or something a `modelName` override renamed it to.
+		*/
+		if (excluded.has(canonical)) continue;
 		const finalName = modelOverrides[canonical] ?? (usePlural ? pluralizeBetterAuthCollection(canonical) : canonical);
 		unique.push(finalName);
 	}

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

@@ -0,0 +1,15 @@
+//#region src/cache/stable-stringify.d.ts
+/**
+ * Deterministic JSON stringify — equivalent values produce identical output.
+ *
+ * Used by kits that build cache keys from hook contexts so
+ * `{ b: 1, a: 2 }` and `{ a: 2, b: 1 }` hash to the same bucket. Arrays
+ * preserve order (order is part of array identity).
+ *
+ * Extracted from the mongokit / sqlitekit cache plugins into repo-core so
+ * every kit's cachePlugin uses the same keying rule — cross-kit caches
+ * remain bucket-compatible.
+ */
+declare function stableStringify(value: unknown): string;
+//#endregion
+export { stableStringify };

package/dist/filter/coerce-dates.d.mts

@@ -0,0 +1,87 @@
+//#region src/filter/coerce-dates.d.ts
+/**
+ * ISO-date coercion for record-shape filters — the canonical helper every
+ * kit shares.
+ *
+ * WHY THIS EXISTS. A URL carries strings (`?createdAt[gte]=2026-04-01`), but
+ * the stored column is a real date. On a `find`-family call Mongoose casts
+ * the query against the schema, so a string silently becomes a `Date` and
+ * everything works. **An aggregation `$match` stage gets no such casting** —
+ * and BSON type ordering makes `Date` (type 9) and `String` (type 2)
+ * non-comparable, so `{ createdAt: { $gte: '2026-04-01' } }` matches
+ * NOTHING against a Date field. Silent empty result, no error. The same
+ * hazard exists for any kit comparing a typed column to a string literal.
+ *
+ * Coercion therefore has to happen in the shared layer, before a kit emits
+ * its native predicate — which is what this module is for. It is
+ * DIALECT-PRESERVING (record in, record out): it never converts to the
+ * Filter IR, so a caller that hands over Mongo-dialect syntax gets
+ * Mongo-dialect syntax back, just with dates typed correctly. That keeps it
+ * usable from `compileFilterToMongo`'s already-built-query passthrough
+ * branch, where converting to IR would lose operators the IR doesn't model.
+ *
+ * Two shapes are handled, because both reach the compile boundary:
+ *   - **bare shorthand** — `{ gte: '…' }`, what Fastify parses out of arc's
+ *     bracket-syntax URL params, and
+ *   - **`$`-prefixed** — `{ $gte: '…' }`, already-built Mongo/policy syntax.
+ *
+ * Logical wrappers (`$and` / `$or` / `$nor` / `$not`) are recursed — the
+ * same operator set {@link policyRecordToFilter} walks, kept deliberately in
+ * sync. Without recursion a date range nested under `$and` (exactly what a
+ * tenant/policy-scope merge produces when it conjoins a policy filter with a
+ * caller filter) is never coerced.
+ */
+/**
+ * Tight ISO-8601 pattern — date-only through millisecond precision with an
+ * optional timezone. Anchored at BOTH ends on purpose: a loose prefix-only
+ * match (`/^\d{4}-\d{2}-\d{2}/`) also swallows strings that merely START
+ * with something date-shaped (order numbers, slugs, serials), silently
+ * rewriting a legitimate string predicate into a Date one.
+ *
+ * THE single source of truth — `query-parser/coerce.ts` imports it rather
+ * than keeping a second copy.
+ */
+declare const ISO_DATE_PATTERN: RegExp;
+/**
+ * Coerce one value to a `Date` when it is an unambiguous ISO-8601 string.
+ * Anything else — including an unparseable date-shaped string — is returned
+ * untouched, so this is always safe to apply.
+ */
+declare function tryCoerceIsoDate(value: unknown): unknown;
+/**
+ * Walk a record-shape filter and coerce ISO-date strings on range operators
+ * to `Date`, recursing through logical wrappers. Returns a new object;
+ * the input is never mutated. Non-range operators, real nested documents,
+ * and already-typed values pass through unchanged.
+ *
+ * @example
+ * ```ts
+ * coerceFilterDates({ $and: [{ createdAt: { $gte: '2026-04-01' } }] })
+ * // → { $and: [{ createdAt: { $gte: Date(2026-04-01) } }] }
+ * ```
+ */
+interface CoerceFilterDatesOptions {
+  /**
+   * Schema oracle: given a field path, is it actually date-typed?
+   *
+   * WITHOUT this the coercion is a guess based only on how the VALUE looks, and the guess
+   * is wrong for any string column whose contents happen to be ISO-shaped — a civil date
+   * (`'2026-08-02'`), a version, a period key. Coercing there produces the exact failure
+   * this function exists to prevent, in reverse: the bound becomes a Date, BSON will not
+   * compare Date to String, and the range silently matches NOTHING.
+   *
+   * That cost real time. A sales-fact reconciler filtered `civilDate` — a `String` field
+   * holding `'YYYY-MM-DD'` — with `$gte`/`$lte`. The bounds were coerced to Dates, the
+   * aggregate returned zero rows for every window, and the report therefore accused the
+   * PROJECTOR of having written nothing, for every cell, forever. The projection was
+   * correct the whole time; the reconciler was comparing a Date to a String.
+   *
+   * Return `false` to leave the operand exactly as given. Omit the option entirely to keep
+   * the old value-shape-only behaviour (correct for callers with no schema to consult,
+   * such as a URL query parser).
+   */
+  isDateField?: (field: string) => boolean;
+}
+declare function coerceFilterDates(filter: Record<string, unknown>, options?: CoerceFilterDatesOptions): Record<string, unknown>;
+//#endregion
+export { CoerceFilterDatesOptions, ISO_DATE_PATTERN, coerceFilterDates, tryCoerceIsoDate };

package/dist/filter/coerce-dates.mjs

@@ -0,0 +1,114 @@
+//#region src/filter/coerce-dates.ts
+/**
+* ISO-date coercion for record-shape filters — the canonical helper every
+* kit shares.
+*
+* WHY THIS EXISTS. A URL carries strings (`?createdAt[gte]=2026-04-01`), but
+* the stored column is a real date. On a `find`-family call Mongoose casts
+* the query against the schema, so a string silently becomes a `Date` and
+* everything works. **An aggregation `$match` stage gets no such casting** —
+* and BSON type ordering makes `Date` (type 9) and `String` (type 2)
+* non-comparable, so `{ createdAt: { $gte: '2026-04-01' } }` matches
+* NOTHING against a Date field. Silent empty result, no error. The same
+* hazard exists for any kit comparing a typed column to a string literal.
+*
+* Coercion therefore has to happen in the shared layer, before a kit emits
+* its native predicate — which is what this module is for. It is
+* DIALECT-PRESERVING (record in, record out): it never converts to the
+* Filter IR, so a caller that hands over Mongo-dialect syntax gets
+* Mongo-dialect syntax back, just with dates typed correctly. That keeps it
+* usable from `compileFilterToMongo`'s already-built-query passthrough
+* branch, where converting to IR would lose operators the IR doesn't model.
+*
+* Two shapes are handled, because both reach the compile boundary:
+*   - **bare shorthand** — `{ gte: '…' }`, what Fastify parses out of arc's
+*     bracket-syntax URL params, and
+*   - **`$`-prefixed** — `{ $gte: '…' }`, already-built Mongo/policy syntax.
+*
+* Logical wrappers (`$and` / `$or` / `$nor` / `$not`) are recursed — the
+* same operator set {@link policyRecordToFilter} walks, kept deliberately in
+* sync. Without recursion a date range nested under `$and` (exactly what a
+* tenant/policy-scope merge produces when it conjoins a policy filter with a
+* caller filter) is never coerced.
+*/
+/**
+* Tight ISO-8601 pattern — date-only through millisecond precision with an
+* optional timezone. Anchored at BOTH ends on purpose: a loose prefix-only
+* match (`/^\d{4}-\d{2}-\d{2}/`) also swallows strings that merely START
+* with something date-shaped (order numbers, slugs, serials), silently
+* rewriting a legitimate string predicate into a Date one.
+*
+* THE single source of truth — `query-parser/coerce.ts` imports it rather
+* than keeping a second copy.
+*/
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+/**
+* Coerce one value to a `Date` when it is an unambiguous ISO-8601 string.
+* Anything else — including an unparseable date-shaped string — is returned
+* untouched, so this is always safe to apply.
+*/
+function tryCoerceIsoDate(value) {
+	if (typeof value !== "string" || !ISO_DATE_PATTERN.test(value)) return value;
+	const parsed = new Date(value);
+	return Number.isNaN(parsed.getTime()) ? value : parsed;
+}
+/**
+* Range operators whose operand is compared by BSON/SQL type and therefore
+* must be a real date, not a string. Equality is deliberately EXCLUDED:
+* `{ status: '2026-01-01' }` is far more likely a string id than a date, and
+* an `eq` against a Date column is the one case a caller can express exactly
+* by passing a `Date`. Both bare and `$`-prefixed spellings are listed.
+*/
+const RANGE_OPS = /* @__PURE__ */ new Set([
+	"gt",
+	"gte",
+	"lt",
+	"lte",
+	"$gt",
+	"$gte",
+	"$lt",
+	"$lte"
+]);
+/** Logical operators whose operand is an ARRAY of sub-filters. */
+const LOGICAL_ARRAY_OPS = /* @__PURE__ */ new Set([
+	"$and",
+	"$or",
+	"$nor",
+	"and",
+	"or",
+	"nor"
+]);
+/** Logical operators whose operand is a SINGLE nested sub-filter. */
+const LOGICAL_OBJECT_OPS = /* @__PURE__ */ new Set(["$not", "not"]);
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
+}
+function coerceFilterDates(filter, options) {
+	const out = {};
+	for (const [key, value] of Object.entries(filter)) {
+		if (LOGICAL_ARRAY_OPS.has(key) && Array.isArray(value)) {
+			out[key] = value.map((entry) => isPlainObject(entry) ? coerceFilterDates(entry, options) : entry);
+			continue;
+		}
+		if (LOGICAL_OBJECT_OPS.has(key) && isPlainObject(value)) {
+			out[key] = coerceFilterDates(value, options);
+			continue;
+		}
+		if (isPlainObject(value)) {
+			let changed = false;
+			const coerced = {};
+			const coercible = options?.isDateField === void 0 || options.isDateField(key);
+			for (const [op, operand] of Object.entries(value)) if (coercible && RANGE_OPS.has(op)) {
+				const next = tryCoerceIsoDate(operand);
+				coerced[op] = next;
+				if (next !== operand) changed = true;
+			} else coerced[op] = operand;
+			out[key] = changed ? coerced : value;
+			continue;
+		}
+		out[key] = value;
+	}
+	return out;
+}
+//#endregion
+export { ISO_DATE_PATTERN, coerceFilterDates, tryCoerceIsoDate };

package/dist/filter/index.d.mts

@@ -1,9 +1,10 @@
 import { Filter, FilterAnd, FilterEq, FilterExists, FilterFalse, FilterGt, FilterGte, FilterIn, FilterLike, FilterLt, FilterLte, FilterNe, FilterNin, FilterNot, FilterOp, FilterOr, FilterRaw, FilterRegex, FilterTrue } from "./types.mjs";
 import { FALSE, TRUE, and, anyOf as in_, between, contains, endsWith, eq, exists, gt, gte, iEq, invert as not, isNotNull, isNull, like, lt, lte, ne, nin, or, raw, regex, startsWith } from "./builders.mjs";
+import { ISO_DATE_PATTERN, coerceFilterDates, tryCoerceIsoDate } from "./coerce-dates.mjs";
 import { recordToFilter } from "./from-record.mjs";
 import { isFilter } from "./guard.mjs";
 import { asPredicate, matchFilter } from "./match.mjs";
 import { matchesRecordFilter, policyRecordToFilter } from "./match-record.mjs";
 import { SCOPE_ANY, buildTenantScope, mergeScope } from "./scope.mjs";
 import { collectFields, mapFilter, walkFilter } from "./walk.mjs";
-export { FALSE, type Filter, type FilterAnd, type FilterEq, type FilterExists, type FilterFalse, type FilterGt, type FilterGte, type FilterIn, type FilterLike, type FilterLt, type FilterLte, type FilterNe, type FilterNin, type FilterNot, type FilterOp, type FilterOr, type FilterRaw, type FilterRegex, type FilterTrue, SCOPE_ANY, TRUE, and, in_ as anyOf, asPredicate, between, buildTenantScope, collectFields, contains, endsWith, eq, exists, gt, gte, iEq, in_, not as invert, isFilter, isNotNull, isNull, like, lt, lte, mapFilter, matchFilter, matchesRecordFilter, mergeScope, ne, nin, nin as noneOf, not, or, policyRecordToFilter, raw, recordToFilter, regex, startsWith, walkFilter };
+export { FALSE, type Filter, type FilterAnd, type FilterEq, type FilterExists, type FilterFalse, type FilterGt, type FilterGte, type FilterIn, type FilterLike, type FilterLt, type FilterLte, type FilterNe, type FilterNin, type FilterNot, type FilterOp, type FilterOr, type FilterRaw, type FilterRegex, type FilterTrue, ISO_DATE_PATTERN, SCOPE_ANY, TRUE, and, in_ as anyOf, asPredicate, between, buildTenantScope, coerceFilterDates, collectFields, contains, endsWith, eq, exists, gt, gte, iEq, in_, not as invert, isFilter, isNotNull, isNull, like, lt, lte, mapFilter, matchFilter, matchesRecordFilter, mergeScope, ne, nin, nin as noneOf, not, or, policyRecordToFilter, raw, recordToFilter, regex, startsWith, tryCoerceIsoDate, walkFilter };

package/dist/filter/index.mjs

@@ -1,8 +1,9 @@
 import { isFilter } from "./guard.mjs";
 import { collectFields, mapFilter, walkFilter } from "./walk.mjs";
 import { FALSE, TRUE, and, anyOf as in_, between, contains, endsWith, eq, exists, gt, gte, iEq, invert as not, isNotNull, isNull, like, lt, lte, ne, nin, or, raw, regex, startsWith } from "./builders.mjs";
+import { ISO_DATE_PATTERN, coerceFilterDates, tryCoerceIsoDate } from "./coerce-dates.mjs";
 import { recordToFilter } from "./from-record.mjs";
 import { asPredicate, matchFilter } from "./match.mjs";
 import { matchesRecordFilter, policyRecordToFilter } from "./match-record.mjs";
 import { SCOPE_ANY, buildTenantScope, mergeScope } from "./scope.mjs";
-export { FALSE, SCOPE_ANY, TRUE, and, in_ as anyOf, asPredicate, between, buildTenantScope, collectFields, contains, endsWith, eq, exists, gt, gte, iEq, in_, not as invert, isFilter, isNotNull, isNull, like, lt, lte, mapFilter, matchFilter, matchesRecordFilter, mergeScope, ne, nin, nin as noneOf, not, or, policyRecordToFilter, raw, recordToFilter, regex, startsWith, walkFilter };
+export { FALSE, ISO_DATE_PATTERN, SCOPE_ANY, TRUE, and, in_ as anyOf, asPredicate, between, buildTenantScope, coerceFilterDates, collectFields, contains, endsWith, eq, exists, gt, gte, iEq, in_, not as invert, isFilter, isNotNull, isNull, like, lt, lte, mapFilter, matchFilter, matchesRecordFilter, mergeScope, ne, nin, nin as noneOf, not, or, policyRecordToFilter, raw, recordToFilter, regex, startsWith, tryCoerceIsoDate, walkFilter };

package/dist/hash/index.d.mts

@@ -0,0 +1,14 @@
+import { stableStringify } from "../cache/stable-stringify.mjs";
+//#region src/hash/index.d.ts
+/**
+ * SHA-256 hex digest of a value's canonical (key-order-independent) JSON form.
+ * Equivalent inputs → identical digest. `algorithm` may be any hash Node's
+ * `crypto` supports (default `'sha256'`); `encoding` the digest format
+ * (default `'hex'`).
+ */
+declare function contentHash(value: unknown, options?: {
+  algorithm?: string;
+  encoding?: 'hex' | 'base64' | 'base64url';
+}): string;
+//#endregion
+export { contentHash, stableStringify };

package/dist/hash/index.mjs

@@ -0,0 +1,31 @@
+import { stableStringify } from "../cache/stable-stringify.mjs";
+import { createHash } from "node:crypto";
+//#region src/hash/index.ts
+/**
+* Content-addressing — a stable cryptographic hash of any JSON-serializable value.
+*
+* `contentHash(value)` produces the SAME hex digest for structurally-equal values
+* regardless of object key order, so it's suitable for content-addressing:
+* reproducibility snapshots, idempotency keys, ETags, and dedupe. It builds on
+* {@link stableStringify} (canonical JSON) and SHA-256.
+*
+* This is DISTINCT from the cache module's `fnv1a64`: that is a fast,
+* collision-tolerant NON-cryptographic hash for cache-key bucketing. Use
+* `contentHash` when a collision would be a correctness or integrity problem
+* (e.g. "does this recomputation match the stored result?").
+*
+* `Date` values serialize via their ISO string (JSON.stringify default), so a
+* value carrying dates hashes stably across a JSON round-trip.
+*/
+/**
+* SHA-256 hex digest of a value's canonical (key-order-independent) JSON form.
+* Equivalent inputs → identical digest. `algorithm` may be any hash Node's
+* `crypto` supports (default `'sha256'`); `encoding` the digest format
+* (default `'hex'`).
+*/
+function contentHash(value, options = {}) {
+	const { algorithm = "sha256", encoding = "hex" } = options;
+	return createHash(algorithm).update(stableStringify(value)).digest(encoding);
+}
+//#endregion
+export { contentHash, stableStringify };

package/dist/query-parser/coerce.mjs

@@ -1,4 +1,11 @@
+import { ISO_DATE_PATTERN } from "../filter/coerce-dates.mjs";
 //#region src/query-parser/coerce.ts
+/**
+* Scalar coercion. URLs are strings; filters compare against typed fields.
+* The parser uses `fieldTypes` hints when provided, otherwise a safe
+* heuristic that avoids the classic footguns (string SKUs becoming
+* numbers, numeric-looking strings becoming Dates).
+*/
 const BOOLEAN_STRINGS = /* @__PURE__ */ new Set([
 	"true",
 	"1",
@@ -11,7 +18,7 @@ const FALSEY_STRINGS = /* @__PURE__ */ new Set([
 	"no",
 	"off"
 ]);
-const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+const ISO_DATE_RE = ISO_DATE_PATTERN;
 /**
 * Coerce a single URL value to its field-declared type, or to a best-guess
 * scalar when no hint exists. Always returns `string`, `number`, `boolean`,

package/package.json

@@ -1,180 +1,184 @@
 {
-  "name": "@classytic/repo-core",
-  "version": "0.18.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,
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
-  "exports": {
-    "./hooks": {
-      "types": "./dist/hooks/index.d.mts",
-      "default": "./dist/hooks/index.mjs"
-    },
-    "./operations": {
-      "types": "./dist/operations/index.d.mts",
-      "default": "./dist/operations/index.mjs"
-    },
-    "./errors": {
-      "types": "./dist/errors/index.d.mts",
-      "default": "./dist/errors/index.mjs"
-    },
-    "./pagination": {
-      "types": "./dist/pagination/index.d.mts",
-      "default": "./dist/pagination/index.mjs"
-    },
-    "./repository": {
-      "types": "./dist/repository/index.d.mts",
-      "default": "./dist/repository/index.mjs"
-    },
-    "./filter": {
-      "types": "./dist/filter/index.d.mts",
-      "default": "./dist/filter/index.mjs"
-    },
-    "./update": {
-      "types": "./dist/update/index.d.mts",
-      "default": "./dist/update/index.mjs"
-    },
-    "./query-parser": {
-      "types": "./dist/query-parser/index.d.mts",
-      "default": "./dist/query-parser/index.mjs"
-    },
-    "./context": {
-      "types": "./dist/context/index.d.mts",
-      "default": "./dist/context/index.mjs"
-    },
-    "./cache": {
-      "types": "./dist/cache/index.d.mts",
-      "default": "./dist/cache/index.mjs"
-    },
-    "./events": {
-      "types": "./dist/events/index.d.mts",
-      "default": "./dist/events/index.mjs"
-    },
-    "./schema": {
-      "types": "./dist/schema/index.d.mts",
-      "default": "./dist/schema/index.mjs"
-    },
-    "./testing": {
-      "types": "./dist/testing/index.d.mts",
-      "default": "./dist/testing/index.mjs"
-    },
-    "./tenant": {
-      "types": "./dist/tenant/index.d.mts",
-      "default": "./dist/tenant/index.mjs"
-    },
-    "./lookup": {
-      "types": "./dist/lookup/index.d.mts",
-      "default": "./dist/lookup/index.mjs"
-    },
-    "./adapter": {
-      "types": "./dist/adapter/index.d.mts",
-      "default": "./dist/adapter/index.mjs"
-    },
-    "./better-auth": {
-      "types": "./dist/better-auth/index.d.mts",
-      "default": "./dist/better-auth/index.mjs"
-    },
-    "./aggregate": {
-      "types": "./dist/aggregate/index.d.mts",
-      "default": "./dist/aggregate/index.mjs"
-    },
-    "./plugins": {
-      "types": "./dist/plugins/index.d.mts",
-      "default": "./dist/plugins/index.mjs"
-    },
-    "./lock": {
-      "types": "./dist/lock/index.d.mts",
-      "default": "./dist/lock/index.mjs"
-    },
-    "./usage": {
-      "types": "./dist/usage/index.d.mts",
-      "default": "./dist/usage/index.mjs"
-    },
-    "./package.json": "./package.json",
-    "./sync": {
-      "types": "./dist/sync/index.d.mts",
-      "default": "./dist/sync/index.mjs"
-    },
-    "./cleanup": {
-      "types": "./dist/cleanup/index.d.mts",
-      "default": "./dist/cleanup/index.mjs"
-    }
-  },
-  "keywords": [
-    "repository",
-    "repository-pattern",
-    "data-access",
-    "hooks",
-    "filter-ir",
-    "pagination",
-    "cursor-pagination",
-    "keyset-pagination",
-    "plugin-based",
-    "driver-agnostic",
-    "typescript",
-    "esm"
-  ],
-  "author": "Classytic <classytic.dev@gmail.com> (https://github.com/classytic)",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/classytic/repo-core.git"
-  },
-  "bugs": {
-    "url": "https://github.com/classytic/repo-core/issues"
-  },
-  "homepage": "https://github.com/classytic/repo-core#readme",
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "test": "vitest run --project unit --project integration",
-    "test:unit": "vitest run --project unit",
-    "test:integration": "vitest run --project integration",
-    "test:e2e": "vitest run --project e2e",
-    "test:all": "vitest run",
-    "test:watch": "vitest --project unit --project integration",
-    "bench": "vitest bench --run --project bench",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
-    "lint": "biome check src tests",
-    "lint:fix": "biome check src tests --write",
-    "format": "biome format src tests --write",
-    "check": "biome ci src tests --diagnostic-level=error",
-    "knip": "knip",
-    "push": "classytic-push",
-    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test",
-    "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
-    "release": "npm run push -- main && npm run release:tag && npm publish",
-    "publish:dry": "npm publish --dry-run --access public",
-    "publish:npm": "npm publish --access public"
-  },
-  "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.2",
-    "@biomejs/biome": "^2.4.12",
-    "@classytic/dev-tools": "^0.2.0",
-    "@types/node": "^22.0.0",
-    "@vitest/coverage-v8": "^4.1.4",
-    "fast-check": "^4.7.0",
-    "knip": "^6.3.0",
-    "publint": "^0.3.18",
-    "tsdown": "^0.22.5",
-    "typescript": "^7.0.2",
-    "vitest": "^4.1.4"
-  },
-  "peerDependencies": {
-    "vitest": "^3.0.0 || ^4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "vitest": {
-      "optional": true
-    }
-  }
+	"name": "@classytic/repo-core",
+	"version": "0.20.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,
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE",
+		"CHANGELOG.md"
+	],
+	"engines": {
+		"node": ">=22"
+	},
+	"exports": {
+		"./hooks": {
+			"types": "./dist/hooks/index.d.mts",
+			"default": "./dist/hooks/index.mjs"
+		},
+		"./operations": {
+			"types": "./dist/operations/index.d.mts",
+			"default": "./dist/operations/index.mjs"
+		},
+		"./errors": {
+			"types": "./dist/errors/index.d.mts",
+			"default": "./dist/errors/index.mjs"
+		},
+		"./pagination": {
+			"types": "./dist/pagination/index.d.mts",
+			"default": "./dist/pagination/index.mjs"
+		},
+		"./repository": {
+			"types": "./dist/repository/index.d.mts",
+			"default": "./dist/repository/index.mjs"
+		},
+		"./filter": {
+			"types": "./dist/filter/index.d.mts",
+			"default": "./dist/filter/index.mjs"
+		},
+		"./update": {
+			"types": "./dist/update/index.d.mts",
+			"default": "./dist/update/index.mjs"
+		},
+		"./query-parser": {
+			"types": "./dist/query-parser/index.d.mts",
+			"default": "./dist/query-parser/index.mjs"
+		},
+		"./context": {
+			"types": "./dist/context/index.d.mts",
+			"default": "./dist/context/index.mjs"
+		},
+		"./cache": {
+			"types": "./dist/cache/index.d.mts",
+			"default": "./dist/cache/index.mjs"
+		},
+		"./hash": {
+			"types": "./dist/hash/index.d.mts",
+			"default": "./dist/hash/index.mjs"
+		},
+		"./events": {
+			"types": "./dist/events/index.d.mts",
+			"default": "./dist/events/index.mjs"
+		},
+		"./schema": {
+			"types": "./dist/schema/index.d.mts",
+			"default": "./dist/schema/index.mjs"
+		},
+		"./testing": {
+			"types": "./dist/testing/index.d.mts",
+			"default": "./dist/testing/index.mjs"
+		},
+		"./tenant": {
+			"types": "./dist/tenant/index.d.mts",
+			"default": "./dist/tenant/index.mjs"
+		},
+		"./lookup": {
+			"types": "./dist/lookup/index.d.mts",
+			"default": "./dist/lookup/index.mjs"
+		},
+		"./adapter": {
+			"types": "./dist/adapter/index.d.mts",
+			"default": "./dist/adapter/index.mjs"
+		},
+		"./better-auth": {
+			"types": "./dist/better-auth/index.d.mts",
+			"default": "./dist/better-auth/index.mjs"
+		},
+		"./aggregate": {
+			"types": "./dist/aggregate/index.d.mts",
+			"default": "./dist/aggregate/index.mjs"
+		},
+		"./plugins": {
+			"types": "./dist/plugins/index.d.mts",
+			"default": "./dist/plugins/index.mjs"
+		},
+		"./lock": {
+			"types": "./dist/lock/index.d.mts",
+			"default": "./dist/lock/index.mjs"
+		},
+		"./usage": {
+			"types": "./dist/usage/index.d.mts",
+			"default": "./dist/usage/index.mjs"
+		},
+		"./package.json": "./package.json",
+		"./sync": {
+			"types": "./dist/sync/index.d.mts",
+			"default": "./dist/sync/index.mjs"
+		},
+		"./cleanup": {
+			"types": "./dist/cleanup/index.d.mts",
+			"default": "./dist/cleanup/index.mjs"
+		}
+	},
+	"keywords": [
+		"repository",
+		"repository-pattern",
+		"data-access",
+		"hooks",
+		"filter-ir",
+		"pagination",
+		"cursor-pagination",
+		"keyset-pagination",
+		"plugin-based",
+		"driver-agnostic",
+		"typescript",
+		"esm"
+	],
+	"author": "Classytic <classytic.dev@gmail.com> (https://github.com/classytic)",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/classytic/repo-core.git"
+	},
+	"bugs": {
+		"url": "https://github.com/classytic/repo-core/issues"
+	},
+	"homepage": "https://github.com/classytic/repo-core#readme",
+	"scripts": {
+		"build": "tsdown",
+		"dev": "tsdown --watch",
+		"test": "vitest run --project unit --project integration",
+		"test:unit": "vitest run --project unit",
+		"test:integration": "vitest run --project integration",
+		"test:e2e": "vitest run --project e2e",
+		"test:all": "vitest run",
+		"test:watch": "vitest --project unit --project integration",
+		"bench": "vitest bench --run --project bench",
+		"test:coverage": "vitest run --coverage",
+		"typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+		"lint": "biome check src tests",
+		"lint:fix": "biome check src tests --write",
+		"format": "biome format src tests --write",
+		"check": "biome ci src tests --diagnostic-level=error",
+		"knip": "knip",
+		"push": "classytic-push",
+		"prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test",
+		"release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
+		"release": "npm run push -- main && npm run release:tag && npm publish",
+		"publish:dry": "npm publish --dry-run --access public",
+		"publish:npm": "npm publish --access public"
+	},
+	"devDependencies": {
+		"@arethetypeswrong/cli": "^0.18.2",
+		"@biomejs/biome": "^2.4.12",
+		"@classytic/dev-tools": "^0.2.0",
+		"@types/node": "^22.0.0",
+		"@vitest/coverage-v8": "^4.1.4",
+		"fast-check": "^4.7.0",
+		"knip": "^6.3.0",
+		"publint": "^0.3.18",
+		"tsdown": "^0.22.5",
+		"typescript": "^7.0.2",
+		"vitest": "^4.1.4"
+	},
+	"peerDependencies": {
+		"vitest": "^3.0.0 || ^4.0.0"
+	},
+	"peerDependenciesMeta": {
+		"vitest": {
+			"optional": true
+		}
+	}
 }